> ## Documentation Index
> Fetch the complete documentation index at: https://docs.krait.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tickets

> Turn security findings into trackable work items with Krait's native Linear integration. Set it up once and your entire team can create, assign, and track vulnerability-driven tickets without leaving their workflow.

## Connecting Krait with Linear

This is a one-time setup per workspace. Once connected, everyone in your Krait organization can create Linear issues directly from findings.

<Info>
  You must be a workspace Owner, Administrator, or Manager to connect or configure Linear.
</Info>

<Steps>
  <Step title="Navigate to Integrations">
    Go to **Integrations**, then **Ticketing**, then select the **Linear** card.
  </Step>

  <Step title="Provide Required Credentials">
    An integration panel will open on the right. Enter your **Linear API Key**, which you can generate from your Linear account settings.

    <Frame>
      <img src="https://mintcdn.com/krait/9ioPUQVgYHbGs9dJ/integrations/images/linear_access_token.png?fit=max&auto=format&n=9ioPUQVgYHbGs9dJ&q=85&s=3a3cbf2df858fbfe3e944891ec780b98" alt="linear_access_token" className="mx-auto" style={{ width:"82%" }} width="1550" height="328" data-path="integrations/images/linear_access_token.png" />
    </Frame>

    Grant Krait permission to access your Linear workspace. Once authorized, Krait validates the connection and confirms it is active.
  </Step>
</Steps>

## User Mapping

If you use a different email address in Linear than the one you use in Krait, tickets pushed to Linear will not automatically know who to assign them to. User mapping lets you explicitly link your Krait account to the correct Linear identity so that tickets are always assigned to the right person.

<Steps>
  <Step title="Open the Linear Integration">
    Navigate to **Integrations**, then **Ticketing**, then **Linear**.
  </Step>

  <Step title="Go to User Mapping">
    Inside the Linear integration panel, scroll down to the **User Mapping** section. Krait will list all members of your workspace.

    <Frame>
      <img src="https://mintcdn.com/krait/9ioPUQVgYHbGs9dJ/integrations/images/linear-usermapping.png?fit=max&auto=format&n=9ioPUQVgYHbGs9dJ&q=85&s=8b9884047b7ea54bf1d499eefac061bf" alt="linear-usermapping" className="mx-auto" style={{ width:"80%" }} width="1320" height="424" data-path="integrations/images/linear-usermapping.png" />
    </Frame>
  </Step>

  <Step title="Add Your Linear Email">
    Next to your name, enter the email address associated with your Linear account. This tells Krait which Linear user to assign tickets to when they are created from Krait.
  </Step>

  <Step title="Save">
    Click **Save** to confirm. Tickets created from Krait will now be correctly assigned to your Linear account.
  </Step>
</Steps>

<Note>
  Each workspace member sets their own mapping independently. If a member has no mapping configured, tickets pushed to Linear will be unassigned.
</Note>

## Disconnecting Linear

You can disconnect Linear from Krait at any time.

<Frame>
  <img src="https://mintcdn.com/krait/9ioPUQVgYHbGs9dJ/integrations/images/linear_disconnect.png?fit=max&auto=format&n=9ioPUQVgYHbGs9dJ&q=85&s=7878e190f566aca259f367c4f761444d" alt="linear_disconnect" className="mx-auto" style={{ width:"70%" }} width="2190" height="740" data-path="integrations/images/linear_disconnect.png" />
</Frame>

<Warning>
  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 a workspace owner or admin to disconnect Linear from Krait.
</Warning>
