# Twingate

---
title: Connecting Twingate to WatchDog Security
category: Integrations
integration_type: api_token
products_supported:
  - Posture Management
  - Inventory
  - Compliance Center
---
This guide explains how to connect **Twingate** to WatchDog Security using an API token.

Once connected, WatchDog will monitor your Twingate environment for security posture risks, configuration issues, and inventory data.

---

## What WatchDog Monitors

:::tip[]
WatchDog operates in **read-only mode** and does **not modify configuration settings** within your Twingate environment.
:::

After the integration is connected, WatchDog may monitor:

<Accordion title="Scopes" defaultOpen>

**Devices**

- Registered endpoint devices
- Device ownership and association
- Device operating systems and posture data

**DNS Filtering**

- DNS filtering configuration
- Domain filtering policies
- DNS security enforcement settings

**Service Accounts**

- Service account identities
- Service account permissions
- Automation access tokens

**Users**

- Twingate user accounts
- User access assignments
- Authentication and access configuration

</Accordion>

The exact information collected depends on the permissions granted to the integration.

---

## Requirements

Before connecting the integration, ensure the following:

- You have **administrator access** to Twingate
- You're an **Account Owner** or **Security Admin** in WatchDog UI

---

## Step 1 — Generate an API Token in Twingate

You can generate a trusted credential directly from the **Twingate Admin Console**.

1. Log into the **Twingate Admin Console**
2. Navigate to: Settings → Trust Credentials
3. Click **+ Credential**
4. Under **New Credential**, select: OAuth
5. Enter a description for the credential  (Example: WatchDog Security)
6. Click **Continue**
7. Under **Scopes**, select:
8. Click **Generate Credentials**
9. Copy the generated **API credentials**

---

## Step 2 — Connect the Integration in WatchDog

1. Log into the **WatchDog Security Portal**
2. Navigate to **Management → Integrations**
3. Locate **Twingate**
4. Click **Connect**
5. Enter the generated **Twingate API credentials**
6. Click **Connect Integration**

---

## Initial Sync

<Accordion title="After the integration is connected" defaultOpen>

- WatchDog will begin collecting data from Twingate
- The first synchronization typically completes within **5–10 minutes**

</Accordion>

<Accordion title="Data will appear within the following modules" defaultOpen>

- **Posture Management**
- **Inventory**
- **Compliance Center**

</Accordion>

---

## Troubleshooting

<AccordionGroup>

<Accordion title="Integration Fails to Connect" defaultOpen>

Verify the following:

- The API credentials were copied correctly
- The credential was created with **Read access**
- The credential has not been revoked

</Accordion>

<Accordion title="No Data Appears">

If no data appears after connecting:

- Wait for the initial synchronization to complete
- Verify the credential permissions
- Reconnect the integration if necessary

</Accordion>

</AccordionGroup>

---

## Related Documentation
- https://www.twingate.com/docs/api-overview