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 **Please make sure to replace 9ujm1.arvadosapi.com with your arvados hostname in the examples below.**
  39
  40 On your workstation, add the following section to your `~/.ssh/config`
  41 file:
  42
  43     Host *.arvados
  44       ProxyCommand ssh turnout@switchyard.9ujm1.arvadosapi.com %h %p %u
  45       Port 2222
  46
  47 If you have access to an account `foo` on a VM called `blurfl` then
  48 you can log in like this:
  49
  50     ssh foo@blurfl.arvados
  51
  52 If you want to shorten this and you always/usually have access to the
  53 `foo` account on VMs, you can add a section like this to
  54 `~/.ssh/config`:
  55
  56     Host *.a
  57       ProxyCommand ssh turnout@switchyard.9ujm1.arvadosapi.com %hrvados %p %u
  58       Port 2222
  59       User foo
  60
  61 Then you can log in to the `blurfl` VM as `foo` like this:
  62
  63     ssh blurfl.a
  64
  65 (Arvados Workbench will show you a list of VMs you have access to and
  66 what your account name is for each one.)
  67
  68 ### Windows: Setup instructions for PuTTY
  69
  70 {% include alert-stub.html %}
  71
  72 If you use Microsoft Windows, you should download the PuTTY software.
  73
  74 * Details about configuring PuTTY would be nice here.