Jira

Owned by Nathaniel Lichauco (Unlicensed)
Last updated: Dec 22, 2023 by Nitin Sonawane
4 min read

The Jira API integration collects account details for the following Atlassian Products

  • Jira Software and its derivatives (eg., Jira Service Management)

  • Confluence

  • Status Page

  • Ops Genie

 

Note: In order to successfully perform the Jira sync, you must be an Org Admin. If you are not an Org Admin and you wish to perform this sync, you must first request Org Admin access from your Administrator.

Also you should have Admin access to the Jira Administration Product.

Jira does not provide email addresses via their APIs. After your accounts are synced with ZIlla, you will need to use the Map to Directory feature to map the accounts to users.

Note: If you have already set up the Jira connector for Zilla and are looking to migrate to the new scopes, visit here: Jira - Migrate to new scopes for API Integration

Create a Jira Connector

  1. Navigate to https://developer.atlassian.com/console/myapps/

    • Click Create → OAuth 2.0 Integration

  2. Name the new connector (e.g. ZillaConnector), agree to terms, and click Create.

  3. On the side menu, click Permissions and add the following:

    1. Jira API - click Add and then Configure

       

    2. Under the Granular scopes click on Edit Scopes and select the following scopes and Save (you can use the filters provided here):

      • View users: read:user:jira

      • View application roles: read:application-role:jira

      • View avatars: read:avatar:jira

      • View groups: read:group:jira

      • Under the Classic scopes tab, click Edit scopes and search for read:jira-work.



  4. On the side menu, click Authorization → OAuth 2.0 (3LO) (click Configure)

  5. On the side menu, click on Settings and scroll down to view Client ID and Client Secret.

     

  6. Get the Site Url for the product with the data to be synced. Login to your Atlassian account and navigate to the Administration section from the top left corner matrix -> Select the organization for which you want to get the data > Copy the URL as mentioned in the Snapshot given below

  7. Copy these values in Zilla to configure JIRA.

    1. Jira Client ID: Copied from previous step.

    2. Jira Client Secret: Copied from previous step.

    3. Sync Jira projects as resource permissions? (Yes/No): Default is No, If you want to sync projects set it to Yes. This will require authorization for read:jira-work scope.

    4. Site Url (https://example.atlassian.net): Site URL or Cloud URL for which you are going to authorize Zilla to get the data. Copied from previous steps.

       

  8. Once you have configured Jira and sync the application for the first time, you will be required to grant access to Zilla. The page will look similar to the screenshot below:

     

  9. Sample screen shots from Zilla’s Account tab, Group details tab, Permissions tab and Resources tab.

 

 

To sync data we recommend using the API method. However, you may also sync data with our Browser Extension, follow instructions here: Jira - Browser Extension.