Tokens

Authorization tokens can be generated by users and admins to provide others with access to private/authenticated channels or with a specific set of permissions when using the Anaconda Server CLI or API.

This token can be used in place of username-based authentication, and is particularly useful (and sometimes necessary) for third-party applications or automation tools.

​

Token Types

There are two types of tokens within Anaconda Server:

​

Resource tokens

Resource tokens provide the token holder with read, write, or manage permissions for a specific set of channels.

​

Scope tokens

Scope tokens provide the token holder with a fine-grained set of custom user permissions, limiting the available actions that they are able to perform. A scope combines permission categories with specific actions users can perform into a concatenated string, like this:

category:action or category.subcategory:action

Some actions are also tied to permission levels. For example, if you provide the scope channel:edit, you are also providing manage level permissions over channels.

​

Generating tokens

​

Resource tokens

To provide token holders with access to a channel:

1. Log in to Anaconda Server.

2. Open the My Account dropdown menu and select Tokens.

3. Click Generate Token.

4. Enter a name for your token.

5. Set an expiration date for your token.

6. Open the Type dropdown menu and select Resources.

7. Open the Channel dropdown menu and select an available channel to associate with this token.

8. Select the level of permissions to associate with this token.

9. If necessary, click the Add Resource button to include an additional channel with this token, repeat as needed.

10. Provide a brief description of the token’s use.

11. Click Create.

12. Save your token in a secure location.

​

Scope tokens

To provide token holders with a custom set of permissions:

1. Log in to Anaconda Server.

2. Open the My Account dropdown menu and select Tokens.

3. Click Generate Token.

4. Enter a name for your token.

5. Set an expiration date for your token.

6. Open the Type dropdown menu and select Scopes.

7. Open the Select a scope dropdown menu and select a scope to add to the token. Repeat as necessary to build a custom set of permissions for your token holders.

8. Click Create.

9. Save your token in a secure location.

​

Editing a token

You can edit a token to change its name or to update its expiration date. You can choose to issue a new token while editing as well, which will invalidate the previous string associated with the token.

To edit a token:

1. Log in to Anaconda Server.
2. Open the My Account dropdown menu and select Tokens.
3. Select the token’s edit icon.
4. Make any necessary changes to the token.
5. If necessary, select the Issue a new token checkbox. A warning appears at the top of the window to inform you that you will receive a new token.
6. Click Edit.

​

Deleting a token

To delete a token:

1. Log in to Anaconda Server.
2. Open the My Account dropdown menu and select Tokens.
3. Select the token’s delete icon.
4. Click Delete.

​

Setting/using a token

Once you have generated a token, you can share it with other users by any method you wish.

If you have received a resource token from another user and you would like to use it to access packages on a channel, add the channel to your .condarc file by running the following command:

# Replace <FQDN> with the URL of your Anaconda Server fully qualified domain name
# Replace <TOKEN> with the shared token
# Replace <CHANNEL> with the channel name
conda config --add channels http(s)://<FQDN>/t/<TOKEN>/<CHANNEL>

​

Managing tokens via the CLI

For more information on working with tokens using the CLI, see Anaconda Server CLI.

​

Managing tokens via the API

​

List available authorization scopes

GET /api/system/tokens

​

Listing the user authorization tokens

GET /api/account/token

​

Create a new user authorization token

POST /api/account/tokens

​

Removing a user authorization token

DELETE /api/account/tokens/<TOKEN_ID>