--- title: "Armis" slug: "armis" updated: 2025-03-26T16:50:30Z published: 2025-03-26T16:50:30Z canonical: "docs.databee.buzz/armis" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.databee.buzz/llms.txt > Use this file to discover all available pages before exploring further. # Armis Armis, the asset intelligence cybersecurity company ensures that organizations continuously see, protect and manage all critical assets. For detailed information, please refer to the [Armis’s official documentation](https://docs.ic.armis.com/). **Integration Method**: API **Tables**: Detection Finding (2004), Device Inventory Info (5001) The integration supports the following events. | **Event** | **Description** | | --- | --- | | Alerts | Retrieves list of alerts. | | Devices | Retrieves list of devices. | This integration supports the following versions. | Armis Version Supported | v25.0 | | --- | --- | | Armis API version | v1 | ## Prerequisites - The user should have access to the [Armis portal](https://armis.com/) with an account that has the Global Administrator privileges. - The user should have access to the DataBee console. ## Configuration Overview 1. Create an Secret Key. 2. Create [Armis data feed](/user-manual/docs/armis-integration-guide#databee-configuration) in the DataBee console with the required Client credentials. | **DataBee Parameter** | **Armis Parameter** | | --- | --- | | Secret Key | Secret Key | | API URL() | Rest Endpoint URL | ## Armis Configuration 1. Log on to [Armis portal](https://www.armis.com/) with an account that has the Administrator privileges. 2. Click on the **Settings** icon in the top right corner, then select **Asset Management** **&** **Security Settings**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-8sau6gt9.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) 3. Capture the **Instance** for the Rest API Endpoint from the web URL. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-0bgqa02j.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) 4. Click on the **API Management** tab. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-7at1fekp.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) 5. Inside the **Generate Tokens** section, if an API key has not been created, you will see a **Create** button. Click on it to generate a new API key. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-90t97ncv.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) 6. Inside the **Generate Tokens** section, if an API key has already been created, you will see a **Show** button. Click on it to view the API key. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-8d5ayoxq.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) 7. An “API Secret Key” pop-up will appear, allowing you to copy your **API Secret key**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-rgwkaj0e.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) > [!NOTE] > **Note:** > > Copy the API Secret Key, as it will be required for further data source configuration. The Armis API Secret Key does not have an expiration date by default. ## DataBee Configuration 1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-6y4ny3ag.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) 2. Search for **Armis** and click it as shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-xgte53xf.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) 3. Click on the **API Ingest** option for collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-m9p6ay26.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) 4. Enter feed contact information and click **Next**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-opjfsvmq.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) 5. In the configuration page, confirm the following: ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/armismar2025-image-8yhqi789.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A04%3A52Z&se=2026-10-30T13%3A04%3A52Z&sr=c&sp=r&sig=yT8EdPmVj%2BndTQPZ3r8T0UGLtyMAPPloaElDRbyKhB4%3D) - Authorization Method: Token URL Auth - Secret Key: paste Secret Key generated earlier in the Armis portal. - Token URL: replace from your Armis tenant information. - API URL: replace from your Armis tenant information. - Event Types: preselected for all the event types that integration pulls. 6. Click **Submit**. ## Troubleshooting Tips - If you encounter an **Invalid** or **Unauthorized** error, it may be due to incorrect credentials. Please double-check that the Secret Key is entered correctly. To avoid any issues, consider pasting it into a text editor to ensure there are no extra spaces or unexpected characters before reconfiguring the DataBee feed.