> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threataware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TeamViewer

> Connect ThreatAware to TeamViewer to monitor remote access and device management

## Overview

The TeamViewer integration enables ThreatAware to access your TeamViewer Management Console data, providing visibility into remote access devices and management activities. This helps you monitor device inventory and validate remote access controls.

<Info>
  **Connection Method**: API (Script Token)
  **Setup Time**: 15 minutes
  **Access Required**: TeamViewer Administrator account
</Info>

## Data collected

The TeamViewer integration provides:

* Device inventory and status
* Device group information
* Remote access device details
* Device connectivity status

## Use cases

<CardGroup cols={2}>
  <Card title="Remote Device Inventory" icon="desktop">
    Track all devices managed through TeamViewer
  </Card>

  <Card title="Device Group Monitoring" icon="network-wired">
    Monitor device organisation and group assignments
  </Card>

  <Card title="Access Control Validation" icon="shield">
    Verify remote access management controls are configured
  </Card>

  <Card title="Asset Visibility" icon="eye">
    Maintain visibility into remote-accessed devices
  </Card>
</CardGroup>

## Setup instructions

<Steps>
  <Step title="Log in to ThreatAware">
    * Navigate to the ThreatAware dashboard
    * Go to **Settings → Integrations**
    * Use the search bar to locate **TeamViewer**
    * Click **Connect** - a pop-up window will appear
  </Step>

  <Step title="Access TeamViewer Management Console">
    * Open the [TeamViewer Management Console](https://login.teamviewer.com/)
    * Log in using your TeamViewer administrator credentials
  </Step>

  <Step title="Create a Script Token">
    * Click your **profile picture** in the top right corner
    * Select **Edit Profile**
    * Go to **Apps** in the left menu
    * Click **Create Script Token**
    * Name the token (e.g., "ThreatAware Integration")
    * Assign the following permission:
      * **Computers: View entries**
    * Save and **copy the script token** that is displayed
    * Keep this token secure - you'll need it for ThreatAware
  </Step>

  <Step title="Retrieve Device Group IDs">
    * In the TeamViewer Management Console, navigate to your device groups
    * For each group you want to connect to ThreatAware:
      * Open the device group
      * Copy the **Group ID** from the URL (format: `g123456789`)
      * Note all Group IDs you want to include
    * If you only have one group, copy just that Group ID
  </Step>

  <Step title="Configure in ThreatAware">
    In the ThreatAware pop-up window, enter:

    * **Script Token**: Paste the script token from TeamViewer
    * **Group ID**: Enter the Group ID (or multiple Group IDs as a comma-separated list)
    * **TeamViewer Version**: Enter the version of TeamViewer in use
    * Click **Authorize** to complete the integration
  </Step>

  <Step title="Verify Connection">
    * Check the **Integration Status** in ThreatAware displays as **Active**
    * Data collection will begin within 1 hour
    * Verify devices from TeamViewer appear in ThreatAware
  </Step>
</Steps>

## Required credentials

<AccordionGroup>
  <Accordion title="Script Token" icon="key">
    **Field Name**: TeamViewer Script Token
    **Type**: String (sensitive)
    **Description**: The API token generated in TeamViewer Management Console

    * Generated under Apps > Create Script Token
    * Must have "Computers: View entries" permission
    * Store securely for future reference
  </Accordion>

  <Accordion title="Group ID" icon="folder">
    **Field Name**: TeamViewer Group ID
    **Type**: String
    **Description**: The ID of the device group(s) to connect

    * Found in the URL when viewing a device group (format: `g123456789`)
    * For multiple groups, enter as comma-separated list: `g123456789,g987654321`
    * If unsure, start with your primary device group
  </Accordion>

  <Accordion title="TeamViewer Version" icon="tag">
    **Field Name**: TeamViewer Version
    **Type**: String
    **Description**: The version of TeamViewer running in your environment

    * Example: `15.0`, `14.7`, etc.
    * Found in TeamViewer client settings or Management Console
  </Accordion>
</AccordionGroup>

## Verification and testing

After setup, verify the integration is working correctly:

1. **Check Integration Status**
   * Navigate to **Settings → Integrations** in ThreatAware
   * Confirm TeamViewer shows **Active** status
   * Check the last sync timestamp

2. **Verify Device Data**
   * Wait 60 minutes for the initial data poll
   * Search for a known TeamViewer device in ThreatAware
   * Verify device details match the TeamViewer Management Console

3. **Test Device Group Filtering**
   * Create a test query to filter devices from TeamViewer
   * Verify devices from each connected group appear correctly

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid Token Error" icon="triangle-exclamation">
    **Symptoms**: Integration status shows token validation failure

    **Solutions**:

    * Verify the script token is entered exactly as copied from TeamViewer
    * Ensure the token has not expired or been revoked
    * Check that the token has **View entries** permission for computer groups
    * Regenerate a new script token if the current one is invalid
  </Accordion>

  <Accordion title="Group ID Issues" icon="ban">
    **Symptoms**: Integration connects but shows no devices or wrong devices

    **Solutions**:

    * Verify Group IDs are copied correctly from the URL (format: `g123456789`)
    * Ensure the script token has access to all specified device groups
    * Check that device groups contain devices (not empty groups)
    * For multiple groups, verify comma-separated format is correct
    * Try with a single known Group ID first to isolate the issue
  </Accordion>

  <Accordion title="Permission Denied" icon="lock">
    **Symptoms**: Integration connects but cannot retrieve device data

    **Solutions**:

    * Verify the script token was created with **View entries** permission
    * Check that the TeamViewer administrator account still has group access
    * Ensure the token permissions have not been modified
    * Regenerate the token with correct permissions if needed
    * Review [TeamViewer API Documentation](https://login.teamviewer.com) for permission requirements
  </Accordion>

  <Accordion title="No Devices After 1 Hour" icon="database">
    **Symptoms**: Integration shows active but no devices appear in ThreatAware

    **Solutions**:

    * Verify the specified device groups contain active devices
    * Check that devices are not in offline or excluded state
    * Confirm the script token has access to the specified Group IDs
    * Wait additional time - first sync may take longer than 1 hour
    * Review ThreatAware integration logs for error messages
  </Accordion>
</AccordionGroup>

## Important notes

<Info>
  **Token Security**

  * Script tokens provide API access to TeamViewer data
  * Store the token securely and do not share it
  * If the token is compromised, regenerate it immediately in TeamViewer
  * Only use tokens for authorised integrations like ThreatAware
</Info>

<Tip>
  **Device Group Permissions**

  * Ensure the script token has access to all device groups you want to monitor
  * If adding new device groups to TeamViewer, you may need to update the Group ID list in ThreatAware
  * Test with a single group first, then expand to multiple groups if needed
</Tip>

## Additional resources

<CardGroup cols={2}>
  <Card title="TeamViewer API Documentation" icon="book" href="https://login.teamviewer.com">
    Official TeamViewer API documentation for detailed setup and permissions
  </Card>

  <Card title="ThreatAware Support" icon="life-ring" href="mailto:help@threataware.com">
    Contact ThreatAware support for integration assistance
  </Card>
</CardGroup>

## Best practices

<Tip>
  **Token Management**

  * Create a dedicated script token specifically for ThreatAware integration
  * Document which device groups the token has access to
  * Rotate tokens annually or if security concerns arise
  * Monitor TeamViewer audit logs for token usage
</Tip>

<Tip>
  **Device Group Strategy**

  * Start with your critical device groups
  * Add additional groups incrementally as needed
  * Keep Group IDs documented in your integration records
  * Review and update Group IDs if your organisational structure changes
</Tip>