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

# Atera

> Connect ThreatAware to Atera to track managed devices and security status

## Overview

The Atera integration enables ThreatAware to collect read-only data from your Atera platform, providing visibility into managed devices, security configurations, and customer information.

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

## Data collected

The Atera integration provides:

* Managed device inventory
* Device security status
* Customer account information
* Integration metadata

## Use cases

<CardGroup cols={2}>
  <Card title="Device Inventory" icon="shield-halved">
    Monitor all devices managed through Atera
  </Card>

  <Card title="Security Status" icon="clipboard-check">
    Track security configurations across managed systems
  </Card>

  <Card title="Account Visibility" icon="eye">
    Understand customer distribution and device allocation
  </Card>

  <Card title="Compliance Tracking" icon="file-contract">
    Generate reports on managed device coverage
  </Card>
</CardGroup>

## Setup instructions

<Steps>
  <Step title="Log in to Atera Dashboard">
    Access your [Atera dashboard](https://dashboard.atera.com) with an administrator account that has permissions to generate API keys.
  </Step>

  <Step title="Generate API Key">
    Navigate to **Admin** > **API** in the settings.

    * Click **Generate API Key** and copy the key displayed.
    * Store this key securely for use in ThreatAware.

    <Tip>
      Note: Ensure your account has administrator privileges to generate API keys.
    </Tip>
  </Step>

  <Step title="Retrieve Customer ID">
    Open the [Atera API Documentation](https://app.atera.com/apidocs).

    * Under the **Customer** section, locate the **GET /api/v3/customers** endpoint.
    * Use this endpoint to retrieve customer information.
    * Copy the **Customer ID** for the account you are integrating.
  </Step>

  <Step title="Configure in ThreatAware">
    Complete the integration setup in ThreatAware:

    * Navigate to **Settings** > **Integrations**
    * Search for and select **Atera**
    * Enter the required credentials:
      * **API Key**: The API key generated in Atera
      * **Customer ID**: The customer ID retrieved from the API
    * Click **Connect** to establish the integration
  </Step>

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

    * Check that the **Integration Status** shows as **Active**
    * Confirm that device data is appearing in ThreatAware
  </Step>
</Steps>

## Required credentials

<AccordionGroup>
  <Accordion title="API Key" icon="key">
    **Field Name**: Atera API Key
    **Type**: Password (encrypted)
    **Description**: The API key generated in Atera's API settings

    <Tip>
      Keep this credential secure. The API key allows access to customer data in Atera.
    </Tip>
  </Accordion>

  <Accordion title="Customer ID" icon="identification-card">
    **Field Name**: Atera Customer ID
    **Type**: String
    **Description**: The unique identifier for your customer account in Atera

    This ID is retrieved using the Atera API GET request for customers.
  </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 Atera integration shows **Active** status
   * Check the last sync timestamp

2. **Verify Data Collection**
   * Wait 5-10 minutes for the initial data sync
   * Search for a known device in ThreatAware
   * Confirm Atera device data is visible

3. **Test Queries**
   * Create a test query to filter devices from Atera
   * Verify the data matches your expectations

## Troubleshooting

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

    **Solutions**:

    * Verify the **API Key** is exactly as displayed in Atera (no extra spaces)
    * Ensure the API key has not expired
    * Regenerate a new API key in Atera if the current one is suspect
    * Confirm your Atera account has administrator privileges
  </Accordion>

  <Accordion title="Customer ID Not Found" icon="ban">
    **Symptoms**: Integration connects but fails to retrieve data

    **Solutions**:

    * Verify the **Customer ID** is correct using the Atera API
    * Ensure the customer account is active in Atera
    * Check that the API key has access to the specified customer
    * Review the [Atera API Documentation](https://app.atera.com/apidocs) for customer endpoint details
  </Accordion>

  <Accordion title="Connection Timeout" icon="clock">
    **Symptoms**: Integration fails to connect or times out

    **Solutions**:

    * Verify your Atera account is accessible and online
    * Check firewall rules allow outbound HTTPS (443) to Atera
    * Test the Atera dashboard URL in a browser to ensure connectivity
    * Contact Atera support if their platform is experiencing issues
  </Accordion>

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

    **Solutions**:

    * Verify you have devices managed in Atera under your customer account
    * Confirm the API key has read permissions to device data
    * Wait up to 15 minutes for the initial sync to complete
    * Check that the Customer ID corresponds to an active customer with managed devices
  </Accordion>
</AccordionGroup>

## Additional resources

<CardGroup cols={2}>
  <Card title="Atera API Documentation" icon="book" href="https://app.atera.com/apidocs">
    Official Atera API documentation for detailed permissions and configuration
  </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**

  * Store your API key securely in your organisation's password manager
  * Rotate API keys annually or per your security policy
  * Monitor integration logs in ThreatAware for authentication failures
  * Document the Customer ID for future reference
</Tip>

<Tip>
  **Security Considerations**

  * API keys provide access to your Atera account data
  * Only share API keys with authorised personnel
  * Review your Atera API activity logs periodically
  * Regenerate API keys if they are exposed or compromised
</Tip>