doc/user/reference/api-tokens.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: userguide
   4 title: "Getting an API token"
   5 ...
   6
   7 The Arvados API token is a secret key that enables the @arv@ command line client to access Arvados with the proper permissions.
   8
   9 Access the Arvados Workbench using this link: "https://{{ site.arvados_workbench_host }}/":https://{{ site.arvados_workbench_host }}/  (Replace @{{ site.arvados_api_host }}@ with the hostname of your local Arvados instance if necessary.)
  10
  11 Open a shell on the system where you want to use the Arvados client. This may be your local workstation, or an Arvados virtual machine accessed with SSH (instructions for "Unix":{{site.baseurl}}/user/getting_started/ssh-access-unix.html#login or "Windows":{{site.baseurl}}/user/getting_started/ssh-access-windows.html#login).
  12
  13 Click on the link with your _email address_ in the upper right corner to access your account menu, then click on the menu item *Manage account* to go to the account management page. On the *Manage account* page, you will see the *Current Token* panel, which lists your current token and instructions to set up your environment.
  14
  15 h2. Setting environment variables
  16
  17 For your convenience, the *Manage account* page on Workbench provides the *Current Token* panel that includes a command you may copy and paste directly into the shell.  It will look something as the following.
  18
  19 bc. HISTIGNORE=$HISTIGNORE:'export ARVADOS_API_TOKEN=*'
  20 export ARVADOS_API_TOKEN=2jv9346o396exampledonotuseexampledonotuseexes7j1ld
  21 export ARVADOS_API_HOST={{ site.arvados_api_host }}
  22 unset ARVADOS_API_HOST_INSECURE
  23
  24 * The @export@ command puts a local shell variable into the environment that will be inherited by child processes such as the @arv@ client.
  25
  26 h2. settings.conf
  27
  28 Arvados tools will also look for the authentication information in @~/.config/arvados/settings.conf@. If you have already put the variables into the environment following the instructions above, you can use these commands to create an Arvados configuration file:
  29
  30 <notextile>
  31 <pre><code>$ <span class="userinput">echo "ARVADOS_API_HOST=$ARVADOS_API_HOST" > ~/.config/arvados/settings.conf</span>
  32 $ <span class="userinput">echo "ARVADOS_API_TOKEN=$ARVADOS_API_TOKEN" >> ~/.config/arvados/settings.conf</span>
  33 </code></pre>
  34 </notextile>
  35
  36 h2. .bashrc
  37
  38 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 following the instructions above, you can use these commands to append the environment variables to your @~/.bashrc@:
  39
  40 <notextile>
  41 <pre><code>$ <span class="userinput">echo "export ARVADOS_API_HOST=$ARVADOS_API_HOST" >> ~/.bashrc</span>
  42 $ <span class="userinput">echo "export ARVADOS_API_TOKEN=$ARVADOS_API_TOKEN" >> ~/.bashrc</span>
  43 </code></pre>
  44 </notextile>