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

# Addigy

> Connect ThreatAware to Addigy to monitor Mac device management and security

## Overview

The Addigy integration enables ThreatAware to collect read-only data from your Addigy console, providing visibility into Mac device inventory, management status, and security posture across your organisation.

<Info>
  **Connection Method**: API Credentials
  **Setup Time**: 15 minutes
  **Access Required**: Addigy Administrator account
</Info>

## Data collected

The Addigy integration provides:

* Mac device inventory and management status
* Security and compliance information
* Device configuration and update status
* Policy enforcement and compliance metrics

## Use cases

<CardGroup cols={2}>
  <Card title="Mac Device Management" icon="apple">
    Monitor Mac devices managed by Addigy
  </Card>

  <Card title="Security Compliance" icon="shield-check">
    Verify Mac devices meet security compliance requirements
  </Card>

  <Card title="Device Inventory" icon="database">
    Maintain complete visibility into managed Mac devices
  </Card>

  <Card title="Policy Enforcement" icon="check-circle">
    Track policy compliance across your Mac fleet
  </Card>
</CardGroup>

## Setup instructions

<Steps>
  <Step title="Log in to Addigy Account">
    Access your Addigy account with an administrator role.
  </Step>

  <Step title="Navigate to API Settings">
    Access API token generation:

    * Go to **Settings** > **Integrations** > **API Tokens**
    * You should see the API Tokens management page
  </Step>

  <Step title="Generate New API Token">
    Create an API token for ThreatAware:

    * Click **Generate Token**
    * Provide a descriptive name for the token (e.g., "ThreatAware Integration")
    * The system will generate a **Client ID** and **Client Secret**
    * Note both values immediately - you may not be able to see them again

    <Tip>
      For security best practices, create a token specifically for ThreatAware rather than using a general-purpose token.
    </Tip>
  </Step>

  <Step title="Verify API Permissions">
    Ensure your token has the required permissions:

    * Review the token's assigned permissions in Addigy
    * The token should have permissions needed for ThreatAware's integration
    * If custom permissions are required, consult [Addigy API Documentation](https://addigy.com/docs)
  </Step>

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

    * In ThreatAware, go to **Integrations** and select **Addigy**
    * Paste the **Client ID** into the designated field
    * Paste the **Client Secret** into its corresponding field
    * Click **Connect** to establish the integration
  </Step>

  <Step title="Verify Connection">
    After connecting:

    * Check that the **Integration Status** shows as **Active** in ThreatAware
    * Confirm that Mac device data is appearing in ThreatAware
    * Wait for the first data synchronization cycle to complete
  </Step>
</Steps>

## Required credentials

<AccordionGroup>
  <Accordion title="Client ID" icon="key">
    **Field Name**: Addigy Client ID
    **Type**: String
    **Description**: The unique identifier generated by Addigy for your API token

    This ID is used to identify your integration with Addigy and must be kept confidential.
  </Accordion>

  <Accordion title="Client Secret" icon="lock">
    **Field Name**: Addigy Client Secret
    **Type**: Password (encrypted)
    **Description**: The secret key associated with your Addigy API token

    Store this credential securely in your organisation's password manager. This secret is only displayed once during token generation.
  </Accordion>
</AccordionGroup>

## Verification and testing

After setup, verify the integration is working correctly:

1. **Check Integration Status**
   * Navigate to **Integrations** in ThreatAware
   * Confirm the Addigy integration shows **Active** status
   * Check the last sync timestamp

2. **Verify Data Collection**
   * Wait up to 60 minutes for initial data synchronization
   * Search for known Mac devices in ThreatAware
   * Verify the device information matches your Addigy console

3. **Test Queries**
   * Create a test query to filter Mac devices managed by Addigy
   * Verify device and compliance data is being collected correctly

## Troubleshooting

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

    **Solutions**:

    * Verify both the **Client ID** and **Client Secret** are correctly entered
    * Ensure neither credential has extra spaces or was truncated
    * Confirm the credentials match the token generated in your Addigy account
    * Check if the API token has been revoked or expired in Addigy
    * Regenerate a new API token if the original is suspect or lost
  </Accordion>

  <Accordion title="Permission Errors" icon="ban">
    **Symptoms**: Integration connects but no device data appears

    **Solutions**:

    * Verify the API token has the correct permissions in Addigy
    * Check that your Addigy account has Mac devices to manage
    * Ensure the token's scope includes access to necessary resources
    * Review [Addigy API Documentation](https://addigy.com/docs) for permission requirements
    * Regenerate the token with appropriate permissions if needed
  </Accordion>

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

    **Solutions**:

    * Verify the Addigy console is accessible and operational
    * Check firewall rules allow outbound HTTPS (443) to Addigy's API endpoints
    * Confirm your network connectivity is stable
    * Test accessing your Addigy console directly in a browser
    * Check Addigy service status for any ongoing issues
  </Accordion>

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

    **Solutions**:

    * Verify there are Mac devices managed by Addigy in your environment
    * Check that the API token has not been revoked or rotated
    * Confirm the token still has appropriate permissions
    * Wait for the next sync cycle (typically hourly)
    * Review ThreatAware integration logs for error messages
  </Accordion>
</AccordionGroup>

## Additional resources

<CardGroup cols={2}>
  <Card title="Addigy API Documentation" icon="book" href="https://addigy.com/docs">
    Official Addigy API documentation for detailed reference
  </Card>

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

## Best practices

<Tip>
  **Token Management**

  * Create a dedicated API token specifically for ThreatAware (don't reuse existing tokens)
  * Store your Client ID and Client Secret securely in your password manager
  * Document when the token was created and which admin created it
  * Set reminders to review token expiration policies
  * Periodically rotate tokens per your organisation's security policy
</Tip>

<Tip>
  **Security Considerations**

  * Only grant the minimum permissions necessary for the API token
  * Limit token scope to only the data you need to monitor
  * Never share API credentials with unauthorized personnel
  * Revoke old tokens when rotating to new ones
  * Monitor ThreatAware's API usage in your Addigy audit logs
</Tip>