About the connector
BMC Remedy Action Request System (BMC Remedy AR System) enables you to automate a broad range of business solutions, from service desk call tracking to inventory management to integrated systems management.
This document provides information about the BMC Remedy AR System connector, which facilitates automated interactions with a ProtectWise server using FortiSOAR™ playbooks. Add the BMC Remedy AR System connector as a step in FortiSOAR™ playbooks and perform automated operations, such as creating or updating an incident ticket in the BMC Remedy AR System or setting the status of an incident ticket in the BMC Remedy AR System.
Version information
Connector Version: 1.0.1
FortiSOAR™ Versions Tested on: 4.11.0-1161
BMC Remedy AR System Version Tested on: 9.1.0.4
Authored By: Fortinet
Certified: Yes
Installing the connector
All connectors provided by FortiSOAR™ are delivered using a FortiSOAR™ repository. Therefore, you must set up your FortiSOAR™ repository and use the yum command to install connectors:
yum install cyops-connector-bmcremedy
For the detailed procedure to install a connector, click here.
Configuring the connector
For the procedure to configure a connector, click here.
Actions supported by the connector
The following automated operations can be included in playbooks, and you can also use the annotations to access operations from FortiSOAR™ release 4.10.0 onwards:
| Function |
Description |
Annotation and Category |
| Create Incident |
Creates an incident ticket in the BMC Remedy AR System based on the input parameters you have specified. |
create_incident
Investigation |
| Update Incident |
Updates an existing incident ticket that you specify using the Incident Request ID in the BMC Remedy AR System based on the input parameters you have specified. |
update_incident
Investigation |
| Retrieve Incident |
Retrieves the details of an existing incident ticket from the BMC Remedy AR System based on the Incident Request ID you have specified. |
get_incident
Investigation |
| Get List of Incidents |
Retrieves a list of all available incident tickets from the BMC Remedy AR System. |
get_incidents
Investigation |
| Set Incident Status |
Sets the status of a specific incident ticket in the BMC Remedy AR System based on the Incident ID you have specified. |
set_incident_status
Investigation |
operation: Create Incident
Input parameters
| Parameter |
Description |
| First Name |
First name of the user who has access to create an incident on the BMC Remedy AR System. |
| Last Name |
Last name of the user who has access to create an incident on the BMC Remedy AR System. |
| Description |
Description of the incident that you want to create on the BMC Remedy AR System. |
| Impact |
Impact of the incident that you want to create on the BMC Remedy AR System. Value of this field will be the one taken from BMC Remedy Impact field. |
| Urgency |
Urgency of the incident that you want to create on the BMC Remedy AR System. |
| Status |
Status of the incident that you want to create on the BMC Remedy AR System. |
| Reported Source |
Source from where the incident that you want to create on the BMC Remedy AR System was reported. |
| Service Type |
Type of service for the incident that you want to create on the BMC Remedy AR System was reported. |
Output
The JSON output contains the ID of the incident that is created on the BMC Remedy AR System.
Following image displays a sample output:
operation: Update Incident
Input parameters
Note:All fields apart from Incident Request ID are optional
| Parameter |
Description |
| Incident Request ID |
Request ID of the incident that you want to update on the BMC Remedy AR System.
You must enter a value in this field. For example, INC000000000245|INC000000000245 |
| First Name |
First name of the user who has access to update an incident on the BMC Remedy AR System. |
| Last Name |
Last name of the user who has access to update an incident on the BMC Remedy AR System. |
| Description |
Description of the incident that you want to update on the BMC Remedy AR System. |
| Impact |
Impact of the incident that you want to update on the BMC Remedy AR System. Value of this field will be the one taken from BMC Remedy Impact field. |
| Urgency |
Urgency of the incident that you want to update on the BMC Remedy AR System. |
| Status |
Status of the incident that you want to update on the BMC Remedy AR System. |
| Reported Source |
Source from where the incident that you want to update on the BMC Remedy AR System was reported. |
| Service Type |
Type of service for the incident that you want to update on the BMC Remedy AR System was reported. |
Output
The JSON output contains the status of the operation.
Following image displays a sample output:
operation: Retrieve Incident
Input parameters
| Parameter |
Description |
| Incident Number |
ID or number of the incident whose details you want to retrieve from the BMC Remedy AR System. |
Output
The JSON output details of an incident based on the Incident number you have specified retrieved from the BMC Remedy AR System.
Following image displays a sample output:
operation: Get List of Incidents
Input parameters
| Parameter |
Description |
| Limit |
(Optional) Maximum number of incidents that this operation should retrieve from the BMC Remedy AR System. |
| Offset |
(Optional) Index of the first item to return from the search result. |
Output
The JSON output a list of all available incident tickets retrieved from the BMC Remedy AR System.
Following image displays a sample output:
operation: Set Incident Status
Input parameters
| Parameter |
Description |
| Incident Request ID |
Request ID of the incident whose status you want to update on the BMC Remedy AR System. |
| Status |
Status that you want to set for the specified incident on the BMC Remedy AR System. |
Output
The JSON output contains the status of the operation.
Following image displays a sample output:
Included playbooks
The Sample - BMC Remedy AR System - 1.0.1 playbook collection comes bundled with the BMC Remedy AR System connector. This playbook contains steps using which you can perform all supported actions. You can see the bundled playbooks in the Automation > Playbooks section in FortiSOAR™ after importing the BMC Remedy AR System connector.
- Create Incident
- List All Incident
- Retrieve Incident Details
- Update an Incident
- Update status of an Incident
Note: If you are planning to use any of the sample playbooks in your environment, ensure that you clone those playbooks and move them to a different collection, since the sample playbook collection gets deleted during connector upgrade and delete.
