# Configuring SailPoint for Atlassian Data Center Jira Service Management

In SailPoint, configure the following items for your Atlassian Data Center 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 Data Center Jira Service Management Integration Module supports only Service Request, Incident, and Change Request.

The contents of a service request, incident, or change request define the components of the SailPoint provisioning task that are added to the Atlassian Data Center Jira Service Management system ticket. SailPoint recommends that you include the Apache Velocity variables as needed to meet your requirements.

> [!NOTE]
>
> **Screenshot**
>
> [![Ticket Creation](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_datacenter_sdim/help/img/ticket_creation.png>)](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_datacenter_sdim/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 Data Center Jira Service Management system. To obtain the Service Desk Id, execute the following request from POSTMAN with valid credentials. Use the ID from response and enter it into the Service Desk Id field. If Jira is installed to run in a non-root context path (i.e. it has a context path), the URL also must include this context path.

   For example, if Jira is running at `http://www.foobar.com/Jira` then the URL must be `GET http://www.foobar.com/Jira/rest/servicedeskapi/servicedesk`.
3. Enter the ID of each request type. For example, `ServiceRequest:1`, `Incident:14`, and `ChangeRequest:15`.

   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. For example, if Jira is running at `http://www.foobar.com/Jira` the URL must be `GET http://www.foobar.com/Jira/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 Data Center 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 Data Center 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 Data Center 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_datacenter_sdim/help/img/ticket_creation_advanced.png>)](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_datacenter_sdim/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 status of the service request to the corresponding status of activity on the Atlassian Data Center Jira Service Management system. Select **Add Status** to add another row for status mapping.

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

For SailPoint, the status types are:

- Committed
- Queued
- Failed

For the Atlassian Data Center Jira Service Management managed system, the types of status are dependent upon request type.

### Status Mapping for Service Request

| Entry Key on Atlassian Data Center Jira System | SailPoint Values |
| --- | --- |
| Canceled | Failed |
| Waiting for support | Queued |
| Waiting for customer | Queued |
| Escalated | Queued |
| In Progress | Queued |
| Pending | Queued |
| Closed | Committed |
| Resolved | Committed |

### Status Mapping for Incident

| Entry Key on Atlassian Data Center Jira System | SailPoint Values |
| --- | --- |
| Closed | Committed |
| Canceled | Failed |
| Work In Progress | Queued |
| Open | Queued |
| Pending | Queued |
| Completed | Committed |

### Status Mapping for Change Request

| Entry Key on Atlassian Data Center Jira System | SailPoint Values |
| --- | --- |
| Planning | Queued |
| Implementing | Queued |
| Canceled | Failed |
| Declined | Failed |
| Peer review/ change manager approval | Queued |
| Resolved | Committed |
| Closed | Committed |
| Pending | Queued |
| Awaiting CAB approval | Queued |
| Awaiting Implementation | Queued |

### Check Status Interval

You can add and delete a status as per your organizational needs. The Atlassian Data Center 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_datacenter_sdim/help/img/status_mapping_advanced.png>)](<https://documentation.sailpoint.com/connectors/service_desk_integrations/atlassian_datacenter_sdim/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**.

## Customize Ticket Fields

> [!IMPORTANT]
>
> Contact SailPoint Services for setting up a Before Provisioning rule for your integration.

You can customize the ticket fields based on your requirements. You can set up a Before Provisioning rule to generate ticket fields.

Create a new rule with a distinct name that is different from the default rule name (Sample Before Provisioning Rule for SDIM). You can set this new rule for the integration using API.

For more information, refer to [Service Desk Integration Update - PATCH API](<https://developer.sailpoint.com/docs/api/patch-service-desk-integration-v-1/>).

## Requester Source

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

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