Customizing the Console and Interact

You can customize the appearance and behavior of the Tanium Console and Interact Overview page.

Select the Console color

In deployments with multiple environments (such as lab environments, test environments, and production environments), customizing the top border color of the Tanium Console Main menu (header) can help users identify which environment they are signed into for the current session. The following figure shows an example of a custom color.

Figure 1: Tanium Console Main menu color

Users require the Administrator reserved role to manage the console color.

In an active-active deployment, the Tanium Console instances for both Tanium Servers use the same color configuration. You cannot specify a different color for each server.

From the Main menu, go to Administration > Configuration > Appearance.
In the Console Color section, use the Current Color selector to pick your custom color.
Click Submit, wait about two minutes for the change to apply, and then refresh your web browser to confirm that the new color appears as expected.

Configure Console header text

By default, the Tanium Console Main menu (header) displays no text above the version fields. In deployments with multiple environments (such as lab environments, test environments, and production environments), adding text can help users identify which environment they are signed into for the current console session. The following figure shows an example that identifies a Production Environment:

Users require the Administrator reserved role to manage the Main menu text.

In an active-active deployment, the Tanium Console instances for both Tanium Servers use the same text configuration. You cannot specify different text for each server.

Perform the following steps to add, edit, or remove the Main menu text:

From the Main menu, go to Administration > Configuration > Appearance.
In the Console Header Text section, enter the new text in the Header Text field.
If you want to revert to the default (no text), click Reset.
Click Submit, wait about two minutes for the change to apply, and then refresh your web browser to confirm that the text appears as expected.

Select the task confirmation prompt

Many tasks that users initiate in the Tanium Console require responding to a confirmation prompt before the tasks proceed. Select the prompt type based on whether you want to optimize Tanium Console security (password prompt) or the user experience (yes/cancel prompt).

Only users assigned the Administrator reserved role can manage the confirmation prompt.

If you enable Security Assertion Markup Language (SAML) single sign-on, the Tanium Server automatically changes the prompt to a Yes/Cancel prompt. For details, see Integrating with LDAP servers.

From the Main menu, go to Administration > Configuration > Appearance.
In the Choose which type of Confirmation Prompt to display section, select Show a password prompt or Show a Yes/Cancel prompt, and then click Submit.

Customize the Console help URL

By default, clicking the Help link in the Main menu opens a new browser tab or window with the URL https://docs.tanium.com. In deployments where that URL is inaccessible (for example, if the Tanium Server does not have Internet access), you can change the help URL.

Users require the Administrator reserved role to manage the console help URL.

From the Main menu, go to Administration > Configuration > Appearance.
In the Help URL section, enter the new URL in the Help URL field.
If you want to revert to the original, default help URL, click Reset.
Click Submit, wait about two minutes for the change to apply, and refresh your web browser.
Click the Help link to verify that it opens the new URL.

Customize the Console logo

You can replace the default Tanium logo in the Main menu (header) and login page of the Tanium Console with the logo of your organization. The Tanium Console supports all the standard image formats that your browser supports, such as PNG, JPG, and SVG. The maximum file size is 2 MB. You can also adjust the logo height, which is 24 pixels by default. The Tanium Console automatically scales the logo width proportionately.

Users require the Administrator reserved role to manage the console logo.

Create your own logo file if you want to replace the Tanium logo.
From the Main menu, go to Administration > Configuration > Appearance.
(New logo only) In the Console Logo section, click Upload, select the logo file, and click Open.
If you want to revert to the original, default logo, click Reset.
(Optional): In the Logo height field, specify the logo height in pixels.
Click Submit, wait about two minutes for the change to apply, and then refresh your web browser to confirm the updated logo appears as expected.

Set Console user preferences

User preferences control certain behaviors of the Tanium Console on a per-user basis. Changes that you make to your settings affect all the personas that are assigned to your account, but do not affect other users. TaaSThe Tanium Server applies the preferences of a user when that user signs in to the console. The Tanium Console filters the settings on the Edit Preferences page based on the effective permissions of the user (persona) who accesses the page.

In the Main menu, expand the <user name> drop-down menu and select Preferences.
Configure the following settings and click Save. The changes apply immediately.

