Skip to main content

Tanium

Visualize Tanium assets, users, and evaluations in JupiterOne, and monitor changes through queries and alerts.

Installation​

To set up this integration, you need access to the Administration module in Tanium to create API tokens.

An API token has the permissions of the user or persona that created it. That user or persona needs:

  • The API Gateway User role, for access to the API Gateway GraphQL endpoint.
  • The Asset Report Reader role (Asset Report Read), for endpoints and applications, which come from Tanium Asset.
  • Sensor Read on the content sets that hold the installed applications, installed patches and applicable patches sensors.
  • User Read, to ingest Tanium users.
  • Management rights on the computer groups you want to ingest. Endpoints outside those computer groups are not returned.

Your Tanium environment must also have the latest API Gateway solution imported, since several steps query Tanium's API Gateway GraphQL endpoint.

Configuration in Tanium​

Before setting up the integration instance in JupiterOne, generate your Tanium API token:

  1. In your Tanium console, from the top bar, navigate to Administration > Permissions > API Tokens.
  2. Click New API Token.
  3. Set the desired number of days until your token expires.
  4. If you are running the integration in JupiterOne, add the following IPs to the token's Trusted IP list based on your region:
    • Running in US Region:
      • 18.219.33.157/0
      • 18.218.86.86/0
      • 52.14.136.234/0
    • Running in Cisco US Region:
      • 34.233.148.77/0
      • 44.199.84.191/0
      • 52.21.5.206/0
    • Running in EU Region:
      • 3.67.240.226/0
      • 52.28.3.30/0
      • 3.121.249.173/0
  5. Copy your API token for use in JupiterOne.

Once you have generated your API token, retain the value and have it ready when configuring the integration within JupiterOne.

For more detail on creating API tokens, see Tanium's API Tokens documentation.

Configuration in JupiterOne​

To install the Tanium integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Tanium. Click New Instance to begin configuring your integration.

Creating an instance requires the following:

  • The Account Name used to identify the Tanium account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the AccountName toggle is enabled.

  • A Description to assist in identifying the integration instance, if desired.

  • A Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

  • Your Tanium API Token.

  • Your Base URL, the base URL for your Tanium instance's API. The endpoint will look like https://<customer-name>-api.cloud.tanium.com.

Click Create once all values are provided to finalize the integration.

Next steps​

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.