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

# Datto RMM

> Connect ThreatAware to Datto RMM for remote IT management and device monitoring

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

<Info>
  **Connection Method**: API
  **Setup Time**: 20 minutes
  **Access Required**: Datto RMM Administrator account
</Info>

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

<CardGroup cols={2}>
  <Card title="Device Inventory Tracking" icon="server">
    Monitor managed devices across your Datto RMM infrastructure
  </Card>

  <Card title="Compliance Validation" icon="clipboard-check">
    Verify IT management configurations and policies
  </Card>

  <Card title="Operations Monitoring" icon="eye">
    Track system health and performance across your environment
  </Card>

  <Card title="Audit Support" icon="file-contract">
    Generate reports showing device management coverage
  </Card>
</CardGroup>

## Setup instructions

<Steps>
  <Step title="Enable API Access in Datto RMM">
    In your Datto RMM console:

    * Navigate to **Setup** > **Account Settings** > **Access Control**
    * Set **Enable API Access** to **ON**
  </Step>

  <Step title="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
  </Step>

  <Step title="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.
  </Step>

  <Step title="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
  </Step>

  <Step title="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
  </Step>

  <Step title="Verify Connection">
    After connecting, verify the integration status shows as **Active** in ThreatAware.
  </Step>
</Steps>

## Required credentials

<AccordionGroup>
  <Accordion title="API Key" icon="key">
    **Field Name**: Datto RMM API Key
    **Type**: String
    **Description**: The API key generated in Datto RMM user settings

    This is used to authenticate your ThreatAware connection.
  </Accordion>

  <Accordion title="API Secret Key" icon="lock">
    **Field Name**: Datto RMM API Secret Key
    **Type**: Password (encrypted)
    **Description**: The secret key associated with the API Key

    <Tip>
      Store this credential securely in your organisation's password manager for future reference.
    </Tip>
  </Accordion>

  <Accordion title="API URL" icon="server">
    **Field Name**: Datto RMM API URL
    **Type**: String
    **Description**: Your Datto RMM API endpoint URL

    **Format**: `https://api.centrastage.net` or region-specific URL
    **Example**: `https://api.centrastage.net`
  </Accordion>

  <Accordion title="Filter ID" icon="filter">
    **Field Name**: Datto RMM Filter ID
    **Type**: String
    **Description**: The ID of the custom device filter for your site

    Extract this from the filter URL: `filter_id=XXXXX`
  </Accordion>
</AccordionGroup>

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

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

    **Solutions**:

    * 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
  </Accordion>

  <Accordion title="Permission Denied" icon="ban">
    **Symptoms**: Integration connects but no data or limited data appears

    **Solutions**:

    * 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](https://www.datto.com/resources) for details
  </Accordion>

  <Accordion title="Connection Timeout" icon="clock">
    **Symptoms**: Integration fails to connect with timeout errors

    **Solutions**:

    * 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
  </Accordion>

  <Accordion title="No Devices Appearing" icon="database">
    **Symptoms**: Integration shows active but no devices from the site appear

    **Solutions**:

    * 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)
  </Accordion>
</AccordionGroup>

## Additional resources

<CardGroup cols={2}>
  <Card title="Datto RMM Documentation" icon="book" href="https://www.datto.com/resources">
    Official Datto RMM API documentation and resources
  </Card>

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

## Best practices

<Tip>
  **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
</Tip>

<Tip>
  **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
</Tip>