Device Integration: Armis Centrix

Modified on Sun, 12 Apr at 10:47 PM


Table of Contents


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:

  1. Log in to the Armis Central Manager using an administrator account.

  2. Navigate to:
    Settings → Advanced → API Keys

  3. Click Create New API Key to generate a new key.

  4. Click Copy to copy the generated API key.

  5. 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:

  1. Navigate to:
    Administration → Add On Device

  2. Select Armis Centrix from the device list.

  3. Fill in the required fields as shown below:

Field Mapping

ADR UI FieldValue to Enter
NameAny logical name (e.g., Armis Centrix)
CCE HostValid CCE IP address (or 127.0.0.1)
Username / Access KeyLeave blank
Password / Secret KeyArmis API Key
Config{"host": "https://ip:port"}

Example Config

{"host": "https://10.205.4.51:8080"}


  1. Click Save to complete the integration.


Verification (MSSP Only)

On CCE (Command-Line Verification)

  1. Login to the CCE with the ADR user account.

  2. Run:
    otmdoc -m

  3. Enter the add-on device container:
    otmdoc -s cce-addon-devices

  4. Check scheduled tasks:
    crontab -l

  5. Run the Armis Centrix Python script and review the outputs/logs for any errors.


On ADR GUI Console

  1. Log in to ADR with appropriate administrative rights.

  2. Navigate to SYSTEM.

  3. Check Collection Status.

  4. Go to Logs / Flow Collection Status.

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

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article