Integrating with Shortcut
Overview
Integrating with Shortcut enables you to:
- Create Shortcut stories for entire Actions or any number of individual findings directly from the Actions page.
- Create Shortcut stories for single or multiple security findings directly from the Backlog page.
Steps for integrating with Shortcut
-
Generate an API token from your Shortcut account. See Shortcut documentation for instructions.
-
From the Jit platform, select Secrets in the menu bar under Settings.
-
Follow the instructions in Secrets to store this API token as a secret.
-
Select Integrations.
-
Locate the Shortcut tile and select Integrate as-code. You are taken to the
jit-integration.yml
file. Add your API token and relevant Shortcut data to this file. If the option to integrate as-code is not available, you may need to manually addjit-integration.yml
to the repo containing Jit's configuration files.shortcut: Engineering: auth: api_token: ${{ jit_secrets.shortcut-token }} preferences: Project_id: "ProjectID"
Key | Value/description |
---|---|
shortcut: | Integration type. Key must be shortcut . The shortcut integration is nested in this mapping. The jit-integration.yml file does not support concurrent integration of different ticket management systems. |
Engineering: | This key is the name you choose for your Shortcut integration. Engineering is used in the above example. |
api_token: | See procedure steps. |
Project_id: | Project_id can be found in the URL of your Shortcut workspace: https://app.shortcut.com/example/project/ProjectID/project_name |
Updated 29 days ago