Skip to main content
With Opal’s Shortcut integration, you can:
  • Sync access requests with Shortcut tickets to grant access for the lifetime of the ticket
  • Create audit tickets for access requests
  • Propagate access to end systems using Shortcut tickets

​
Configuration requirements

To connect Shortcut with Opal, you must:
  • Be an Opal Admin
  • Have admin access to your Shortcut account to generate an API key
  • Be on version 1.1.090 or later, if you self-host Opal

​
1. Create a Shortcut API key

To enable the Shortcut integration, an administrator of your Shortcut account should create an API key:
  1. Log in to your Shortcut account
  2. Go to Settings in the bottom left corner
  3. Navigate to the API Tokens section in the left sidebar
  4. Copy your existing API key or generate a new one
  5. Save the generated key—you’ll use it in the next step

​
2. Add your Shortcut details to Opal

In Opal, go to Configuration > Organization Settings > Productivity Integrations and select Connect next to Shortcut. Enter your API key from the previous step and then save the integration.

​
Access requests with Shortcut tickets

After you integrate Shortcut, when making an access request, you can enable the option to Expire access when ticket is closed, which allows Opal to reference existing Shortcut tickets. When you select Search for tickets, a list of Shortcut tickets populates, showing tickets assigned to you in Shortcut based on the Shortcut account that 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.

​
Create audit tickets

To create audit tickets in Shortcut for every access request, enable Shortcut as a ticketing provider under Configuration > Organization Settings > Access Requests. Whenever a user requests access in Opal, Opal creates a ticket in Shortcut, allowing you to audit every access request in your own system. Audit tickets are auto-closed by Opal when access expires. You can manually close audit tickets in Shortcut, but this has no effect in Opal.

​
Propagate access with tickets

See the ticket propagation guide to learn how to propagate access with tickets connected to your Shortcut account. This can be especially useful for systems that still require manual access propagation and require someone to be notified via a ticket.