doc/user/ssh-access.md

   1 ---
   2 layout: default
   3 navsection: userguide
   4 title: Setting up SSH access
   5 navorder: 2
   6 ---
   7
   8 # Setting up SSH access
   9
  10 Arvados uses SSH public key authentication for two things:
  11
  12 * logging in to a VM, and
  13 * pushing code to a git repository.
  14
  15 ### Generate a public/private SSH key pair
  16
  17 If you don't already have an SSH key pair (or you don't know whether
  18 you do), there are lots of tutorials out there to help you get
  19 started:
  20
  21 * [github SSH key
  22 tutorial](https://www.google.com/search?q=github+ssh+key+help)
  23
  24 ### Associate your SSH public key with your Arvados Workbench account
  25
  26 Go to the `Keys` tab in Arvados Workbench and click the
  27
  28   `Add a new authorized key`
  29
  30 button. Then click on 'none' in the public_key column, and copy and paste your public key:
  31
  32   ![Screen shot of the ssh public key box]({{ site.baseurl }}/images/ssh-adding-public-key.png)
  33
  34 Click on the checkmark button to save your public key.
  35
  36 ### Unix-like systems: set up an ~/.ssh/config snippet for quick ssh access
  37
  38 On your workstation, add the following section to your `~/.ssh/config`
  39 file:
  40
  41     Host *.arvados
  42       ProxyCommand ssh turnout@9ujm1.arvados.org %h %p %u
  43       Port 2222
  44
  45 If you have access to an account `foo` on a VM called `blurfl` then
  46 you can log in like this:
  47
  48     ssh foo@blurfl.arvados
  49
  50 If you want to shorten this and you always/usually have access to the
  51 `foo` account on VMs, you can add a section like this to
  52 `~/.ssh/config`:
  53
  54     Host *.a
  55       ProxyCommand ssh turnout@9ujm1.arvados.org %hrvados %p %u
  56       Port 2222
  57       User foo
  58
  59 Then you can log in to the `blurfl` VM as `foo` like this:
  60
  61     ssh blurfl.a
  62
  63 (Arvados Workbench will show you a list of VMs you have access to and
  64 what your account name is for each one.)
  65
  66 ### Windows: Setup instructions for PuTTY
  67
  68 {% include alert-stub.html %}
  69
  70 If you use Microsoft Windows, you should download the PuTTY software.
  71
  72 * Details about configuring PuTTY would be nice here.