Skip to content

Linear

Configure Linear Integration

Ostorlab offers the possibility to easily manage vulnerabilities using Ostorlab tickets and seamlessly sync them with Linear.

The Linear configuration is done at the organization level: once connected, Ostorlab tickets are synced either one way or two ways to Linear.

Linear Configuration:

To enable the Linear integration, the organization must have an enterprise subscription.

Ostorlab connects to Linear using a personal API key: there is no separate username or workspace URL to configure.

Create a Linear Api key:

  1. Access your Linear API settings. Linear Personal API Keys
  2. Create a personal API key. Linear Create API Key
  3. Copy the generated key.

Connect Linear Integration:

Walkthrough: Menu → Integrations/API → Integrations → Linear → Configuration, turn on the integration, paste the API key, set the sync options, team and risk ratings, add a field mapping, then Save and Test.

Go to Linear Integration menu Integrations/API -> Integrations -> Linear -> Configuration.

  1. Open the Ostorlab main menu. Open Ostorlab Main Menu
  2. Expand Integrations/API. Expand Integrations/API
  3. Click Integrations. Click Integrations
  4. Select the Linear integration and open the Configuration tab. Select the Linear Integration
  5. Turn on Enable Integration. Enable Linear Integration
  6. Paste the Linear Api key in API Key. Add the Linear Api Key
  7. In Team, select the Linear team to sync tickets with. The list of teams is fetched live from Linear once a valid Api key is entered. Select the Linear Team

Click Save, then Test to check the connection to Linear. All the tests should pass. Test Linear Configuration

NOTE: If you would like to whitelist Ostorlab's Linear clients communicating with your Linear instance, contact the support team.

Automatically create Linear issues from Ostorlab tickets:

Make sure the steps in Connect Linear Integration are done and the connection check is passing.

To enable the automatic creation of Linear issues, turn on Automatically create issues in Linear. Automatically Create Ticket

You can also choose to:

  • Sync to Linear: push the updates from Ostorlab to Linear.
  • Sync from Linear: pull the updates from Linear to Ostorlab. Sync From/To Linear

Once the sync modes are configured, you need to choose:

  • The Linear team to use for the issues (see Connect Linear Integration above).
  • If you would like to create the issues as a child issue of an existing one, set the parent issue id in Parent Issue [Optional]. Parent Issue Id
  • Fields to sync.: Linear only supports syncing the ticket title and description automatically; anything else needs a field mapping (see below).
  • Risk Ratings to sync.: only tickets with these risk ratings reach Linear. Risk Ratings to Sync
  • Click Save.

Click Test to check that the integration is able to write an issue to the Linear team.

Field Mapping Types

Under Custom Field Mappings, click Add Mapping, choose the Linear Field and one of three mapping types:

  1. Field Mapping: Maps Ostorlab fields directly to Linear fields (e.g., title, description, priority, state, assignee, labels, due date)
  2. Value Mapping: Sets a static value for a Linear field
  3. Template Mapping: Provides custom templating for Linear fields using Ostorlab ticket variables

Field Mapping Table

Template Mapping

Template mapping allows you to create custom field values using Ostorlab ticket variables. Use double curly braces to reference ticket variables: {{variable_name}}

Available variables:

  • {{title}}: Ticket title
  • {{description}}: Ticket description
  • {{risk_rating}}: Ticket risk rating
  • {{status}}: Ticket status
  • {{assigned}}: Assigned user's username
  • {{due_date}}: Ticket due date
  • {{target}}: The ticket's scanned target
  • {{tags.<tag_name>}}: The value of a ticket tag named <tag_name>

Example template: 

Assigned to {{assigned}}