--- layout: default navsection: userguide navmenu: Reference title: "Getting an API token" ... h1. Reference: Getting an API token The Arvados API token is a secret key that enables the @arv@ command line client to access Arvados with the proper permissions. Access the Arvados workbench using this link: "https://workbench.{{ site.arvados_api_host }}/":https://workbench.{{ site.arvados_api_host }}/ (Replace @{{ site.arvados_api_host }}@ with the hostname of your local Arvados instance if necessary.) First, open a shell on the system on which you intend to use the Arvados client (this may be your local workstation, or an Arvados VM, refer to "Accessing Arvados over ssh":{{site.baseurl}}/user/getting_started/ssh-access.html ) . Click on the user icon in the upper right corner to access the user settings menu, and click on the menu item _Manage API token_ to go to the "api client authorizations" page. h2. The easy way For your convenience, the "api client authorizations" page on Workbench provides a "Help" tab that provides a command you may copy and paste directly into the shell. It will look something like this: bc. ### Pasting the following lines at a shell prompt will allow Arvados SDKs ### to authenticate to your account, youraddress@example.com read ARVADOS_API_TOKEN <
$ export ARVADOS_API_HOST={{ site.arvados_api_host }}
$ export ARVADOS_API_TOKEN=2jv9346o3966345u7ueuim7a1zaaoueo3w90tzq3gx0es7j1ld
* @ARVADOS_API_HOST@ tells @arv@ which host to connect to * @ARVADOS_API_TOKEN@ is the secret key used by the Arvados API server to authenticate access. If you are connecting to a development instance with a unverified/self-signed SSL certificate, set this variable to skip SSL validation:
$ export ARVADOS_API_HOST_INSECURE=1
h2. settings.conf Arvados tools will also look for the authentication information in @~/.config/arvados/settings.conf@. If you have already put the variables into the environment with instructions above, you can use these commands to create an Arvados configuration file:
$ echo "ARVADOS_API_HOST=$ARVADOS_API_HOST" > ~/.config/arvados/settings.conf
$ echo "ARVADOS_API_TOKEN=$ARVADOS_API_TOKEN" >> ~/.config/arvados/settings.conf
h2. .bashrc Alternately, you may add the declarations of @ARVADOS_API_HOST@ and @ARVADOS_API_TOKEN@ to the @~/.bashrc@ file on the system on which you intend to use the Arvados client. If you have already put the variables into the environment with instructions above, you can use these commands to append the environment variables to your @~/.bashrc@:
$ echo "export ARVADOS_API_HOST=$ARVADOS_API_HOST" >> ~/.bashrc
$ echo "export ARVADOS_API_TOKEN=$ARVADOS_API_TOKEN" >> ~/.bashrc