API Gateway requirements

Review the requirements before you install and use API Gateway.

Core platform dependencies

Make sure that your environment meets the following requirements:

  • Tanium™ Core Platform servers: 7.4.4 or later

  • Tanium™ Client: No client requirements.
  • Tanium™ Console: 2.0 or later
  • Tanium contentAPI Gateway uses sensors that are included in the Core Content and Core AD Query content packs.

Solution dependencies

Other Tanium solutions are required for API Gateway to function (required dependencies) or for specific API Gateway features to work (feature-specific dependencies). The installation method that you select determines if the Tanium Server automatically imports dependencies or if you must manually import them.

Some API Gateway dependencies have their own dependencies, which you can see by clicking the links in the lists of Required dependencies and Feature-specific dependencies. Note that the links open the user guides for the latest version of each solution, not necessarily the minimum version that API Gateway requires.

Tanium recommended installation

If you select Tanium Recommended Installation when you import API Gateway, the Tanium Server automatically imports all your licensed solutions at the same time. See Tanium Console User Guide: Import all modules and services.

Import specific solutions

If you select only API Gateway to import and are using Tanium Core Platform 7.5.2.3531 with Tanium Console 3.0.72 or later, the Tanium Server automatically imports the latest available versions of any required dependencies that are missing. If some required dependencies are already imported but their versions are earlier than the minimum required for API Gateway, the server automatically updates those dependencies to the latest available versions.

If you select only API Gateway to import and you are using Tanium Core Platform 7.5.2.3503 or earlier with Tanium Console 3.0.64 or earlier, you must manually import or update required dependencies. See Tanium Console User Guide: Import, re-import, or update specific solutions.

Required dependencies

API Gateway has the following required dependencies at the specified minimum versions:

  • Tanium Interact 2.9.83 or later
  • Tanium System User 1.0.40 or later

Feature-specific dependencies

If you select only API Gateway to import, you must manually import or update its feature-specific dependencies regardless of the Tanium Console or Tanium Core Platform versions. API Gateway has the following feature-specific dependencies at the specified minimum versions:

Tanium™ Module Server

API Gateway is installed and runs as a service on the Module Server host computer. The impact on the Module Server is minimal and depends on usage.

For information about Module Server sizing in a Windows deployment, see Tanium Core Platform Deployment Guide for Windows: Host system sizing guidelines.

Endpoints

API Gateway does not directly deploy packages to endpoints. However, you can use API Gateway to deploy packages through Tanium Deploy. For Tanium Deploy endpoint requirements, see Tanium Deploy User Guide: Endpoints.

For Tanium Client operating system support, see Tanium Client Management User Guide: Client version and host system requirements.

Host and network security requirements

Specific ports and processes are needed to run API Gateway.

Ports

The following ports are required for API Gateway communication.

Source Destination Port Protocol Purpose
Module Server Tanium Cloud Module Server (loopback) 17600 TCP Internal purposes, not externally accessible

Configure firewall policies to open ports for Tanium traffic with TCP-based rules instead of application identity-based rules. For example, on a Palo Alto Networks firewall, configure the rules with service objects or service groups instead of application objects or application groups.

For Tanium Cloud ports, see Tanium Cloud Deployment Guide: Host and network security requirements.

Security exclusions

If security software is in use in the environment to monitor and block unknown host system processes, Tanium recommends that a security administrator create exclusions to allow the Tanium processes to run without interference. The configuration of these exclusions varies depending on AV software. For a list of all security exclusions to define across Tanium, see Tanium Core Platform Deployment Reference Guide: Host system security exclusions.

API Gateway security exclusions
Target Device Notes Exclusion Type Exclusion
Module Server   Process <Module Server>\services\gateway-service\TaniumGatewayService.exe

No additional process exclusions are required.

User role requirements

The following tables list the role permissions required to use API Gateway. For more information about role permissions and associated content sets, see Tanium Console User Guide: Managing RBAC.

API Gateway user role permissions
Permission API Gateway User1

Gateway Api

Access API Gateway



EXECUTE

1 This role provides module permissions for Tanium Interact. You can view which Interact permissions are granted to this role in the Tanium Console. For more information, see Tanium Interact User Guide: User role requirements.

API Gateway user role permissions
Permission API Gateway User1 Gateway Service Account Gateway Service Account - All Content Sets

Gateway Api

Access API Gateway


EXECUTE

Gateway Service Account

Provides access for the API Gateway service.


EXECUTE

1 This role provides module permissions for Tanium Interact. You can view which Interact permissions are granted to this role in the Tanium Console. For more information, see Tanium Interact User Guide: User role requirements.


Provided API Gateway administration and platform content permissions
Permission Permission Type API Gateway User
Token - Use Administration
SPECIAL
Plugin Platform Content
EXECUTE1
READ1

1 Grants access to content in the Interact content set.

Provided API Gateway administration and platform content permissions
Permission Permission Type API Gateway User Gateway Service Account Gateway Service Account - All Content Sets
Action Group Administration
READ
WRITE
Computer Group Administration
READ
Global Settings Administration
READ
Sensor Platform Content
READ1
Token - Use Administration
SPECIAL
Plugin Platform Content
EXECUTE2
READ2

1 This permission applies to all content sets.

2 This permission applies to the Interact content set.