WatchDog Security Help Center
    Admin Guide
    • Docs Home
    • Admin Guide
    • User Guide
    • MSP Guide
    • Release Notes
    • Back to home
    • Integrations
    • Connecting Cloudflare to WatchDog Security
    • Connecting Google Workspace to WatchDog Security
    • Connecting WatchDog & Docker Hub (Personal)
    • Connecting WatchDog & Tailscale
    • Connecting Twingate to WatchDog Security
    • Connecting WatchDog & Intercom
    • Connecting Microsoft 365 to WatchDog Security
    • Connecting Google Cloud to WatchDog Security
    • Connecting Microsoft Azure to WatchDog Security
    • Connecting WatchDog & Amazon Web Services (AWS)
    • Connecting Microsoft Teams to WatchDog Security
    • Connecting Slack to WatchDog Security
    • Connecting Linear to WatchDog Security
    • Connecting Namecheap to Watchdog Security

    Connecting Linear to WatchDog Security

    Overview#

    This guide explains how to connect Linear to WatchDog Security using OAuth authentication.
    Once connected, WatchDog will monitor your Linear workspace for security posture risks, configuration issues, and asset inventory data related to users, teams, and workspace settings.

    What WatchDog Monitors#

    WatchDog operates in read-only mode and does not modify configuration settings within your Linear workspace.
    After the integration is connected, WatchDog may monitor:
    Scopes
    Workspace & Organization
    Workspace configuration
    Organization settings
    Team structures
    Users & Access
    Users and user status
    Roles and permissions
    User access levels
    Teams & Collaboration
    Teams and team membership
    Team permissions and structure
    Authentication & Security
    Authentication methods
    Access controls and workspace security settings
    Projects & Issues (Metadata Only)
    Project metadata
    Issue metadata (non-content)
    The exact information collected depends on the permissions granted during OAuth authorization.

    Requirements#

    Before connecting the integration, ensure the following:
    You have access to a Linear workspace
    You're an Account Owner or Security Admin in WatchDog Security
    The user connecting the integration has sufficient permissions within Linear to authorize third-party applications

    Important Behavior#

    Understanding how the Linear integration works ensures proper setup and data visibility.
    WatchDog uses OAuth to access Linear data in read-only mode
    Data visibility depends on the permissions of the user authorizing the integration
    Only resources accessible to the authorized user will be monitored

    Step 1 — Open the Integration in WatchDog#

    1.
    Log into the WatchDog Security Portal
    2.
    Navigate to Management → Integrations
    3.
    Locate Linear
    4.
    Click Connect

    Step 2 — Authorize Linear#

    After authorization is completed, you will automatically be redirected back to WatchDog Security.
    You will be redirected to the Linear authorization page.
    1.
    Select the Linear workspace
    2.
    Review the requested permissions
    3.
    Click Authorize
    WatchDog will securely store the OAuth token and begin syncing workspace data.

    Permissions Required#

    WatchDog requires permission to:
    Read workspace and organization configuration
    Access users, teams, and membership data
    Retrieve project and issue metadata
    Access workspace security and authentication settings
    WatchDog does not require write access to modify Linear data.

    Initial Sync#

    After the integration is connected
    WatchDog will begin collecting Linear workspace data
    The initial synchronization typically completes within 5–10 minutes
    Data appears in the following modules
    Posture Management
    Inventory

    Revoking Access#

    To fully remove WatchDog access from Linear, revoke access in both WatchDog and Linear.

    Step 1 — Disconnect in WatchDog#

    1.
    Log into WatchDog Security
    2.
    Navigate to Management → Integrations
    3.
    Locate Linear
    4.
    Click Disconnect

    Step 2 — Remove Access in Linear#

    1.
    Log into Linear
    2.
    Navigate to: Settings → Security & Access → Applications
    3.
    Locate WatchDog Security
    4.
    Remove or revoke access
    This revokes OAuth authorization and prevents further data access.

    Troubleshooting#

    No Data Appears
    Verify:
    OAuth authorization completed successfully
    The correct workspace was selected
    Wait for the initial sync to complete
    Authorization Failed
    Modified at 2026-04-07 20:56:10
    Previous
    Connecting Slack to WatchDog Security
    Next
    Connecting Namecheap to Watchdog Security
    Built with