Reference: User Administration menu

The TanOS special users tanadmin, tancopy, tanfactory, and tanuser are not Tanium™ Console users. TanOS access requirements are enforced.

Apart from special users, TanOS hosts a local authentication service that can be used for Tanium Console user authentication. You can create and delete users and manage their passwords.

In addition, you can configure Tanium Console authentication against your enterprise LDAP server. For details on using LDAP, see the Tanium Core Platform User Guide.

Change TanOS user passwords

The TanOS special users tanadmin and tanuser can make password-authenticated SSH connections to the TanOS console.

Change the tanadmin password

  1. Log into the TanOS console as a user with the tanadmin role.

    The TanOS console displays the tanadmin menu.

  2. Enter P and then follow the prompts to change the password.

After the password has been changed, you are logged out.

Reset the tanuser password

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter 1 and then follow the prompts to reset the password.

Reset the tanfactory password

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter 2 and then follow the prompts to reset the password.

Manage SSH keys

The installation process generates a public/private SSH key pair for the tanadmin user. You can use the SSH Key menu to regenerate this pair, generate keys for the other TanOS special users, add authorized keys to support inbound user connections, and display the public key so you can copy and paste it into other appliance configurations as described in some of the installation procedures in this guide.

Before you begin

  • You must have an SSH client to log into the TanOS console and an SFTP client such as WinSCP to copy files to and from the appliance.
  • You must have an SSH key generator such as ssh-keygen to generate keys for the user.

Generate keys

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter 3 to go to the SSH Key Management menu.
  4. Enter the line number of the user account you want to manage to display the key management menu for this user.
  5. Enter 1 to generate a public/private key pair.

Add authorized keys

  1. Use an SSH key generator such as ssh-keygen to generate a public/private key pair. Note:
    • Specify an RSA key with 2048 bits (such as ssh-keygen -t rsa -b 2048).
    • Specify a passphrase that is easy to remember.
    • Save the private key to a location that you can access when you set up your SFTP client.
  2. Copy all of the text in the public key file to the clipboard. If you use ssh-keygen, copy the contents of the .pub file that you created.

    In an SSH key exchange, the keys must match exactly, including line endings.

  3. Log into the TanOS console as a user with the tanadmin role.
  4. Enter C to go to the User Administration menu.
  5. Enter 3 to go to the SSH Key Management menu.
  6. Enter the line number for the tancopy user to display the key management menu for this user.
  7. Enter 3 to go to the Authorized Keys menu.
  8. Enter 2 and then follow the prompts to add the contents of the public key generated in Step 1.

Display public keys

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter 3 to go to the SSH Key Management menu.
  4. Enter the line number for the tancopy user to display the key management menu for this user.
  5. Enter 2 to display the public key.

Configure TanOS system users

You can create TanOS users that have permissions equivalent to tanadmin or tanuser system users. The system users based on the tanadmin type have access to all menus. System users based on the tanuser type have access to status menus.

Add a system user

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter A to go to the System Users menu.
  4. Enter 1 and follow the prompts to add a system user.

Manage system users

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter A to go to the System Users menu.
  4. Enter 2 to display the Manage System Users menu.
  5. Enter the line item of the user you want to manage to display the Manage Selected User menu.
  6. Use the menu to delete the user, reset the password, or manage the SSH keys.

View history of logins

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter A to go to the System Users menu.
  4. Use the menus A, B, and C to view the logins history.

Configure the local authentication service

You can use the local authentication service to set up Tanium Console user accounts for demo or testing purposes.

Tanium recommends you configure the Tanium Console to use an external LDAP server to authenticate Tanium users. For details, see the Tanium Core Platform User Guide. Additionally, if you plan to use the local authentication service with the Tanium LDAP Sync connector, you must use the following user filter in the LDAP Sync Connector configuration:

(&(objectClass=person)(uidNumber>=20000))

The Local Authentication Service menu is available only after you install the Tanium Server role. It is not available when other roles are installed.

Add a local user

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter B to go to the Local Authentication Service menu.
  4. Enter 1 and then follow the prompts to add a local user.

Set a user password

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter B to go to the Local Authentication Service menu.
  4. Enter 2 to display the Manage Local Users menu.
  5. Enter the user line number to display the user menu.
  6. Enter 2 and then follow the prompts to set the user password.

Delete a user

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter B to go to the Local Authentication Service menu.
  4. Enter 2 and to display the Manage Local Users menu.
  5. Enter the user line number to display the user menu.
  6. Enter 1 and then follow the prompts to delete the user.

Disable the local authentication service

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter B to go to the Local Authentication Service menu.
  4. Enter A and then follow the prompts to enable or disable the local authentication service.

Although the Tanium Console contains a soap_enable_local_auth global setting to disable local authentication, that setting is not supported for Tanium Appliance installations.

Modify the local authentication service security policy

The local authentication service security policy has the following factory settings.

Setting Factory Default Description
Password Minimum Age (days) 1 The minimum number of days between password changes. A value of 0 indicates the password can be changed at any time. Valid range is 0-20.
Password Maximum Age (days) 90 The age at which a current password expires. A value of 0 indicates the password does not expire. Valid range is 0-360.
Password Minimum Length 10 The minimum number of characters allowed in a password. Valid range is 0-30.
Password History 5 The number of most recent passwords that a user cannot reuse. A setting of 0 allows reuse of any previous passwords. Valid range is 0-10.
Password Lockout True True locks out a user with an expired password. False forces the user to change the password.
Password Maximum Failure 5 The number of failed attempts before a user is locked out. A setting of 0 allows unlimited failed attempts. Valid range is 0-10.

To modify the factory settings:

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter B to go to the Local Authentication Service menu.
  4. Enter B to go to the Security Policy Local Authentication Service menu.
  5. Follow the prompts to modify the settings.

Enable tanremote user

The tanremote user can log into the iDRAC virtual console to diagnose hardware and network interface issues in the event the TanOS system becomes unavailable. The tanremote user is not a TanOS user or a Tanium Console user.

Before you begin

You must use a cable to connect the iDRAC interface to your network and use TanOS to configure the iDRAC interface IP address before you enable the tanremote user. See Configure the iDRAC interface.

Enable the tanremote user

  1. Log into the TanOS console as a user with the tanadmin role.
  2. Enter C to go to the User Administration menu.
  3. Enter X to go to the iDrac User menu.
  4. Enter 1 and change the password of the tanremote user. Do this first, even though the user is disabled.
  5. Enter 2 to enable the tanremote user.

Access the iDRAC virtual console

You can access the iDRAC virtual console at http://<iDRAC interface IP address>. Login in with username tanremote and the password that was set with this procedure.