Skip to main content

​
Overview

The Datto RMM integration enables ThreatAware to collect read-only data from your Datto RMM platform, providing visibility into your managed IT environment and helping validate your IT operations and security controls.
Connection Method: API Setup Time: 20 minutes Access Required: Datto RMM Administrator account

​
Data collected

The Datto RMM integration provides:
  • Device inventory and status
  • System health and performance metrics
  • Configuration management data
  • Remote monitoring and management details

​
Use cases

Device Inventory Tracking

Monitor managed devices across your Datto RMM infrastructure

Compliance Validation

Verify IT management configurations and policies

Operations Monitoring

Track system health and performance across your environment

Audit Support

Generate reports showing device management coverage

​
Setup instructions

1

Enable API Access in Datto RMM

In your Datto RMM console:
  • Navigate to Setup > Account Settings > Access Control
  • Set Enable API Access to ON
2

Create API Key for User

  • Go to Setup > Users and select the username you want to enable API access for
  • Click the Generate API Keys hyperlink to create an API Key and API Secret Key
  • Save and securely store the generated credentials
3

Determine Your Filter (Site)

To create a custom device filter:
  • Create a custom device filter in Datto RMM
  • Select the term Site name and operator Equals
  • Enter the name of the site you are connecting
  • Save the filter
  • Click on the filter and copy the ID from the URL
The URL format will be: ...filter_id=XXXXX - copy the ID value.
4

Obtain API URL

Your Datto RMM API URL is typically:
  • Primary endpoint: https://api.centrastage.net or
  • Region-specific endpoint: Check your Datto RMM dashboard for your region’s API URL
5

Configure in ThreatAware

Complete the integration setup in ThreatAware:
  • Open ThreatAware and navigate to Settings > Integrations
  • Search for and select Datto RMM
  • Enter the required credentials:
    • API Key: The key generated in Datto RMM
    • API Secret Key: The secret key generated
    • API URL: Your Datto RMM API endpoint
    • Filter ID: The ID of your custom device filter
  • Click Authorize to establish the integration
6

Verify Connection

After connecting, verify the integration status shows as Active in ThreatAware.

​
Required credentials

Field Name: Datto RMM API Key Type: String Description: The API key generated in Datto RMM user settingsThis is used to authenticate your ThreatAware connection.
Field Name: Datto RMM API Secret Key Type: Password (encrypted) Description: The secret key associated with the API Key
Store this credential securely in your organisation’s password manager for future reference.
Field Name: Datto RMM API URL Type: String Description: Your Datto RMM API endpoint URLFormat: https://api.centrastage.net or region-specific URL Example: https://api.centrastage.net
Field Name: Datto RMM Filter ID Type: String Description: The ID of the custom device filter for your siteExtract this from the filter URL: filter_id=XXXXX

​
Verification and testing

After setup, verify the integration is working correctly:
  1. Check Integration Status
    • Navigate to Settings > Integrations in ThreatAware
    • Confirm the Datto RMM integration shows Active status
  2. Verify Data Synchronization
    • Check for data synchronization between Datto RMM and ThreatAware interfaces
    • Verify devices from your selected site are appearing in ThreatAware
  3. Test Queries
    • Create a test query to filter devices from Datto RMM
    • Verify the data matches your Datto RMM inventory

​
Troubleshooting

Symptoms: Integration status shows authentication failureSolutions:
  • Double-check the API Key and API Secret Key for accuracy
  • Ensure you copied the credentials completely without extra spaces
  • Verify the API credentials have not expired
  • Confirm the user account still has API access enabled
Symptoms: Integration connects but no data or limited data appearsSolutions:
  • Verify the API key permissions align with ThreatAware’s access requirements in Datto RMM
  • Check that the user account has the necessary roles
  • Ensure the custom filter includes devices you expect to see
  • Review Datto RMM API Documentation for details
Symptoms: Integration fails to connect with timeout errorsSolutions:
  • Verify the API URL is correct for your region
  • Check firewall rules allow outbound HTTPS (443) to Datto RMM
  • Test the API URL accessibility using a web browser
  • Confirm your internet connection is stable
Symptoms: Integration shows active but no devices from the site appearSolutions:
  • Verify the Filter ID is correct
  • Ensure the custom filter in Datto RMM is properly configured
  • Check that devices exist in Datto RMM for the specified site
  • Verify the filter is using the correct site name
  • Review ThreatAware integration logs (contact support if needed)

​
Additional resources

Datto RMM Documentation

Official Datto RMM API documentation and resources

ThreatAware Support

Contact ThreatAware support for integration assistance

​
Best practices

Credential Management
  • Create a dedicated API key specifically for ThreatAware
  • Document credentials in your organisation’s password manager
  • Rotate credentials annually or per your security policy
  • Monitor for authentication failures in ThreatAware regularly
Security Considerations
  • Only grant necessary permissions to the API key
  • Limit filter scope to relevant sites and devices
  • Review API access logs in Datto RMM periodically
  • Follow your organisation’s least privilege principles