JIRA Integration

IRM can automatically create JIRA tickets when DSRs are submitted. Tickets can be initiated for requests or tasks. The information from the DSR is automatically pushed into the JIRA ticket. Attachments and comments can be carried over from the JIRA ticket into IRM requests and tasks. In addition, if JIRA is mapped to a Task, when the ticket goes to completed status, the Task can also go automatically to completed status.

Configuring and Enabling JIRA Integration

To integrate IRM with JIRA, follow the steps outlined below.

1. Select JIRA from the Integrations menu and enter your login details.
   
   

2. Click the Test Connection button to allow IRM to connect to JIRA to verify the credentials provided. If the connection is successful, the Next button is enabled.
   
   

3. From the Intake Form tab, under Mappings, select an Intake Form you wish to integrate JIRA with.
   
   

4. Click Add New Object to begin mapping JIRA attributes.
   
   

5. Under Migration Criteria, select if the tickets to be migrated are for Requests or Tasks.
   
   

6. Click Add Criteria to add a criteria to apply to the JIRA map. You can select multiple criteria as needed.
   
   

7. Click the dropdown list on a selected criteria to add criteria value(s).
   
   

8. Under Map Settings, select a JIRA Project from the dropdown list.
   
   

9. Set the JIRA Mapping to Required.
   
   

10. Select an Issue Type from the drop-down list.
    
    

11. Select the JIRA data to sync to IRM.
    
    

• • • Attachments - Select the checkbox to sync the attachments from JIRA tickets to IRM.
      
      
    • Comments - Select the checkbox to sync the comments on the JIRA tickets to IRM.
      
      
    • Status - Select the checkbox to allow IRM to sync the status of the JIRA tickets to IRM. When this is enabled, IRM closes the task once the JIRA ticket is closed.

12. Click the (Use webhook) link (1), then click Copy Webhook URL (2) to enable syncing JIRA data to IRM in map settings when adding or editing objects.
    
    

14. Map the JIRA attributes to the intake form fields. You can add additional attributes by clicking the Add Attribute button.
    
    
15. Click the Add button to complete the mapping of JIRA attributes to the intake form. 
    
    
16. Click the Enable Integration (1) button to complete the integration process.
    
    
    NOTE: Click the View Intake Form (2) to view the intake form where the integration is mapped. Click the Delete All Object (3) to remove all mapped attributes from the intake form.

Creating Webhook in JIRA

Use the webhook URL inside JIRA to send notifications to IRM when JIRA ticket details change. To manage your webhook, follow these steps:

1. Log in to https://nymity.atlassian.net/.
   
   

2. Click the Settings icon, then select System.
   
   

3. Under Advanced, select WebHooks.
   
   

4. Click Create a WebHook.
   
   

5. Fill the webhook form. Fields that are marked with asterisks are required fields.
   
   

• • • Name - Enter the name of the new webhook.
      
      
    • Status - Select whether to enable or disable the webhook.
      
      
    • URL - Enter the webhook URL copied from Step 12 of Configuring and Enabling JIRA Integration procedures.
      
      
    • Issue related events - Select the following checkboxes:
      
      • Issue: updated
      • Comment: created, updated
      • Attachment: created

6. Select the Request with empty body will be sent to the URL. Leave unchecked if you want to receive JSON checkbox (1) to exclude the body of the webhook. Then, click Create (2).
   
   
   The new webhook is added to the Webhooks column on the left. Click the summary to display the details of the webhook. You can edit, delete, and disable it via the details panel.
   
   NOTE: When you delete a webhook, the system removes it permanently from JIRA. You can disable the webhook instead.