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.
- 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.
The Administration > Security > Installation Tokens page displays the following information:
- Status shows a green checkmark to indicate if the Installation Token is active and available for use or an exclamation mark in a red circle 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.
- 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.
- Input a unique name and optionally provide a description then click Save.
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.
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.
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 Linux, Install 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.
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:
sudo ./SumoCollector.sh -q -Vsumo.token_and_url=<installationToken>
<installationToken> is the Token String you want to use to register the Collector.
To register an Installed Collector with user.properties you need to use the authentication parameters
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:
would be used as: