Configuring SailPoint for Atlassian Cloud Jira Service Management

In SailPoint, configure the following items for your Atlassian Cloud Jira Service Management Integration Module:

• Ticket Creation
  • Create Ticket Advanced Properties
• Status Mapping
  • Status Mapping Advanced Properties
• Requester Source

On the Summary panel you can review the general settings and parameters for the connectivity and authentication.

Ticket Creation

In a centralized approach spanning many users and resources to strengthen IT controls and provide proof of compliance to auditors and executive management, you can create a ticket for your integration, based on your requirement. A ticket has all relevant data filed for further processing.

The contents of a service request or incident define the components of the provisioning task that are added to the Atlassian Cloud Jira Service Management system ticket. SailPoint recommends that you include the Apache Velocity variables as needed to meet your specific use cases.

1. Enter the Raise On Behalf of for the ticket you are creating. The default value is:

   $!{plan.arguments.opened_by|'Default_Jira_Account_ID'}
   

   To modify Default_Jira_Account_ID do one of the following:

   • Replace the Default_Jira_Account_ID with the service account name for the Jira user from the Requester Source.
   • Replace the Default_Jira_Account_ID with a Jira user's account name that you want to use as the reporter's name for the ticket generated by this integration.

2. Enter the Service Desk Id in the Atlassian Cloud Jira Service Management system. To obtain the Service Desk Id, execute the following request from POSTMAN with valid credentials.For example, https://demo.atlassian.net/rest/servicedeskapi/servicedesk.

3. Enter the Request Type Id. For example, ServiceRequest:10002 and Incident:10004

   Ensure that the Request Type Id belongs to the same project that is used. To obtain the Request Type Id, execute the following request from POSTMAN with valid credentials: https://demo.atlassian.net/rest/servicedeskapi/servicedesk/{serviceDeskId}/requesttype

4. Complete the following in the Request Field Values:

   1. In Description, enter the main body of the request in the Atlassian Cloud Jira Service Management system that includes the details about the request.
   2. In Summary, enter the title or summary of the request in the Atlassian Cloud Jira Service Management system.

Add a Field

To add a field in ticket creation, select Add Field and enter the relevant details for the new field. The field types are:

• Single Value
• Multi Valued
• Grouped Key-Value Pair

For example, if you want to add a Single Value custom attribute such as custom_attr in the request to the Atlassian Cloud Jira Service Management system, add the custom_attr field using the Single Value type. The corresponding value can be either static or dynamic. For the dynamic value, use the Velocity Template Expression.

Create Ticket Advanced Properties

Select View Advanced Properties to add other details of the ticket.

1. Enter the Resource used for the request ticket. This is the ticket creation REST endpoint. Do not provide the base URL in the value. The base URL is appended to this endpoint value. Enter only the remaining endpoint URL. For example, /rest/servicedeskapi/request.
2. Enter the Response Element for the request ticket. This value is the JSON path expression that provides information about where to find a ticket number. For example, issueKey.
3. Select Save.

Status Mapping

You can map the service request status to the corresponding status of the activity on the Atlassian Cloud Jira Service Management system.

1. Select Add Status to add another row for status mapping.
2. Enter an Identity Security Cloud Status. The types are:
   • Committed
   • Queued
   • Failed

3. Enter the Atlassian Cloud Jira Service Management SDIM Status, the types are dependent upon the request type.

   1. Service Request
   2. Incident

Status Options for Service Request

Status Options for Incident

Check Status Interval

You can add and delete a status as per your organizational needs. The Atlassian Cloud Jira Service Management Integration Module checks the status on tickets at regular intervals. The status must have at least one committed value. For more information on status check configuration, refer to the SailPoint Developer Portal:

• Getting the time check configuration of queued tickets
• Updating the time check configuration of queued tickets

Status Mapping Advanced Properties

Select View Advanced Properties to add other details of the status mapping.

1. Enter the Resource used for the status mapping. For example, /rest/servicedeskapi/request/$ticketId.
2. Enter the Response Element for the status mapping. This value is the JSON path expression that has information on the service request status. For example, $.currentStatus.status.
3. Select Save.

Requester Source

1. In the Requester Source field, enter the source name through which the Atlassian Cloud Jira Service Management system's users are aggregated.
2. Select Save.

Documentation Feedback

Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.