Latest revision |
Your text |
Line 1: |
Line 1: |
| == NUIT instructions (works for most) ==
| | Northwestern IT has instructions for how to set up VPN on multiple operating systems. For most people, [https://www.it.northwestern.edu/oncampus/vpn/ their instructions] should work fine. |
|
| |
|
| Northwestern IT has instructions for how to set up VPN on multiple operating systems using the GlobalConnect client. For most people, [https://kb.northwestern.edu/94726 their instructions] should work fine.
| | The Linux instructions are a bit lacking. Here are step-by-step instructions for Ubuntu 18.04. It should be similar for other Debian-based systems and very similar if you are using Gnome 3. Alternatively, you can connect to Kibo using the [[ Northwestern VPN#ssh conifg | configuration]] that mako developed. |
|
| |
|
| == Alternative Linux option ==
| | <code> |
| | sudo apt install network-manager-openconnect-gnome |
| | </code> |
|
| |
|
| [[Mako]] has built an alternative configuration (suitable for anybody running Debian or Ubuntu is) that doesn't require the GlobalConnect client. This has two main benefits: (1) it doesn't require installing the normal client which includes a proprietary sort of spyware tool that sends details on what packages are installed to NU every time you use it, and (2) it allows you to proxy only a single ssh connection and ''not'' your entire Internet connection. Folks who are not at NU may want to use this.
| | Open Settings > Networks > Add VPN |
|
| |
|
| To install it you can download the software from the [[CommunityData:Git|CDSC Git repository]] like:
| | [[File:Add-vpn.png|500px]] |
|
| |
|
| gitea@gitea.communitydata.science:collective/nu-vpn-proxy.git
| | Choose the openconnect option |
|
| |
|
| Details on how to set use that code are up are in the <code>README-CDSC</code> file in that repostiroy.
| | [[File:Anyconnect-vpn.png|500px]] |
|
| |
|
| There are two modes supported by the scripts:
| | Edit the settings: |
|
| |
|
| # A mode that proxies '''only''' for SSH connections to kibo.
| | Gateway: `vpn-nu.vpn.northwestern.edu` |
| # A mode that proxies your entire connection.
| | Token mode: `TOTP -- manually entered` |
|
| |
|
| Please commit any changes to the code and/or or the documentation in the git repository.
| | [[File:Vpn-settings.png|500px]] |
|
| |
|
| | Click connect and log in using your NU netid and password |
|
| |
|
| === Troubleshooting ===
| | [[File:Vpn-connect.png|500px]] |
|
| |
|
| New versions of openconnect and openssl can cause a few issues.
| | == SSH Config == |
|
| |
|
| ==== OpenSSL error ====
| | To connect to kibo using ssh. |
| If you get an error saying "UNSAFE_RENEGOTIATION DISABLED", this is because our setup relies on Python library that is using an older deprecated ("unsafe") protocol. Until we get it fixed on the server, you need to disable checking on your local machine.
| |
|
| |
|
| The simplest thing (described in [https://stackoverflow.com/a/72245418 this stackoverflow suggestion]). Basically, it should be possible to add this line to the following files (after the fourth line): <code>openconnect_command-general.sh</code>, <code>openconnect_command-http.sh</code>, <code>openconnect_command-ssh.sh</code>:
| | 1. Install netcat-bsd and ocproxy |
|
| |
|
| :<code>export OPENSSL_CONF=./openssl.conf</code>
| | sudo apt install ocproxy netcat-openbsd |
|
| |
|
| The downside to this is that will require that the command be run ''from the local directory''. Alternatively, you can put the full path to the <code>openssl.conf</code> file that is shipped with the repository into the line above (e.g., <code>/home/mako/bin/nu-vpn-proxy/openssl.conf</code>).
| | 2. Add the following to your ~/.ssh/config. Replace <YOUR NU USERNAME>. |
|
| |
|
| Another option is to change your systemwide OpenSSL configuration as described in comment 7 on [https://bugs.launchpad.net/ubuntu/+source/openssl/+bug/1963834 this bug report]. This is probably more dangerous.
| | Host kibo kibo.soc.northwestern.edu |
| | Hostname kibo.soc.northwestern.edu |
| | User <YOUR NU USERNAME> |
| | ProxyCommand ~/bin/nu-vpn-proxy %h %p |
|
| |
|
| ==== Openconnect error ====
| | 3. Create the file ~/bin/nu-vpn-proxy with the following. Replace <YOUR NU NETID> and <YOUR NU PASSWORD>. |
|
| |
|
| The other error that you may get is: <code>Failed to parse server response</code>
| |
|
| |
|
| If you get this error, it's likely because there was a bug in openconnect. The bug seems to have begun in openconnect 8.2 and been fixed at some point before openconnect 9.0. Basically,that breaks when upgrading to openconnect version 8.20+ but less than 9.0.
| | #!/bin/bash |
| | |
| | # connects to SSH through openconnect and VPN |
| | # for use iwth ProxyCommand in SSH |
| | |
| | # first run openconnect |
| | |
| | /sbin/start-stop-daemon --pidfile /tmp/nu-vpn-openconnect.pid --make-pidfile -b -S --startas /bin/bash -- -c '/usr/sbin/openconnect --reconnect-timeout 60 --script-tun --script "ocproxy -D 9052" --user <YOUR NU NETID> vpn-nu.vpn.northwestern.edu < <(echo <YOUR NU PASSWORD>)' & |
| | |
| | sleep 3 |
| | |
| | # kill connection on exit |
| | function cleanup { |
| | /sbin/start-stop-daemon --stop --pidfile /tmp/nu-vpn-openconnect.pid |
| | } |
| | trap cleanup EXIT |
| | |
| | # redirect traffic (standard input and output) through VPN |
| | /bin/nc.openbsd -X 5 -x 127.0.0.1:9052 $1 $2 |
|
| |
|
| If you can upgrade to 9.0, that is best. If you cannot easily do this, it is likely best to downgrade to 8.1.
| | Make the file executable using <code> chmod +x ~/bin/nu-vpn-proxy </code> |
|
| |
|
| Instructions for Ubuntu:
| | Now you should be able to login to kibo. <code> ssh kibo </code>. |
| | |
| 1. Uninstall <code>openconnect</code> and <code>libopenconnect5</code>
| |
| | |
| sudo apt remove openconnect libopenconnect5
| |
| | |
| 2. Download version 8.10
| |
| | |
| cd ~/Some/dir
| |
| wget https://www.infradead.org/openconnect/download/openconnect-8.10.tar.gz
| |
| tar -xvf ./openconnect-8.10.tar.gz
| |
| cd ./openconnect-8.10
| |
| | |
| 3. Install openconnect following [https://www.infradead.org/openconnect/building.html these instructions]
| |
| | |
| ./configure
| |
| make
| |
| make install
| |
| | |
| 4. Cross your fingers and try to connect to the VPN again (e.g., with <code>ssh kibo</code>).
| |