Publisher: Phantom
Connector Version: 1.0.9
Product Vendor: Cisco
Product Name: Cisco Spark
Product Version Supported (regex): ".*"
Minimum Product Version: 3.0.284
Integrate with Cisco Spark to implement investigative actions
The below configuration variables are required for this Connector to operate. These variables are specified when configuring a Cisco Spark asset in SOAR.
| VARIABLE | REQUIRED | TYPE | DESCRIPTION |
|---|---|---|---|
| authorization_key | required | password | API Key |
test connectivity - Validate the asset configuration for connectivity using supplied configuration
list rooms - List Spark rooms
get user - Get user_ID from e-mail address
send message - Send Message to user or room
Validate the asset configuration for connectivity using supplied configuration
Type: test
Read only: True
No parameters are required for this action
No Output
List Spark rooms
Type: investigate
Read only: False
No parameters are required for this action
| DATA PATH | TYPE | CONTAINS |
|---|---|---|
| action_result.status | string | |
| action_result.data.*.created | string | |
| action_result.data.*.creatorId | string | creater id |
| action_result.data.*.id | string | spark room id |
| action_result.data.*.isLocked | boolean | |
| action_result.data.*.lastActivity | string | |
| action_result.data.*.title | string | |
| action_result.data.*.type | string | |
| action_result.summary | string | |
| action_result.message | string | |
| summary.total_objects | numeric | |
| summary.total_objects_successful | numeric |
Get user_ID from e-mail address
Type: investigate
Read only: False
| PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS |
|---|---|---|---|---|
| email_address | required | user spark e-mail address | string | email |
| DATA PATH | TYPE | CONTAINS |
|---|---|---|
| action_result.status | string | |
| action_result.parameter.email_address | string | email |
| action_result.data.*.*.displayName | string | |
| action_result.data.*.*.id | string | spark user id |
| action_result.data.*.created | string | |
| action_result.data.*.emails | string | email |
| action_result.data.*.lastActivity | string | |
| action_result.data.*.nickName | string | |
| action_result.data.*.orgId | string | |
| action_result.data.*.status | string | |
| action_result.data.*.type | string | |
| action_result.summary | string | |
| action_result.message | string | |
| summary.total_objects | numeric | |
| summary.total_objects_successful | numeric |
Send Message to user or room
Type: investigate
Read only: False
| PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS |
|---|---|---|---|---|
| endpoint_id | required | User or Room ID | string | spark user id spark room id |
| destination_type | required | Destination Type | string | |
| message | required | message | string |
| DATA PATH | TYPE | CONTAINS |
|---|---|---|
| action_result.status | string | |
| action_result.parameter.destination_type | string | |
| action_result.parameter.endpoint_id | string | |
| action_result.parameter.message | string | |
| action_result.data.*.created | string | |
| action_result.data.*.id | string | |
| action_result.data.*.personEmail | string | email |
| action_result.data.*.personId | string | |
| action_result.data.*.roomId | string | |
| action_result.data.*.roomType | string | |
| action_result.data.*.text | string | |
| action_result.data.*.toPersonId | string | |
| action_result.summary | string | |
| action_result.message | string | |
| summary.total_objects | numeric | |
| summary.total_objects_successful | numeric |