- Organization access token: Your organization access token provides you with the ability to connect to your organization’s to install in your . Each user in an organization has a unique access token, unless your organization is using a site token for access. Organization access tokens expire either 30 days after your organization’s subscription has ended or immediately when your subscription is canceled.
-
Site token: A site token is an organization access token that is used by the entire organization. This one access token can authenticate any organization member. Site tokens are provided by organization administrators.
You do not need to be assigned a seat if your organization is using a site token.
Installing token management tools
Install both of the following tools to manage your Anaconda.com organization access token.Installing anaconda-auth
Installing anaconda-auth
anaconda-auth
is used to authenticate you (log you in) to your Anaconda.com organization at the command line. It can also be used to issue and set a new Anaconda.com organization access token, and can (optionally) configure your .condarc
file to use Anaconda’s curated repository channels by default.- Open Anaconda Prompt (Terminal on macOS/Linux).
-
Install
anaconda-auth
:For more information about theanaconda-auth
package, see anaconda-auth reference.
Installing conda-token
Installing conda-token
conda-token
is used to set an organization access token that you have issued for yourself from your Anaconda.com organization or received from your organization administrator.- Open Anaconda Prompt (Terminal on macOS/Linux).
-
Install
conda-token
:https://repo.anaconda.cloud/repo/anaconda-tools
is a public channel hosted and maintained by Anaconda that contains theconda-token
package.
Issuing and setting your token
You must be assigned a seat within your organization to issue yourself a token. If you have not been assigned a seat, speak with your organization administrator.
- If you are issuing a token for the first time or need to issue a new token, use the
anaconda-auth
CLI method. - If you prefer to use applications with a user interface, issue your token from Anaconda.com and set it with Anaconda Navigator.
- If a token has been provided to you, set it using the
conda-token
CLI method.
Issuing a token using
anaconda-auth
automatically sets the token for you.- Open Anaconda Prompt (Terminal on macOS/Linux).
-
Issue and set your token by running the following command:
This command initiates a sign-in workflow in a browser window. If you are already signed in, authentication is automatically completed. If you are not signed in, you are prompted to sign in with your Anaconda.com credentials.If your organization has configured SSO, you are redirected to your company’s SSO login page.
If you belong to more than one organization, use the arrow keys to select the organization you want to issue and set a token for.
This command also configures your.condarc
file to use Anaconda’s curated repository channels atrepo.anaconda.cloud
. - Return to your terminal and follow the prompts to complete the workflow.
Reissuing a token
You can reissue a token usinganaconda-auth
or from your Anaconda.com organization.
Reissuing a token invalidates your previously issued token.
- Open Anaconda Prompt (Terminal on macOS/Linux).
-
Issue and set a new token:
All newly issued tokens are set to expire when your organization’s subscription expires.
Synchronizing your token
Tokens have a lifespan that is tied to your organization’s subscription; however, renewing your subscription does not automatically extend the lifespan of your token. If you’ve renewed your subscription and want to retain your current token, synchronize your token to extend its lifespan to your organization’s new subscription expiration date. To synchronize your token:- Go to your organization’s page.
- Under Org Management, select Token Access.
- Click Sync token.
Token storage
Your organization access token is securely stored in your system’s local files but gets saved in different locations based on which method you use to set your token.If you set your token using the
anaconda token install
command, your token is stored in the anaconda-keyring
location:C:\Users\<USER_NAME>\.anaconda\keyring