Armis Authentication Guide

How to authenticate Armis for use with Tines

Daniel Stoeski avatar
Written by Daniel Stoeski
Updated over a week ago

The Armis Asset Intelligence Platform discovers and analyzes all enterprise digital assets—hardware, software, cloud or virtual--from traditional devices like laptops and smartphones to cloud workloads and new unmanaged IoT devices like smart TVs, webcams, printers, HVAC systems, Industrial Control Systems, medical devices and more. Armis discovers all asset types, provides context about them (owner, location, dependencies, vulnerabilities) and continuously analyzes their behavior to identify both operational and cyber risks to protect them against cyber attacks.

First, get a Armis API Secret Key

  1. Login to your Armis account at https://<tenant>.armis.com/login

  2. Click "Settings" and then "API Management"


  3. Click "Create"


  4. Copy your "API Secret Key" to a text editor and click "OK"



Lastly, create Armis credentials in Tines

You will need to create two credentials:

  • One Text type: "Armis API Secret Key"

  • One HTTP request type: "Armis Access Token"

  1. Login to your Tines tenant

  2. Navigate to the team that will be using the API and click "Credentials"

  3. Click "+ New Credential" and select "Text"

  4. Input the values for the Armis credential

    1. Name: Armis API Secret Key

    2. Description: Optional

    3. Value: Your API Secret Key

  5. Optional

    1. Domains: Ensure this credential can only be used when making HTTP requests to specific domains.

    2. Access: What other teams can also use the API

  6. Click "Save"

  7. Click "+ New Credential" and select "HTTP Request"

  8. Input the values for the Armis credential

    1. Name: Armis Access Token

    2. Description: Optional

    3. URL: https://<tenant>.armis.com/api/v1/access_token/

    4. Content Type: Form

    5. Method: post

    6. Payload: Copy the below object and paste it into the "Plain code" section:

      {
      "secret_key":"<<CREDENTIAL.armis_api_secret_key>>"
      }

    7. Click "Run options", navigate to the access_token key and double-click on the key

    8. Location of token from response: Paste the path to the token in the value pill, i.e. armis_access_token.body.data.access_token

  9. Optional

    1. Domains: Ensure this credential can only be used when making HTTP requests to specific domains

    2. Access: What other teams can also use the API

  10. Click "Save"

Your credential should look like the following:

For more on creating credentials in Tines, click here.

You can find a selection of Armis stories in the story library

Did this answer your question?