Skip to main content

​
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.
Connection Method: API (Script Token) Setup Time: 15 minutes Access Required: TeamViewer Administrator account

​
Data collected

The TeamViewer integration provides:
  • Device inventory and status
  • Device group information
  • Remote access device details
  • Device connectivity status

​
Use cases

Remote Device Inventory

Track all devices managed through TeamViewer

Device Group Monitoring

Monitor device organisation and group assignments

Access Control Validation

Verify remote access management controls are configured

Asset Visibility

Maintain visibility into remote-accessed devices

​
Setup instructions

1

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
2

Access TeamViewer Management Console

3

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
4

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
5

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
6

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

​
Required credentials

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
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
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

​
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

Symptoms: Integration status shows token validation failureSolutions:
  • 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
Symptoms: Integration connects but shows no devices or wrong devicesSolutions:
  • 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
Symptoms: Integration connects but cannot retrieve device dataSolutions:
  • 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 for permission requirements
Symptoms: Integration shows active but no devices appear in ThreatAwareSolutions:
  • 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

​
Important notes

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
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

​
Additional resources

TeamViewer API Documentation

Official TeamViewer API documentation for detailed setup and permissions

ThreatAware Support

Contact ThreatAware support for integration assistance

​
Best practices

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
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