Tanium System Status
  • 4 Minutes To Read
  • Print
  • Share
  • Dark
    Light

Tanium System Status

  • Print
  • Share
  • Dark
    Light

The Tanium System Status adapter provides an inventory of all clients that have registered with the Tanium platform.

Parameters

  1. Hostname or IP Address (required) - The Hostname or IP address of the Tanium server that Axonius can communicate with via the Required Ports.
  2. User Name and Password (required) - The credentials for a user account that has the Required Permissions to fetch assets.
  3. Only fetch clients that have registered in the past N minutes (optional, default: empty) - Only fetch assets that have registered with the Tanium platform within the past minutes supplied by this value. Tanium considers any agent that has not reported in the past 5 minutes as "broken", however leave this value empty if you want to be able to build queries in Axonius that check for "broken agents".
  4. Verify SSL (required, default: False) - Verify the SSL certificate offered by the value supplied in Hostname or IP Address. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the value supplied in Hostname or IP Address will be verified against the CA database inside of Axonius. If the SSL certificate can not be validated against the CA database inside of Axonius, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the value supplied in Hostname or IP Address will not be verified against the CA database inside of Axonius.
  5. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in Hostname or IP Address.
    • If supplied, Axonius will utilize the proxy when connecting to the value supplied in Hostname or IP Address.
    • If not supplied, Axonius will connect directly to the value supplied in Hostname or IP Address.
  6. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

tanium_system_status_new_cnx

Advanced Settings

The Tanium System Status adapter has advanced settings which control the logic for fetching assets.

  1. Number of assets to fetch per page (required, default: 1000) - Control the number of assets that are fetched per page.
  2. Number of seconds to wait in between each page fetch (required, default: 10) - Control the number of seconds to wait in between each page.
NOTE

For details on general advanced settings under the Adapter Configuration tab, see Adapter Advanced Settings.

Required Ports

Axonius must be able to communicate with the value supplied in Hostname or IP Address via the following ports:

  • TCP port 443: REST API

Required Permissions

Required Micro Admin Permissions

You must Create a Micro Admin Role since none exists that grants these Micro Admin Permissions:

  1. Read System Status

Create a Micro Admin Role

These are the steps to create a role that grant the Required Micro Admin Permissions:

  1. Log in to the value supplied in Hostname or IP Address with an account that has the permissions necessary to edit roles.
  2. In the navigation menu:
    1. Go to the Permissions > Roles page.
  3. In the Permissions Page:
    1. Click New Role.
    2. Select Grant Micro Admin Role.
  4. In the Create Role page in the Role Details section:
    1. Fill in the Name field. (for example: System Status Read Only)
  5. In the Create Role page In the Micro Admin Permissions section click the plus sign next to the following permissions:
    1. Read System Status
  6. The Create Role page should look like:
    image.png
  7. At the bottom of the Create Role page:
    1. Click Save.
  8. In the Notice dialog window:
    1. Click Continue.

Assigning Required Permissions

These are the steps to assign the Required Permissions to the value supplied in User Name:

  1. Log in to the value supplied in Hostname or IP Address with an account that has the permissions necessary to edit users.
  2. In the navigation menu:
    1. Go to the Administration > Users page.
  3. In the Users Page:
    1. Select the value supplied in User Name from the list of users.
    2. Click View User.
  4. In the User Administration page in the Roles and Effective Permissions section:
    1. Click Edit Roles.
  5. In the Assign Roles page in the Role Management > Grant Roles section:
    1. Click Edit.
  6. In the Edit Grant Roles dialog window:
    1. Select the name of the role created in Create Micro Admin Role.
    2. Click Save.
  7. In the Assign Roles page:
    1. Click Show Preview to Continue.
    2. Click Save.
  8. In the Notice dialog window:
    1. Click Continue.
  9. The User Administration page should look like this:
    tanium_useradmin_status
  10. Perform the steps in Verifying Permissions

Verifying Permissions

  1. Log in to the value supplied in Hostname or IP Address with the values supplied in User Name and Password.
  2. In the navigation menu:
    1. Go to the Administration > System Status page.

Field Mappings

The following tables show how values are mapped to fields in Axonius.

Aggregated Fields

Source Destination
asset: computer_id UUID
asset: computer_id, asset: hostname ID
asset: full_version Agent Versions
asset: hostname Hostname
asset: ipaddress_client Network Interfaces: IPs
asset: last_registration Last Seen

Adapter Specific Fields

Source Destination
asset: computer_id Agent Computer ID
asset: ipaddress_client Agent IP Address Client
asset: ipaddress_server Agent IP Address Server
asset: last_registration Agent Last Registration
asset: port_number Agent Port Number
asset: protocol_version Agent Protocol Version
asset: public_key_valid Agent Public Key Valid
asset: receive_state Agent Receive State
asset: registered_with_tls Agent Using TLS
asset: send_state Agent Send State
asset: status Agent Status
Tanium Server Tanium Server Name, Tanium Server Version, Installed Modules

Version Matrix

This adapter has only been tested with the versions marked as supported, but may work with other versions. Please contact Axonius Support if you have a version that is not listed and it is not functioning as expected.

Version Supported Notes
Tanium versions prior to 7.3.314.3424 No This adapter utilizes the REST API, which was added in Tanium 7.3.314.3424
Tanium 7.3.314.3424 Yes
Tanium 7.3.314.3668 Yes
Tanium 7.3.314.4147 Yes
Tanium 7.3.314.4250 Yes
Was This Article Helpful?