Jira

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.

Jira Cloud

Use the following steps to integrate Jira with Opal if you use Jira Cloud.

1. Create a Jira API token

Opal requires an administrator of your Jira workspace to create a Jira API token. Click Create API token and record the generated token. You'll use this in the next step.

2. Add your Jira details to Opal

To enable the Jira integration in Opal, go to Configuration > Settings > Productivity Integrations in the Opal dashboard.

1. Select Jira and enter your Jira workspace name—e.g., if your Jira workspace is https://jiraworkspace.atlassian.net, enter jiraworkspace.
2. Enter the name of the Jira project you want to integrate.
3. Finally, enter the API token from the previous step.

Once complete, you've successfully integrated Jira with Opal. You can now load and bind Jira tickets from the project name from the Jira workspace you specified.

Jira Data Center

📘

Jira 8.14 or later is required.

Use the following steps to integrate Jira with Opal if you use Jira Data Center.

1. Create a Personal Access Token

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.

2. Add your Jira details to Opal

To enable the Jira integration in Opal, go to Configuration > Settings > Productivity Integrations in the Opal dashboard.

1. Select Jira, then Self-hosted.
2. Enter the URL of your Jira instance, e.g., https://jira.acme-corp.com.
3. Enter the name of the Jira project you want to integrate.
4. 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 "Expire access when ticket is closed" can be enabled.

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.