Skip to main content
Sumo Logic

Installation Tokens

Installation Tokens are assigned to your organization and are used to register Installed Collectors to your Sumo Logic account. They do not expire and can only be used to register Installed Collectors. You can deactivate, reactivate, or delete tokens at any time.

Opposed to Access Keys, you can embed your Installation Tokens in installation scripts confident they can't be used to make API requests if compromised. You can also freely deactivate or delete users without worrying about updating Access Keys in installation scripts since Installation Tokens are associated with your organization instead of users.

Limitations

  • Your account can have up to 100 Installation Tokens, active and inactive.
  • Installation Token names must be unique.
  • When using the RPM or Debian package you need to use user.properties to register Collectors.

Manage Installation Tokens

Installation Tokens in your account are manageable at Administration > Security > Installation Tokens.

Installation Tokens UI table.png

The Administration > Security > Installation Tokens page displays the following information: 

  • Status shows a green checkmark green checkmark.png to indicate if the Installation Token is active and available for use or an exclamation mark in a red circle red circle white exclamation.png to indicate if the Installation Token is deactivated and not available for use.
  • Token Name is the name of the Installation Token, these must be unique.
  • Description shows the optional description of the Installation Token.

On the Administration > Security > Installation Tokens page you can:

  • Click + Add Token to add Installation Tokens.
  • Search Installation Tokens
  • Edit Installation Tokens
  • Deactivate Installation Tokens
  • Delete Installation Tokens 

For the Installation Tokens listed, select a row to view its details. A details pane appears to the right of the table where you can edit, deactivate, and delete the token.

token details pane.png

Add Token
  1. Click the + Add Token button on the top right of the table. A panel named Create Installation Token appears to the right of the table.
  2. Input a unique name and optionally provide a description then click Save.

create token.png

Deactivate Token

Deactivated tokens cannot be used to register Collectors. You can deactivate a token at any time.

Select Deactivate from the menu on the right of the row on the table or in the details pane of the token under the More Actions dropdown.

deactivate token.png

Delete Token

Deleted tokens are removed from your account and cannot be used anymore. Since tokens are only used to register a Collector it won't affect registered Collectors.

Select Delete Token from the menu on the right of the row on the table or in the details pane of the token under the More Actions dropdown.

delete token.png

Using Installation Tokens

This section provides information on using Installation Tokens to register Installed Collectors. For details on Collector installation, see Install a Collector on LinuxInstall a Collector on MacOS, and Install a Collector on Windows.

Setup Wizard UI installer

To register an Installed Collector with the Setup Wizard select the Setup Wizard Token authentication option.

wizard authentication step.png

Click next and enter the Token String you want to use to register the Collector in the input box for a one-time token. Continue with the installation steps.

Command line installer

To register an Installed Collector with the command line installer you need to run the script with the following authentication parameter:

-Vsumo.token_and_url

For example:

sudo ./SumoCollector.sh -q -Vsumo.token_and_url=<installationToken>

Where <installationToken> is the Token String you want to use to register the Collector.

user.properties

To register an Installed Collector with user.properties you need to use the authentication parameters token and url. To use these two parameters you'll need to manually base64 decode the Token String. Once decoded you'll have a string with a token and a URL.

For example, the following decoded Token String:

SUMOXXXXXXXXXXXXXXXXXXXXXXXXXXXXhttps://collectors.sumologic.com

would be used as:

url=https://collectors.sumologic.com
token=SUMOXXXXXXXXXXXXXXXXXXXXXXXXXXXX