Integrating with Linear

Overview

Integrating with Linear enables you to:

  • Create Linear issues for entire Actions or any number of individual findings directly from the Actions page.
  • Create Linear issues for single or multiple security findings directly from the Backlog page.

Steps for integrating with Linear

  1. Generate an API token from your Linear account.

  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 Linear tile and select Integrate as-code. You are taken to the jit-integration.yml file. Add your API token and relevant Linear 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.

    linear:
      Engineering:
        auth:
          api_token: ${{ jit_secrets.linear-token }}
        preferences:
    	team_id: your-team-id
    	Project_id: optional
    
KeyValue/description
linear:Integration type. Key must be linear. The Linear 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 Linear integration. Engineering is used in the above example.
api_token:See procedure steps.
team_id:Retrieve this value by querying the graphql API at https://api.linear.app/graphql. For instructions, see Linear documentation.
Project_id:Retrieve this value by querying the graphql API at https://api.linear.app/graphql. For instructions, see Linear documentation.