# 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](<#ticket-creation>)

  - [Create Ticket Advanced Properties](<#create-ticket-advanced-properties>)
- [Status Mapping](<#status-mapping>)

  - [Status Mapping Advanced Properties](<#status-mapping-advanced-properties>)
- [Requester Source](<#requester-source>)

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

> [!NOTE]
>
> All activity on the Service Desk connector appears as [events in Search](<https://documentation.sailpoint.com/saas/help/search/overview-of-search.html#events>) and on the **Activity** tab of an identity.

## 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.

> [!NOTE]
>
> Atlassian Cloud Jira Service Management Integration Module supports only Service Request and Incident.

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.

> [!NOTE]
>
> **Screenshot**
>
> [![Ticket Creation](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_jira_cloud/help/img/ticket_creation.png>)](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_jira_cloud/help/img/ticket_creation.png>)

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

   ```text
   $!{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.

> [!NOTE]
>
> The ticket number generated on the Service Desk system for the corresponding provisioning action can be seen under **Search \> Account Activity** details of the identity. For more information, refer to [Account Activity Using Search](<https://documentation.sailpoint.com/saas/help/search/index.html#account-activity>).

## Create Ticket Advanced Properties

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

> [!NOTE]
>
> **Screenshot**
>
> [![Create Ticket Advanced Properties](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_jira_cloud/help/img/ticket_creation_advanced.png>)](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_jira_cloud/help/img/ticket_creation_advanced.png>)

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.

> [!NOTE]
>
> **Screenshot**
>
> [![Status Mapping](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_jira_cloud/help/img/status_mapping.png>)](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_jira_cloud/help/img/status_mapping.png>)

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](<#status-options-for-service-request>)
   2. [Incident](<#status-options-for-incident>)

### Status Options for Service Request

| Entry key (Atlassian Cloud Jira Service) | SailPoint Value |
| --- | --- |
| Completed | Committed |
| Canceled | Failed |
| Blocked | Queued |
| Waiting for support | Queued |
| Waiting for customer | Queued |
| Escalated | Queued |
| In Progress | Queued |
| Pending | Queued |
| Closed | Committed |
| Resolved | Committed |

### Status Options for Incident

| Entry key (Atlassian Cloud Jira Service) | SailPoint Values |
| --- | --- |
| Resolved | Committed |
| Closed | Committed |
| Canceled | Failed |
| Work In Progress | Queued |
| Open | Queued |
| Blocked | Queued |
| Pending | Queued |
| Completed | Committed |

### 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](<https://developer.sailpoint.com/docs/api/get-status-check-details-v-1/>)
- [Updating the time check configuration of queued tickets](<https://developer.sailpoint.com/docs/api/update-status-check-details-v-1/>)

### Status Mapping Advanced Properties

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

> [!NOTE]
>
> **Screenshot**
>
> [![Status Mapping Advanced Properties](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_jira_cloud/help/img/status_mapping_advanced.png>)](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_jira_cloud/help/img/status_mapping_advanced.png>)

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

> [!NOTE]
>
> **Screenshot**
>
> [![Requester Source](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_jira_cloud/help/img/requester_source.png>)](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_jira_cloud/help/img/requester_source.png>)

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**.