doc/user/api-tokens.md

   1 ---
   2 layout: default
   3 navsection: userguide
   4 title: Getting an API token
   5 navorder: 1
   6 ---
   7
   8 # Getting an API token
   9
  10 Open a browser and point it to the Workbench URL for your site. It
  11 will look something like this:
  12
  13 `https://workbench.{{ site.arvados_api_host }}/`
  14
  15 Log in, if you haven't done that already.
  16
  17 Click the "API tokens" link.
  18
  19 At the top of the "API tokens" page, you will see a few lines like this.
  20
  21     ### Pasting the following lines at a shell prompt will allow Arvados SDKs
  22     ### to authenticate to your account, youraddress@example.com
  23
  24     read ARVADOS_API_TOKEN <<EOF
  25     2jv9kd1o39t0pcfu7aueem7a1zjxhak73w90tzq3gx0es7j1ld
  26     EOF
  27     export ARVADOS_API_TOKEN ARVADOS_API_HOST=qr1hi.arvadosapi.com
  28
  29 Paste those lines into your terminal window to set up your
  30 terminal. This effectively copies your credentials from your browser
  31 to your terminal session.
  32
  33 Now, `arv -h user current` will display your account info in JSON
  34 format.
  35
  36 Optionally, copy those lines to your .bashrc file so you don't have to
  37 repeat this process each time you log in.
  38
  39 ### SSL + development mode
  40
  41 If you are using a local development server with a self-signed
  42 certificate, you might need to bypass certificate verification. Don't
  43 do this if you are using a production service.
  44
  45     export ARVADOS_API_HOST_INSECURE=yes