Reference: Integration with Insomnia API Client

You can upload a Tanium API Gateway example requests JSON file to the Insomnia API client, configure communications between Insomnia and the Tanium ServerTanium Cloud, and submit example requests and receive responses.

Prerequisites

Configure Insomnia to communicate with Tanium

Back up your workspace before importing a JSON file. If you previously imported a Tanium API Gateway example requests JSON file and made updates in the workspace, then import another JSON file into the project, it might overwrite your workspace changes.

  1. In the Insomnia client, select Insomnia > Create new project.

  2. Enter a project name, then click Create.

  3. Select Insomnia > All projects > new_project_name to change to the new project.
  4. Select Create > Import from File.

  5. Select the Tanium API Gateway Insomnia example requests file, then click Import. Confirm that the import succeeded.

    If you previously imported a Tanium API Gateway Insomnia example requests file into a project, the import might overwrite your existing workspace.

  6. Click Tanium API Gateway example requests.

  7. Select Tanium API Gateway > Manage Environments.

  8. Select Base Environment.

  9. Update the url value to the Tanium Module Server URL.

  10. Update the url value to https://<customerName>-api.cloud.tanium.com, replacing <customerName> with your Tanium Cloud instance domain name.

  11. Update the api_token value to the API token string associated with your integration user. Click Done.

Verify integration

  1. In the Insomnia client, expand General examples and then click Time. Verify that the request path is POST _.url_.path.

  2. Click Header and verify that the session header is set to the _.api_token variable, and that the Content-Type header is set to application/json.

  3. Click Send. The API Gateway service responds with the current system time, such as the following:

    Copy
    {
      "data": {
        "now": "2021-11-08T19:22:03Z"
      }
    }