Linear

Linear is a modern issue tracking and project management platform designed for software development teams. It helps organizations plan work, track issues, manage projects, and coordinate development efforts through streamlined workflows and collaboration tools.

Integrating OX Security with Linear brings security findings directly into your development workflow. Security issues detected by OX can be created as Linear tickets, linked to existing Linear work items, or automatically tracked through workflows, helping security and engineering teams collaborate on remediation within their existing development processes.

Benefits of the integration include:

• Centralized Issue Management: Track and manage security findings alongside development work in Linear.

• Faster Remediation: Create and assign tickets directly from OX to ensure security issues are addressed by the appropriate teams.

• Improved Collaboration: Give security and engineering teams shared visibility into security findings and remediation progress.

• Automated Workflows: Automatically create Linear tickets based on OX policies and issue conditions.

• Consistent Development Processes: Manage security issues using the same planning, prioritization, and tracking workflows already used by your development teams.

Adding Linear tickets

After establishing the connection with Linear, you can add Linear tickets to issues in OX using one of the following methods:

• Creating a new Linear ticket.

• Linking an existing Linear ticket.

• Creating Linear tickets automatically using workflows.

Creating a new Linear ticket

Create a new Linear ticket when the issue is not yet being tracked in Linear and you want OX to create a new work item for remediation.

To create a new Linear ticket in OX:

1. On the Active Issues page, identify and select the issue for which you want to add a new ticket in Linear.

1. In the issue details dialog, on the bottom, go to More Actions and select Linear Actions > Create Linear Ticket.

2. Configure the ticket settings.

Parameter	Description
Title	The title of the ticket. By default, OX populates the issue title.
Team	The Linear team that owns the ticket.
Project	The Linear project associated with the ticket.
Status	The initial workflow status of the ticket.
Priority	The priority assigned to the ticket.
Assignee	The team member assigned to the ticket.
Labels	Labels to apply to the ticket.

1. Select Save Changes.

The new ticket appears in Linear.

Linking an existing Linear ticket

Link an existing Linear ticket when the remediation work is already being tracked in Linear, and you want to associate the OX issue with that existing work item.

For example, a developer may have already created a ticket to address the issue, or the issue may already be tracked as part of a larger remediation effort.

Note

An OX issue can be associated with multiple Linear tickets. For example, you can create a new Linear ticket and later link additional existing Linear tickets to the same issue.

To link an OX issue to an existing ticket(s) in Linear:

1. On the Active Issues page, select the issue to which you want to link an existing Linear ticket.

2. In the issue details dialog, on the bottom, go to More Actions and select Linear Actions > Link Linear Ticket.

1. Enter the Linear ticket key or ID.

2. Select Link Ticket.

The existing Linear ticket is associated with the OX issue and appears in the Related Tickets section in Linear.

Unlinking a Linear ticket

Unlink a Linear ticket when you want to remove the association between an OX issue and a Linear ticket without deleting the ticket from Linear.

To unlink Linear tickets from OX issues:

1. On the Active Issues page, select the issue that you want to unlink from an existing Linear ticket.

2. In the issue details dialog, on the bottom, go to More Actions and select Linear Actions > Unlink Linear Ticket.

1. Select Unlink Ticket.

The ticket remains in Linear but is no longer associated with the OX issue.

Connecting to Linear

Prerequisites

• A Linear workspace.

• A Linear user account with permission to create personal API keys.

• Permission to create and manage issues in the target Linear team.

Step 1: Create a Linear API key

1. Sign in to Linear.

2. Select your profile picture and then select Settings.

3. In the left navigation pane, select Security & access > Personal API keys.

1. Select New API key.

1. Enter a descriptive name for the API key, such as oxkey.

2. Select Create.

1. Copy the generated API key and store it in a secure location, as Linear displays the API key only once.

Step 2: Connect Linear to OX

1. In the OX platform, go to Settings > Connectors.

2. Select Linear.

3. Configure the connector settings.

Parameter	Description
API Key	The personal API key generated in Linear.

1. Select Connect.

OX verifies the connection and displays the connector status.