/
Jira

Jira

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

  • Jira Software and its derivatives (for example, Jira Service Management)

  • Confluence

  • Status Page

  • Ops Genie

If you have already set up the Jira integration with Zilla and want to migrate new scopes, see Jira - Migrate to new scopes for API Integration.

This article covers the following topics:

Prerequisites

  • Admin or application admin permissions in Zilla

  • Site admin permissions or permissions to Browse Users and Groups, Browse Projects (per project), and Browse Projects (per project) and View Project Roles in Jira

  • Admin access to the Jira Administration Product

Create a Jira Connector

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

    • Click Create → OAuth 2.0 Integration

  1. Name the new connector (for example, ZillaConnector), agree to the terms, and click Create.

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

    1. Jira API: Click Add and then click Configure.

       

    2. Under Granular scopes, click Edit Scopes, select the scopes listed below, and click Save.

      • View users: read:user:jira

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

      • View avatars: read:avatar:jira

      • View groups: read:group:jira

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

  1. On the side menu, click Authorization and then click Configure next to OAuth 2.0 (3LO).

  1. Enter in Callback URL https://app.zillasecurity.com/api/auth/callback/jira and click Save changes.

  1. On the side menu, click Settings, scroll down, and copy the Client ID and Client Secret.

  1. On a separate tab, get the Site URL for the product with the data to be synced. Log in to your Atlassian account and click to expand the navigation menu in the top left corner. \

  1. Click Administration from the navigation menu.

  1. Select the organization for which you want to get the data.

  1. Copy the Site URL.

  1. Add the Jira application in Zilla. For instructions on this process, refer to this article.

  2. Add the information below in the Integration Configuration fields in Zilla.

    1. Jira Client ID: Paste the Client ID copied in step 6.

    2. Jira Client Secret: Paste the Client Secret copied in step 6.

    3. Sync Jira projects as resource permissions? (Yes/No): The default value for this field is No. If you want to sync projects, set it to Yes (this requires authorization for read:jira-work scope).

    4. Site Url (https://example.atlassian.net): Paste the Site URL or Cloud URL that was copied in step 10. This is the site from which Zilla is authorized to get the data.

       

  3. Click Sync Now.

  4. Once you have configured Jira and synced the application for the first time, you are required to grant access to Zilla. The page looks similar to the screenshot below.

     

  5. Once the application has ben synced and Zilla has been grated access to Atlassian, review the Jira application details page to confirm the information brought into Zilla is correct.

Jira does not provide email addresses via their APIs. After your accounts are synced, use the Map to Directory feature in Zilla to map the accounts to users.

Additional Resources

To sync data we recommend using the API method. However, you can also see Jira - Browser Extension for steps on syncing data with our browser extension.