Skip to content

Commit

Permalink
Add tip for SSH proxy jump hosts
Browse files Browse the repository at this point in the history
  • Loading branch information
campb303 committed May 18, 2021
1 parent fd52b94 commit de34425
Showing 1 changed file with 21 additions and 2 deletions.
23 changes: 21 additions & 2 deletions docs/Dev Environment Setup Guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,9 +69,28 @@ The configuration above will allow you to connect to the development machine and
| HostName | The DNS name or IP address of the computer you're connecting to. |
| User | The name of your user on the computer you're connecting to. |
| LocalForward | Forwards a port on your computer to a port on the computer you're connecting to. |

Development machines are not publicly accessible. You'll need to be connected to WebVPN to connect to them.

!!! tip
You need to be connected to WebVPN before SSH'ing into a the development machine.
??? tip "SSH Jump Hosts"
WebVPN works on all platforms but requires an extra step to get to work. On macOS/Linux, `pier.ecn.purdue.edu` can be used as an [SSH jump host](https://www.tecmint.com/access-linux-server-using-a-jump-host/) allowing for development machines to be connected to automatically when openning VS Code.

Assuming you already have an SSH key configured for `pier.ecn.purdue.edu`, you can use a jump host by adding the following to `~/.ssh/config`:

```
Host campb303-pier
HostName pier.ecn.purdue.edu
User campb303

Host campb303-w2vm1
HostName w2vm1.ecn.purdue.edu
ProxyJump campb303-pier
User campb303
# Forward webqueue2 API Port
LocalForward 5000 localhost:5000
# Forward webqueue2 API Docs Port
LocalForward 8000 localhost:8000
```

To test your configuration, run `ssh` followed by the `Host` value. When prompted for your password, enter your career account password and press <kbd>Enter</kbd>.

Expand Down

0 comments on commit de34425

Please sign in to comment.