Accenture MxDR
This connector integrates Accenture MxDR with Swimlane Turbine.
Prerequisites
This connector can be authenticated in two ways.
- Using a Base64 encoded PEM key file converted from a PKCS12 file.
- Using Base64 encoded PKCS12 key file and a password for the file, , generated by the MxDR Portal.
Capabilities
This connector provides the following capabilities:
- Create Ticket with Attachments
- Create Ticket
- Get Incident Categories
- Get Incident Severities
- Get Recent Alarm List
- Get Recent Incident List
- Incident Add Attachment
- List Ticket Categories
- List Ticket Statuses
- List Ticket Urgencies
- Query Incident
- Query Ticket
- Update Incident Workflow
- Update Ticket with Attachment
- Update Ticket
Notes
Documentation:
Additional Documentation
Configurations
PEM File Authentication
Authenticates using PEM Certificate
Configuration Parameters
Parameter | Description | Type | Required |
|---|---|---|---|
url | ο»Ώ | string | Required |
pem_b64 | PEM certificate in Base64 format. | string | Required |
PKCS12 File Authentication
Authenticates using PEM Certificate
Configuration Parameters
Parameter | Description | Type | Required |
|---|---|---|---|
url | ο»Ώ | string | Required |
pkcs12_b64 | PKCS12 certificate in Base64 format. | string | Required |
pkcs12_password | PKCS12 certificate password. | string | Required |
Actions
Create Ticket Request
Create a ticket given the provided parameters.
Endpoint
- URL: /SWS/tickets.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
RequestCreateDoc | object | Required | Parameter for Create Ticket Request |
RequestCreateDoc.ClientReference | string | Optional | Parameter for Create Ticket Request |
RequestCreateDoc.RequestCategory | string | Required | Parameter for Create Ticket Request |
RequestCreateDoc.UrgencyName | string | Required | Name of the resource |
RequestCreateDoc.Description | string | Optional | Parameter for Create Ticket Request |
RequestCreateDoc.RequestedByOrgName | string | Required | Name of the resource |
RequestCreateDoc.DeviceName | string | Optional | Name of the resource |
RequestCreateDoc.AssignedToOrgName | string | Required | Name of the resource |
RequestCreateDoc.ActivityLog | string | Optional | Parameter for Create Ticket Request |
Input Example
{"RequestCreateDoc":{"ClientReference":"string","RequestCategory":"string","UrgencyName":"Example Name","Description":"string","RequestedByOrgName":"Example Name","DeviceName":"Example Name","AssignedToOrgName":"Example Name","ActivityLog":"string"}}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Create Ticket Request With Attachment
Create a ticket given the provided parameters and attachments.
Endpoint
- URL: /SWS/tickets.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
RequestCreateDoc | object | Required | Parameter for Create Ticket Request With Attachment |
RequestCreateDoc.ClientReference | string | Optional | Parameter for Create Ticket Request With Attachment |
RequestCreateDoc.RequestCategory | string | Required | Parameter for Create Ticket Request With Attachment |
RequestCreateDoc.UrgencyName | string | Required | Name of the resource |
RequestCreateDoc.Description | string | Optional | Parameter for Create Ticket Request With Attachment |
RequestCreateDoc.RequestedByOrgName | string | Required | Name of the resource |
RequestCreateDoc.DeviceName | string | Optional | Name of the resource |
RequestCreateDoc.AssignedToOrgName | string | Required | Name of the resource |
RequestCreateDoc.ActivityLog | string | Optional | Parameter for Create Ticket Request With Attachment |
Attachments | array | Required | Parameter for Create Ticket Request With Attachment |
Attachments.Attachment | object | Optional | Parameter for Create Ticket Request With Attachment |
Attachments.Attachment.Name | string | Optional | Name of the resource |
Attachments.Attachment.content | string | Optional | Base64 encoded file content. |
AttachmentComments | string | Optional | Parameter for Create Ticket Request With Attachment |
Input Example
{"RequestCreateDoc":{"ClientReference":"string","RequestCategory":"string","UrgencyName":"Example Name","Description":"string","RequestedByOrgName":"Example Name","DeviceName":"Example Name","AssignedToOrgName":"Example Name","ActivityLog":"string"},"Attachments":[{"Attachment":{"Name":"Example Name","content":"string"}}],"AttachmentComments":"string"}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Get Incident Categories
Get list of valid incident categories.
Endpoint
- URL: /SWS/incidents.asmx?WSDL
- Method: GET
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Get Incident Severities
Get list of Incident Severities.
Endpoint
- URL: /SWS/incidents.asmx?WSDL
- Method: GET
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Get Recent Alarm List
Gets the list of recent alarms based on the passed in parameters.
Endpoint
- URL: /SWS/alarms.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
StartTimeStampGMT | string | Required | Parameter for Get Recent Alarm List |
EndTimeStampGMT | string | Optional | Parameter for Get Recent Alarm List |
AlarmStatuses | string | Optional | Comma seperated list of valid Statuses. |
DeviceNames | string | Optional | Name of the resource |
AssignedToOrganizations | string | Optional | Comma seperated list of valid Organizations. |
AlarmIDs | string | Optional | Comma seperated list of valid Alarm IDs. |
UrgencyFilters | string | Optional | Comma-delimited list of valid Alarms Urgency. |
Categories | string | Optional | Comma-delimited list of valid Alarms Categories. |
ClientReference | string | Optional | Comma-delimited list of client reference values; since some ClientReference values may have commas, the individual values are matched with a LIKE operator. |
MaxAlarms | string | Optional | The maximum number of alarms to return. |
Input Example
{"StartTimeStampGMT":"string","EndTimeStampGMT":"string","AlarmStatuses":"active","DeviceNames":"Example Name","AssignedToOrganizations":"string","AlarmIDs":"string","UrgencyFilters":"string","Categories":"string","ClientReference":"string","MaxAlarms":"string"}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Get Recent Incident List
This method returns a list of Incidents based on given search parameters, which have been modified between/after specified dates.
Endpoint
- URL: /SWS/incidents.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
Severity | string | Optional | Comma-delimited list of valid Security Incident severities set by clients. |
SourceOrganization | string | Optional | Comma-delimited list of valid Organizations. |
DestinationOrganization | string | Optional | Comma-delimited list of valid Organizations. |
MaxIncidents | string | Optional | The maximum number of incidents to return. |
SourceIP | string | Optional | Comma-delimited list of valid Source IP Addresses. |
Category | string | Optional | Comma-delimited list of valid Security Incident Categories. |
ExcludeCategory | string | Optional | Comma-delimited list of valid Security Incident Categories. |
StartTimeStampGMT | string | Required | Only return incidents created since the specified date. |
EndTimeStampGMT | string | Optional | Only return incidents created before the specified date. |
Input Example
{"Severity":"string","SourceOrganization":"string","DestinationOrganization":"string","MaxIncidents":"string","SourceIP":"string","Category":"string","ExcludeCategory":"string","StartTimeStampGMT":"string","EndTimeStampGMT":"string"}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"reason":"OK","response_headers":{},"json_body":{}}
Incident Add Attachment
Add Incident Attachment
Endpoint
- URL: /SWS/incidents.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
IncidentNumber | number | Required | Unique identifier |
AttachmentData | array | Required | Response data |
AttachmentData.Name | string | Optional | Response data |
AttachmentData.content | string | Optional | Base64 encoded file content. |
AttachmentComment | string | Optional | Parameter for Incident Add Attachment |
Input Example
{"IncidentNumber":123,"AttachmentData":[{"Name":"Example Name","content":"string"}],"AttachmentComment":"string"}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
List Ticket Categories
Gets a list of valid Ticket Categories.
Endpoint
- URL: /SWS/tickets.asmx?WSDL
- Method: GET
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
List Ticket Statuses
Gets a list of valid Ticket Statuses.
Endpoint
- URL: /SWS/tickets.asmx?WSDL
- Method: GET
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
List Ticket Urgencies
Gets a list of valid Ticket Urgencies.
Endpoint
- URL: /SWS/tickets.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
TicketID | string | Optional | Unique identifier |
ClientReference | string | Optional | Parameter for List Ticket Urgencies |
Input Example
{"TicketID":"string","ClientReference":"string"}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Query Incident
Retrieve an incident by Incident Number.
Endpoint
- URL: /SWS/incidents.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
IncidentNumber | number | Optional | Unique identifier |
MaxSignatures | string | Optional | Parameter for Query Incident |
Input Example
{"IncidentNumber":123,"MaxSignatures":"string"}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Query Ticket
Returns details of a given Ticket by Ticket ID or Client Reference. If both fields are specified, only the Ticket ID will be used.
Endpoint
- URL: /SWS/tickets.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
TicketID | string | Required | Unique identifier |
ClientReference | string | Optional | Parameter for Query Ticket |
Input Example
{"TicketID":"string","ClientReference":"string"}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Update Incident Workflow
Update an Incident workflow.
Endpoint
- URL: /SWS/incidents.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
IncidentNumber | number | Required | Unique identifier |
Status | string | Required | Status value |
Resolution | string | Required | Parameter for Update Incident Workflow |
Reference | string | Optional | Parameter for Update Incident Workflow |
Severity | string | Required | Parameter for Update Incident Workflow |
AssignedToOrganization | string | Optional | Parameter for Update Incident Workflow |
AssignedToPerson | string | Optional | Parameter for Update Incident Workflow |
Comments | string | Optional | Parameter for Update Incident Workflow |
isGroupUpdate | boolean | Optional | Date value |
Input Example
{"IncidentNumber":123,"Status":"active","Resolution":"string","Reference":"string","Severity":"string","AssignedToOrganization":"string","AssignedToPerson":"string","Comments":"string","isGroupUpdate":true}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Update Ticket
Update a ticket given the provided parameters.
Endpoint
- URL: /SWS/tickets.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
TicketUpdateDoc | object | Required | Parameter for Update Ticket |
TicketUpdateDoc.RequestCategory | string | Optional | Parameter for Update Ticket |
TicketUpdateDoc.UrgencyName | string | Optional | Name of the resource |
TicketUpdateDoc.Description | string | Optional | Parameter for Update Ticket |
TicketUpdateDoc.DeviceName | string | Optional | Name of the resource |
TicketUpdateDoc.ActivityLog | string | Optional | Parameter for Update Ticket |
RequestToClose | boolean | Optional | Parameter for Update Ticket |
Input Example
{"TicketUpdateDoc":{"RequestCategory":"string","UrgencyName":"Example Name","Description":"string","DeviceName":"Example Name","ActivityLog":"string"},"RequestToClose":true}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Update Ticket With Attachment
Update a ticket given the provided parameters (TicketUpdateDoc, RequestToClose, Attachments, AttachmentComments).Each Request Supports only 20 Attachment and Soap Message of size 100MB.
Endpoint
- URL: /SWS/tickets.asmx?WSDL
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
TicketUpdateDoc | object | Required | Parameter for Update Ticket With Attachment |
TicketUpdateDoc.RequestCategory | string | Optional | Parameter for Update Ticket With Attachment |
TicketUpdateDoc.UrgencyName | string | Optional | Name of the resource |
TicketUpdateDoc.Description | string | Optional | Parameter for Update Ticket With Attachment |
TicketUpdateDoc.DeviceName | string | Optional | Name of the resource |
TicketUpdateDoc.ActivityLog | string | Optional | Parameter for Update Ticket With Attachment |
RequestToClose | boolean | Optional | Parameter for Update Ticket With Attachment |
Attachments | array | Required | Parameter for Update Ticket With Attachment |
Attachments.Attachment | object | Optional | Parameter for Update Ticket With Attachment |
Attachments.Attachment.Name | string | Optional | Name of the resource |
Attachments.Attachment.content | string | Optional | Base64 encoded file content. |
AttachmentComments | string | Optional | Parameter for Update Ticket With Attachment |
Input Example
{"TicketUpdateDoc":{"RequestCategory":"string","UrgencyName":"Example Name","Description":"string","DeviceName":"Example Name","ActivityLog":"string"},"RequestToClose":true,"Attachments":[{"Attachment":{"Name":"Example Name","content":"string"}}],"AttachmentComments":"string"}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
reason | string | Response reason phrase |
Output Example
{"status_code":200,"response_headers":{"Cache-Control":"private, max-age=0","Content-Type":"text/xml; charset=utf-8","Content-Encoding":"gzip","Vary":"Accept-Encoding","Server":"Microsoft-IIS/10.0","X-AspNet-Version":"2.0.50727","X-Powered-By":"ASP.NET","X-Powered-By-Plesk":"PleskWin","Date":"Mon, 25 Sep 2023 19:13:34 GMT","Content-Length":"370","Cf-Team":"1b6f5bf266000079de27ebb400000001"},"reason":"OK","json_body":{}}
Response Headers
Header | Description | Example |
|---|---|---|
Cache-Control | Directives for caching mechanisms | private, max-age=0 |
Cf-Team | HTTP response header: Cf-Team | 1b6f5bf266000079de27ebb400000001 |
Content-Encoding | HTTP response header: Content-Encoding | gzip |
Content-Length | The length of the response body in bytes | 370 |
Content-Type | The media type of the resource | text/xml; charset=utf-8 |
Date | The date and time at which the message was originated | Mon, 25 Sep 2023 19:13:34 GMT |
Server | Information about the software used by the origin server | Microsoft-IIS/10.0 |
Vary | HTTP response header: Vary | Accept-Encoding |
X-AspNet-Version | HTTP response header: X-AspNet-Version | 2.0.50727 |
X-Powered-By | HTTP response header: X-Powered-By | ASP.NET |
X-Powered-By-Plesk | HTTP response header: X-Powered-By-Plesk | PleskWin |