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

# Ninja RMM

> Connect ThreatAware to Ninja RMM for remote management and device monitoring

## Overview

The Ninja RMM integration enables ThreatAware to collect read-only data from your Ninja RMM platform, providing visibility into remote management activities and device status.

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

## Data collected

The Ninja RMM integration provides:

* Device inventory and status
* Remote management activity logs
* System information and health metrics
* Device asset details

## Use cases

<CardGroup cols={2}>
  <Card title="Device Monitoring" icon="desktop">
    Track device status and health across your managed environment
  </Card>

  <Card title="Remote Management Tracking" icon="network-wired">
    Monitor remote support activities and management operations
  </Card>

  <Card title="Inventory Management" icon="list-check">
    Maintain device inventory with real-time status updates
  </Card>

  <Card title="Compliance Verification" icon="shield-halved">
    Verify remote management controls are properly configured
  </Card>
</CardGroup>

## Setup instructions

<Steps>
  <Step title="Log in to ThreatAware">
    Access the ThreatAware dashboard and navigate to **Settings → Integrations**.
  </Step>

  <Step title="Locate Ninja RMM">
    Use the search bar to find **Ninja RMM** in the integrations list.
  </Step>

  <Step title="Click Connect">
    Click **Connect** and a pop-up window will appear.
  </Step>

  <Step title="Generate API Credentials">
    Log in to your **Ninja RMM platform** with an administrator account.

    * Navigate to **Settings > Apps > Legacy API**
    * Click **Generate New API Key**
    * Copy the **ID** (this is your API key)
    * Copy the **Secret** (this is your API secret)

    <Warning>
      The API secret will only be displayed once. Copy it securely before closing the dialog.
    </Warning>
  </Step>

  <Step title="Determine Your API Subdomain">
    Identify your API subdomain based on your Ninja RMM region:

    * **EU Tenant**: Use `eu-api`
    * **Other Regions**: Use `api`

    <Tip>
      Check your Ninja RMM account settings or contact support if unsure about your region.
    </Tip>
  </Step>

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

    * **API ID**: The ID copied from Ninja RMM
    * **API Secret**: The Secret copied from Ninja RMM
    * **API Subdomain**: `api` or `eu-api` based on your region
    * Click **Connect** to establish the integration
  </Step>

  <Step title="Verify Connection">
    After connecting, verify the integration status:

    * Check that the **Integration Status** shows as **Active**
    * Wait for initial data synchronization
    * Verify device data appears in ThreatAware
  </Step>
</Steps>

## Required credentials

<AccordionGroup>
  <Accordion title="API ID" icon="key">
    **Field Name**: Ninja RMM API ID
    **Type**: String
    **Description**: The ID generated from Ninja RMM Legacy API settings

    Example: `abc123def456`
  </Accordion>

  <Accordion title="API Secret" icon="lock">
    **Field Name**: Ninja RMM API Secret
    **Type**: Password (encrypted)
    **Description**: The secret generated from Ninja RMM Legacy API settings

    <Tip>
      Store this credential securely. It will only be displayed once during generation.
    </Tip>
  </Accordion>

  <Accordion title="API Subdomain" icon="globe">
    **Field Name**: API Subdomain
    **Type**: String
    **Description**: Your API region subdomain

    **Valid Values**:

    * `api` (default for most regions)
    * `eu-api` (for EU tenants)
  </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 Ninja RMM integration shows **Active** status

2. **Verify Data Collection**
   * Wait for initial data sync
   * Search for a known device in ThreatAware
   * Verify Ninja RMM data appears in device details

3. **Test Queries**
   * Create a test query to filter devices with Ninja RMM data
   * Verify the device list matches your Ninja RMM inventory

## Troubleshooting

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

    **Solutions**:

    * Verify the **API ID** and **API Secret** are correct
    * Ensure the API key hasn't expired in Ninja RMM
    * Check that you copied the entire ID and Secret without extra spaces
    * Regenerate API credentials if needed
  </Accordion>

  <Accordion title="Wrong API Subdomain" icon="ban">
    **Symptoms**: Connection fails or times out

    **Solutions**:

    * Verify the correct API subdomain for your region
    * Check if you are on an EU tenant (use `eu-api`)
    * Contact Ninja RMM support to confirm your region
    * Try the alternate subdomain if unsure
  </Accordion>

  <Accordion title="No Data After 10 Minutes" icon="database">
    **Symptoms**: Integration shows active but no device data appears

    **Solutions**:

    * Wait up to 10 minutes for initial data sync
    * Verify there are managed devices in your Ninja RMM account
    * Check API user permissions in Ninja RMM
    * Review integration logs in ThreatAware (contact support if needed)
  </Accordion>

  <Accordion title="Access Denied" icon="shield-exclamation">
    **Symptoms**: Integration connects but shows permission errors

    **Solutions**:

    * Ensure the user account used to generate API credentials is an administrator
    * Regenerate API credentials with proper admin permissions
    * Contact Ninja RMM support to verify account permissions
  </Accordion>
</AccordionGroup>

## Additional resources

<CardGroup cols={2}>
  <Card title="Ninja RMM Documentation" icon="book" href="https://www.nimbledata.com/">
    Official Ninja RMM documentation
  </Card>

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

## Best practices

<Tip>
  **Security Considerations**

  * Store API credentials securely in your password manager
  * Regenerate API keys periodically per your security policy
  * Monitor authentication failures in the integration logs
  * Only grant administrator permissions to the API account if necessary
</Tip>

<Tip>
  **Integration Management**

  * Test the connection immediately after setup
  * Verify device data is syncing as expected
  * Check the integration status regularly
  * Document your API subdomain for future reference
</Tip>