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

  1. Generate an API token from your Shortcut account. See Shortcut documentation for instructions.

  2. From the Jit platform, select Secrets in the menu bar under Settings.

  3. Follow the instructions in Secrets to store this API token as a secret.

  4. Select Integrations.

  5. 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"
    
KeyValue/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