Linear

Step 1: Create a Linear API Key

1. Open Linear in your browser
2. Go to Settings → API → Personal API Keys
3. Click “Create Key”
4. Enter a name (e.g., “RunReveal Integration”)
5. Select scopes:
   • read (to look up teams, projects, labels)
   • write (to create issues)
6. Click “Create”
7. Copy the API key (starts with lin_api_...)

Step 2: Gather Linear Information

Before configuring in RunReveal, you need to know:

• Team Name: The Linear team where issues will be created
• Project Name (optional): The project within the team
• Labels (optional): Comma-separated list of labels to apply
• Priority: No priority, Urgent, High, Normal, Low

Step 3: Configure in RunReveal

1. Go to Notification Channels
2. Click “Add Notification Channel”
3. Select “Linear”
4. Fill in the form:
   • Display Name: Security Issues (or your preferred name)
   • Name: security-issues (internal identifier)
   • Team Name: Enter the Linear team name (e.g., “Security Team”)
   • Project Name: Enter the project name (e.g., “Security Alerts”)
   • Priority: Select priority level
   • Labels: Enter comma-separated labels (e.g., “security, alert, automated”)
   • Linear API Key: Paste the API key from Step 1
5. Click “Test Notification” to verify the connection
6. Click “Create Notification” to save

Step 4: Add Notification Channels to Detections

Add notification channels to detections on individual notifications, within sigma rules, or mass subscribe via the detection query library tab of the detections page in RunReveal.