Overview

Many engineering teams use Jira to manage their projects. With Opal, you can sync your engineers' access requests with your Jira support tickets in order to grant access for the lifetime of the support ticket. When the ticket is closed (marked Done), access is also revoked.

Adding Jira to Opal

Jira Cloud

Step 1: Create a Jira API token

To enable our Jira integration, Opal requires the administrator of your Jira workspace to create a Jira API token, using this link. Click Create API token and record the generated token. This will be input in the next step.

Step 2: Add your Jira workspace name, project name, and API token to Opal

To enable the Jira integration, go to the Admin panel in Opal. Click on Jira and enter your Jira workspace name (e.g., if your Jira workspace is https://jiraworkspace.atlassian.net, input jiraworkspace). Then input the whole name of the Jira project you want to integrate with. Finally, enter the API token from the previous step. Once complete, you've successfully integrated Jira with Opal. You will be able to load and bind Jira tickets from the project name from the Jira workspace you specified.

Jira Data Center

Before you begin, note that Jira 8.14 or later is required.

Step 1: Create a Personal Access Token

To enable our Jira integration, Opal requires the administrator of your Jira workspace to create a Personal Access Token. Select your profile picture at the top right of the screen, then click Personal Access Tokens. Select Create token. Give your new token a name. Finally, click Create and record the generated token. This will be input in the next step.

Step 2: Add your Jira instance URL, project name and Personal Access Token to Opal

To enable the Jira integration, go to the Admin panel in Opal. Click on Jira, then click self-hosted. Then input the URL of your Jira instance (e.g. https://jira.acme-corp.com). Then input the whole name of the Jira project you want to integrate with.

Finally, enter the Personal Access Token from the previous step. Once complete, you've successfully integrated Jira with Opal. You will be able to load and bind Jira tickets from the project name from the Jira workspace you specified.

How it works

For any access request, binding to a support ticket is optional.

After Jira is integrated, when making a request, the option to Bind to a support ticket will be enabled.

Click the check box next to Bind a support ticket. A list of support ticket providers will appear. Select Bind to Jira ticket.

By clicking Search for tickets, a list of Jira tickets will appear, only including tickets which are assigned to you in Jira (the Jira account which corresponds to your Opal email address).

Click on any of these support tickets to attach the ticket to the access request.

By default, an expiration time bound is required when making any access request.

After the request is approved, access expiration is determined by the combination of this expiration time bound and the closure of the support ticket. Access will expire according to the minimum of these two events: if the ticket is closed before the expiration time bound is reached, access will be revoked when the ticket is closed.

Similarly, if the expiration time bound is reached before the closure of the ticket, access is revoked when the expiration time bound is reached.

If you want to attach an access request to a support ticket, without an expiration time bound, you may select Indefinite under the expiration options and bind the request to a support ticket.

Did this answer your question?