Table of Contents
- Overview
- Pre-requisites
- Required Credentials
- Required User Roles (Armis Centrix)
- Steps to Generate API Key (Armis Centrix)
- ADR Configuration Steps
- Verification (MSSP Only)
- Validation & Troubleshooting
- Notes
- Conclusion
Overview
This Knowledge Base Article (KBA) explains the prerequisites, required permissions, and configuration steps to integrate Armis Centrix with the ADR platform.
The integration uses API key–based authentication, where an API key is generated from the Armis Central Manager and configured in ADR for data collection and monitoring.
Pre-requisites
Before configuring the integration, ensure the following:
Active Armis Centrix deployment
Access to Armis Central Manager with Administrator privileges
Ability to generate API keys
Network connectivity from ADR (CCE) to the Armis Centrix API endpoint (
https://ip:port)
Required Credentials
The following details must be collected from the customer:
API Key
Armis Central Manager Host (IP: Port)
Example:
https://10.205.4.51:8080
Required User Roles (Armis Centrix)
The API key must be generated by a user with Administrator privileges in Armis Central Manager to ensure sufficient access for data collection.
Steps to Generate API Key (Armis Centrix)
Follow the steps below to generate an API key from Armis Central Manager:
Log in to the Armis Central Manager using an administrator account.
Navigate to:
Settings → Advanced → API KeysClick Create New API Key to generate a new key.
Click Copy to copy the generated API key.
Save the API key in a secure location for future use.
IMPORTANT
Treat the API key like a password.
Do not share it publicly or store it in unsecured locations.
ADR Configuration Steps
Once the API key is generated, configure Armis Centrix in the ADR UI as follows:
Navigate to:
Administration → Add On DeviceSelect Armis Centrix from the device list.
Fill in the required fields as shown below:
Field Mapping
| ADR UI Field | Value to Enter |
|---|---|
| Name | Any logical name (e.g., Armis Centrix) |
| CCE Host | Valid CCE IP address (or 127.0.0.1) |
| Username / Access Key | Leave blank |
| Password / Secret Key | Armis API Key |
| Config | {"host": "https://ip:port"} |
Example Config
{"host": "https://10.205.4.51:8080"}
Click Save to complete the integration.
Verification (MSSP Only)
On CCE (Command-Line Verification)
Login to the CCE with the ADR user account.
Run:
otmdoc -mEnter the add-on device container:
otmdoc -s cce-addon-devicesCheck scheduled tasks:
crontab -lRun the Armis Centrix Python script and review the outputs/logs for any errors.
On ADR GUI Console
Log in to ADR with appropriate administrative rights.
Navigate to SYSTEM.
Check Collection Status.
Go to Logs / Flow Collection Status.
Verify the Armis Centrix integration status and ensure logs are being ingested successfully.
Validation & Troubleshooting
Ensure the host IP and port are reachable from the ADR CCE.
Verify that the API key was generated using an administrator account.
If logs are not ingesting:
Regenerate the API key
Update the key in ADR
Revalidate network connectivity and API endpoint access
Notes
Rotate API keys periodically as per security best practices.
Do not share API keys over unsecured channels.
Revoke unused or compromised API keys immediately from Armis Central Manager.
Conclusion
Following the above steps ensures a successful and stable integration between Armis Centrix and ADR, enabling continuous visibility into device posture and security events.
For further assistance, contact ADR Support with relevant logs and screenshots.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article