duo-ssh-faq.md
... ...
@@ -1,26 +1,27 @@
1 1
# Duo FAQ
2 2
3 3
## how to setup two factor?
4
-You'll need to register your device with Duo to recieve security codes, and can receive these codes by phone call, text message, or Duomobile app.
5 4
5
+You'll need to register your device with Duo to receive security codes, and can receive these codes by phone call, text message, or Duomobile app.
6 6
7
-``
7
+```bash
8 8
ssh $username@duo-test.sbgrid.org
9 9
Password: [input password]
10 10
Please enroll at $url
11
-``
11
+```
12 12
13 13
Copy the url into a web browser, and follow the prompts to register.
14 14
Please contact us at help@sbgrid.org if you encounter problems.
15 15
16 16
## Configuring Options in SSH configuration
17
+
17 18
Set `DUO_PASSCODE` environmental variable to `push` (Duo mobile app), `call` (SMS) or `phone` (phone call) in `~/.bashrc`, `~/.cshrc`, or `~/.zshrc`.
18 19
19
-``
20
+```bash
20 21
Host xtal200
21 22
Hostname xtal200.harvard.edu
22 23
SendEnv DUO_PASSCODE
23
-``
24
+```
24 25
25 26
## Examples
26 27
... ...
@@ -40,17 +41,17 @@ Passcode or option (1-3): 1
40 41
41 42
Pushed a login request to your device...
42 43
Success. Logging you in...
43
- _______________________________________
44
+```bash
45
+ _________________________________________
44 46
/ Welcome to xtal200.harvard.edu user0. \
45
-\ You have landed on ssh-duo0. /
46
- ---------------------------------------
47
- \
48
- \ \
49
- \ /\
50
- ( )
51
- .( o ).
47
+\ You have landed on duo0-test. /
48
+ -----------------------------------------
49
+ \ ,__,
50
+ \ (oo)____
51
+ (__) )\
52
+ ||--|| *
52 53
===================================================
53
- - OS X Software Installer is available for download.
54
+- OS X Software Installer is available for download.
54 55
- Visit our wiki for more information: https://sbgrid.org/wiki/client_install
55 56
- Please support SBGrid by citing the Consortium manuscript:
56 57
- eLife 2013;2:e01456, "Collaboration gets the most out of software".
... ...
@@ -60,16 +61,15 @@ Success. Logging you in...
60 61
NOTE:
61 62
- We recommend using ssh keys https://sbgrid.org/corewiki/faq-setting-up-key-based-ssh
62 63
- Remote access FAQ at https://sbgrid.org/corewiki/faqs-remote
64
+ - 2FA SSH ACCESS is coming October 1st! See https://sbgrid.org/corewiki/duo-ssh-faq
63 65
===================================================
64 66
Email help@sbgrid.org for assistance, questions, or feedback.
65 67
66 68
67
-``
69
+```
68 70
69 71
70 72
### scp/rsync/sftp
71 73
72 74
These commands are non-interactive, so there is not analogous menu for push/call/sms - if the `DUO_PASSCODE` environmental method isn't set, this will use your default method.
73 75
74
-
75
-