Skip to main content

Connecting Krait with Linear

This one-time setup for each workspace lets everyone in your Krait organization make issues directly in Linear.
You must be workspace OWNER / ADMINISTRATOR / MANAGER to connect or configure Linear to Krait.
1

Navigate to Integrations

Linear Integration Tab Pn
2

Provide Required Credentials

A integration panel will open on the right.
  • Provide the following required Linear connection details:
    • Linear API Key: Personal API key generated from Linear settings.
linear_access_token
  • Grant Krait permission to access your Linear workspace
Once authorized Krait validates the settings promptly and confirms if the connection is successful.
linear_global_configure_success
3

Assign Integration to Resources

Admins can choose whether Linear Configuration should be:
  • Global (applies to all available resources)
  • Resource-specific (e.g., only for selected resources)
This ensures that engineering teams only receive tickets for the resources they are responsible for.

Configuring Linear to Krait

There are two different options to configure Linear to Krait
  • Global configuration
  • Per-resource configuration

Linear Integration - Global Configuration

The default project and team where Krait will generate linear issues for every resource in the workspace are defined by the global linear configuration. Unless a particular resource has its own override, this setting is applicable to all resources.

How to Configure Linear Globally

1

Connect Linear to Krait

Begin by authorizing Krait to access your Linear workspace. After successful authorization, you will see:
“Linear Connected Successfully - Your integration is now active. We’re synchronizing your data in the background.”
This indicates that your Linear metadata (projects, teams) is being pulled into Krait.
2

Select Default Project and Team

Choose the Linear Project where Krait should generate new issues by default. Then assign the team responsible for handling vulnerability tickets.
linear_global_configure_2
3

Save Configuration

Select Save Configuration to finalize.
linear_global_configure_success
All tickets generated across all resources in this workspace will follow this default mapping unless overridden at the resource level.

Linear Integration - Per-Resource Configuration

The default project and team where Krait will generate linear issues for every resource in the workspace are defined by the global linear configuration. Unless a particular resource has its own override, this setting is applicable to all resources. When various technical teams maintain different components, this is helpful.

How to Configure Linear Per-Resource

1

Open Ticketing Configuration

Navigate to a vulnerability details page and select:
Configure your Ticketing System
linear_resource_configure_1
This opens a resource-specific configuration dialog.
2

Choose a project and team

Select the Linear Project that should be the only one to receive problems produced by this resource. Next, designate the Linear Team responsible for this resource’s problems. To save, click Submit after that.
linear_resource_configure_2
This configuration applies only to this specific resource. Krait will always prioritize per-resource settings over global defaults.

Disconnecting Linear

You can choose to disconnect Linear from Krait anytime you want.
linear_disconnect
By disconnecting, you will lose access to the following Linear features within Krait:
  • Automatic issue syncing
  • All existing Linear connections
  • The ability to create new issues from Krait
You must be workspace owner or admin to disconnect Linear from Krait.