Table 1: User preferences
Settings	Guidelines
Consider question results complete at	Tanium Console pages that display results from Tanium Clients (such as the Question Results and Action Status pages) indicate that all clients have responded when the number of registered clients that responded reaches the specified threshold (default is 99%). TaaSThe Tanium Server calculates the number of registered clients based on when it initiated the operation, such as when it issued a question or deployed an action. However, the actual number of registered clients might fluctuate during the period between the initiation and timeout of the operation. For example, several end users might close their laptops soon after a question is issued and before it times out (default 10 minutes). For cases where the calculated and actual numbers of registered clients might never match, setting the value at less than 100% prevents console users from waiting indefinitely for an indication that all clients have answered. A user role with Saved Question read permission or Ask Dynamic Questions permission is required to see and configure this setting.
Suspend console automatically if no activity detected for	By default, the Tanium Console automatically ends a user session and displays the sign-in page if the user performs no activity on the console for 10 minutes. The value must be equal to or less than the timeout that your administrator set for all users through the max_console_idle_seconds setting (Administration > Configuration > Platform Settings). The platform setting has a default of 3,600 seconds (1 hour). If you set the user preference to a lower value than the platform setting, TaaSthe Tanium Server applies the user preference. By default, the Tanium Console displays a warning 60 seconds before the activity timeout to give users a chance to preserve their current session. To display the warning sooner or later, set the console_idle_warning_seconds setting (Administration > Configuration > Platform Settings). For details about how other events and platform settings affect the duration of a user session, see Sign in to the Console. Note that initiating a solution import or update operation suspends the inactivity timer. The timer resets to zero and resumes at the moment the operation finishes.
Hide error results from questions	Enabled by default. Select this option if you want the Questions Results grid to omit null or error values, such as [no results] or [results currently unavailable]. This option provides clarity in that the grid shows only the answers that are likely to be useful. However, this option also prevents the grid from showing the complete set of answers received from all endpoints. A user role with Saved Question read permission or Ask Dynamic Questions permission is required to see and configure this setting.
Theme	Select the user interface color scheme that is most comfortable for you when using the Tanium Console and Tanium solution workbenches: Light: Pages have a white background and dark text. Dark: Pages have a dark background and white text. Not all versions of Tanium solutions support the Dark theme.

Table 2: User preferences
Settings	Guidelines
Consider question results complete at	Tanium Console pages that display results from Tanium Clients (such as the Question Results and Action Status pages) indicate that all clients have responded when the number of registered clients that responded reaches the specified threshold (default is 99%). TaaSThe Tanium Server calculates the number of registered clients based on when it initiated the operation, such as when it issued a question or deployed an action. However, the actual number of registered clients might fluctuate during the period between the initiation and timeout of the operation. For example, several end users might close their laptops soon after a question is issued and before it times out (default 10 minutes). For cases where the calculated and actual numbers of registered clients might never match, setting the value at less than 100% prevents console users from waiting indefinitely for an indication that all clients have answered. A user role with Saved Question read permission or Ask Dynamic Questions permission is required to see and configure this setting.
Suspend console automatically if no activity detected for	By default, the Tanium Console automatically ends a user session and displays the sign-in page if the user performs no activity on the console for 10 minutes. The value must be equal to or less than the timeout that your administrator set for all users through the max_console_idle_seconds setting (Administration > Configuration > Platform Settings). The platform setting has a default of 3,600 seconds (1 hour). If you set the user preference to a lower value than the platform setting, TaaSthe Tanium Server applies the user preference. By default, the Tanium Console displays a warning 60 seconds before the activity timeout to give users a chance to preserve their current session. To display the warning sooner or later, set the console_idle_warning_seconds setting (Administration > Configuration > Platform Settings). For details about how other events and platform settings affect the duration of a user session, see Sign in to the Console. Note that initiating a solution import or update operation suspends the inactivity timer. The timer resets to zero and resumes at the moment the operation finishes.
Submit filter text after	Ignore this setting.
Hide error results from questions	Enabled by default. Select this option if you want the Questions Results grid to omit null or error values, such as [no results] or [results currently unavailable]. This option provides clarity in that the grid shows only the answers that are likely to be useful. However, this option also prevents the grid from showing the complete set of answers received from all endpoints. A user role with Saved Question read permission or Ask Dynamic Questions permission is required to see and configure this setting.
Language	Select a language for text that appears in the Tanium Console. The default is the language that is selected for the browser that you use to access the console.
Interface Theme	Select the user interface color scheme that is most comfortable for you when using the Tanium Console and Tanium solution workbenches: Default: Pages have a white background and dark text. Dark: Pages have a dark background and white text. Not all versions of Tanium solutions support the Dark interface theme.
Trusted Auth Origins	(Salesforce deployment only) This field specifies the domains in your Salesforce Information Technology Service Management (ITSM) instance from which users can authenticate to access the Tanium Console. If the domain names change, enter the new names as a comma-separated list.

Customize module overview pages

Each Tanium module has an Overview page that appears when you navigate to the module. Overview pages are organized into sections such as guidance on getting started, reports related to module health, or reports related to deployment metrics. If you show, hide, or reorder sections of a module Overview page, your changes apply across all the personas that are assigned to your user account. The following steps also apply to customizing the Tanium Home page .

View the content on a module Overview page. From the Main menu, select Modules > <module name>.
- By default, all the page sections are expanded so that their contents are visible. You can toggle between collapsing and expanding a page section.
- Click Hide within any section that you do not want the page to show.
  
  The following steps describe how to reverse this change if necessary.
To customize the Overview page, click Customize Page.
1. Select the sections that you want to display.
2. Click and drag the sections to change the order in which they appear, and then click Save.

The Tanium Home page and Interact Overview page display categories, dashboards, and saved questions that you selected as favorites. To change the favorites, see Filter by favorites.