Skip to main content

​
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.
Connection Method: API Credentials Setup Time: 15 minutes Access Required: Addigy Administrator account

​
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

Mac Device Management

Monitor Mac devices managed by Addigy

Security Compliance

Verify Mac devices meet security compliance requirements

Device Inventory

Maintain complete visibility into managed Mac devices

Policy Enforcement

Track policy compliance across your Mac fleet

​
Setup instructions

1

Log in to Addigy Account

Access your Addigy account with an administrator role.
2

Navigate to API Settings

Access API token generation:
  • Go to Settings > Integrations > API Tokens
  • You should see the API Tokens management page
3

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
For security best practices, create a token specifically for ThreatAware rather than using a general-purpose token.
4

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
5

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
6

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

​
Required credentials

Field Name: Addigy Client ID Type: String Description: The unique identifier generated by Addigy for your API tokenThis ID is used to identify your integration with Addigy and must be kept confidential.
Field Name: Addigy Client Secret Type: Password (encrypted) Description: The secret key associated with your Addigy API tokenStore this credential securely in your organisation’s password manager. This secret is only displayed once during token generation.

​
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

Symptoms: Integration status shows authentication failureSolutions:
  • 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
Symptoms: Integration connects but no device data appearsSolutions:
  • 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 for permission requirements
  • Regenerate the token with appropriate permissions if needed
Symptoms: Integration fails to connect or times outSolutions:
  • 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
Symptoms: Integration shows active but no device data appearsSolutions:
  • 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

​
Additional resources

Addigy API Documentation

Official Addigy API documentation for detailed reference

ThreatAware Support

Contact ThreatAware support for integration assistance

​
Best practices

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