Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 20 Next »

Overview

This document provides instructions on how to connect to an API to import data from this application into your instance of Zilla.

In this guide, you will:

  1. Launch your application from inside Zilla

  2. Set up an API configuration

  3. Send your data securely to Zilla

Step-by-Step Instructions

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.

When you have finished with all the steps above, review the information in Zilla that was synced.

Having trouble? Try our Troubleshooting articles or contact support@zillasecurity.com.

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.

  • No labels