Skip to main content
This guide explains how to connect Tailscale to Clarion. Once configured, Clarion receives Tailscale webhook events and creates alerts that agents can triage and investigate.
Estimated time: 5-10 minutes. You will need Tailscale Owner or Admin access and access to the Clarion workspace where you want to connect Tailscale.

​
Prerequisites

  • A Tailscale account with Owner or Admin role
  • Access to the Clarion workspace where you want to configure the integration

​
Get the webhook URL and secret from Clarion

  1. Open Clarion and go to Integrations → Tailscale.
  2. Click Connect to generate a webhook URL and secret for this workspace.
  3. Copy the Webhook URL and Secret. You will paste these into Tailscale in the next step.

​
Configure the webhook in Tailscale

  1. Sign in to the Tailscale admin console.
  2. Navigate to Settings → Webhooks.
  3. Click Add endpoint.
  4. Paste the Webhook URL from Clarion into the Endpoint URL field.
  5. Paste the Secret from Clarion into the Secret field.
  6. Select the event types you want to receive. Clarion handles all Tailscale event types:
    • Device events: nodeNeedsApproval, nodeApproved, nodeKeyExpiringSoon, nodeKeyExpiryDisabled, nodeKeyExpiryEnabled, nodeNotSeen
    • Policy events: policyUpdate
    • User events: userNeedsApproval, userApproved, userSuspended, userRoleUpdated, userCreated, userDeleted
  7. Click Save.
  8. Use Send test event to verify the connection. Clarion will create a test alert to confirm delivery.

​
How severity is mapped

EventSeverity
nodeNotSeen, userSuspended, nodePolicyViolationCritical
nodeNeedsApproval, userNeedsApprovalHigh
policyUpdate, userRoleUpdated, nodeKeyExpiringSoon, nodeKeyExpiryEnabledMedium
All other eventsLow

​
Verifying the connection

After saving the webhook in Tailscale, send a test event from the Tailscale admin console. A test alert will appear in Clarion under Alerts, confirming the integration is working.