Linear

Automatically create issues in Linear for streamlined vulnerability remediation.

This integration is currently in beta.

Linear Setup

Generate an API key in Linear:

1. Log in to your Linear workspace at linear.app.

2. Navigate to Settings > Security & access.

3. Under Personal API Keys, click New API Key.

4. Give your key a descriptive name (e.g., "Halo Security Integration").

5. Copy the generated API key.

Connect Linear to Halo Security

1. Navigate to Settings → Integrations → Add.

2. Select Linear from the list of available integrations.

3. Name the integration and click Add.

4. Enter your API Key.

5. Click Save.

Create Profiles

After connecting Jira, you can create profiles to control how tickets are created. To create a profile:

1. Navigate to the Profiles tab

2. Click the + icon

3. Enter a name for the profile

4. Configure your settings:

   1. Team

   2. Project

   3. Assigned To

   4. Default Priority

5. Click Save

Create Issues

Manually Create Linear Issues

When viewing an Issue, you can easily create an individual Linear issue for the issue.

1. Click the Plug icon in the top right

2. Select the Profile you'd like to use

3. Make any adjustments to the ticket details

4. Click Create Issue

Automatically Create Linear Issues for Halo Security Issues

To create tickets for issues, we recommend using Automations.;

• Navigate to Settings → Automations

• Create a filter with the type as Target Issue

• Apply the profile you created as an action

Learn more about Automations:

Automations

Automatically Create Linear Issues for Additional Events

Event rules allow you to create a Linear issues for Halo Security events beyond issues. For example, you can create a Linear issue when a new port is opened or a new target is added.

To receive Linear issues, create Event Rules and add your Linear profile as an action.

Visit Events → Event Rules to set up rules that determine which events created Tickets in Jira.

Learn more about configuring Event Rules:

Event Rules