Accessing the Off-Campus VPN
Connecting to GlobalProtect[edit | edit source]
The official GlobalProtect client has native Linux support, and an installer can be obtained for free from EIT.
In previous years the LUG recommendation was to use OpenConnect but after the v2.0 update. the GUI portion of it is no longer free to use, nor open source. Since the GUI is required to handle 2-factor authentication, we no longer recommend OpenConnect, and we encourage all current users not to upgrade to v2.0.
Using the Official Client[edit | edit source]
Installing[edit | edit source]
We recommend following EIT's instructions for installing the VPN. You can download the VPN itself from https://roseshare.rose-hulman.edu/portal/s/826336093690088626.tgz. The archive provides both a .deb and .rpm installer, which can be directly installed on Debian or Fedora based systems. Arch users may be able to use debtap to install.
Using OpenConnect[edit | edit source]
Installing[edit | edit source]
NOTE: OpenConnect v2.x is no longer free to use, nor open source! If the official client doesn't work, we strongly recommend installing v1.x instead.
Install GlobalProtect-openconnect using the following commands in a terminal:
Ubuntu/Debian/Debian-based Linux Distros: follow the instructions in this section: https://github.com/yuezk/GlobalProtect-openconnect#debian-package
Arch Linux:sudo pacman -S yay && yay -S globalprotect-openconnect (This will install yay, which installs packages from the AUR, and GlobalProtect-openconnect, which allows you to use 2-factor authentication to connect to the VPN.)
Opening[edit | edit source]
Then, if you use KDE, press the Windows (aka. Super) key to go to your Application Launcher (in KDE) and search for "GlobalProtect".
Or, if you use Ubuntu (which uses GNOME), do something similar by either pressing the Windows (aka. Super) key or clicking on the Ubuntu logo at the top-left (looks like a circle with three dots).
If you don't use Ubuntu but you use GNOME, either press Windows (aka. Super) or click the foot icon at the top-left.
In KDE, it will look something like this:
https://github.com/RHLUG-Org/RHLUG-Wiki-Temp/raw/master/screenshot_1.png
Alternatively, in a terminal, type in gpclient and press ENTER.
Connecting[edit | edit source]
Type in gp.rose-hulman.edu in the text box and click "Connect" below the text box.
A window should pop up with the Rose-Hulman login screen. Go through the Microsoft login and input your 2-factor authentication token like usual.
Another window will pop up. You can ignore that window. The VPN app should say "Connected". And you're done!
As Apple would say, it has never been this easy to connect to the VPN. It's just like this on Windows.
You can disconnect by clicking "Disconnect".
Using the GlobalProtect GUI[edit | edit source]
In a web browser, go to https://rose-hulman.microsoftcrmportals.com/knowledgebase/article/KA-01278/en-us.
Press Ctrl+F and type in "Setting up the client on Linux".
Read and follow the instructions below "Setting up the client on Linux". You can follow these instructions in a VM if you want to isolate the GUI client from your host system.
You will need to download the Word document which opens fine in LibreOffice Writer or the OnlyOffice Desktop Editors.
Using openconnect on the command line (WIP)[edit | edit source]
Due to 2-factor authentication on the VPN, this tutorial will not work with the current configuration, but it is currently being experimented with.
Install openconnect-sso using the following commands in a terminal:
Ubuntu/Debian/Debian-based Linux Distros: follow the instructions in this section: https://github.com/vlaci/openconnect-sso#using-pippipx
Arch Linux:sudo pacman -S yay && yay -S openconnect-sso (This will install yay, which installs packages from the AUR, and openconnect-sso, which allows you to use 2-factor authentication to connect to the VPN.)
Then, connect to the VPN using the following command, replacing yournetworkusername with your Rose-Hulman network username (for security reasons, do NOT run this command as root, e.g. using sudo):
openconnect-sso --server gp.rose-hulman.edu --user [email protected]
Then type in your password and press ENTER.
NOTE: As of 6/26/21, this is when the VPN won't connect. If you want more information to try to help us out, see the "openconnect debugging" section at the bottom of this page.
You should see a message if it connects successfully.
Sources: https://github.com/dlenski/openconnect/issues/143, https://github.com/vlaci/openconnect-sso
Active issues: https://github.com/dlenski/openconnect/issues/143, https://gitlab.com/openconnect/openconnect/-/issues/84
Historical information on using openconnect for GlobalProtect[edit | edit source]
Open a terminal, and type:
sudo openconnect --protocol=gp gp.rose-hulman.edu
When the following appears:
RHIT EMAIL ADDRESS:
type in your Rose-Hulman email address and press ENTER.
Right after this, type in your network password, then press ENTER.
Now, try going to mirror.csse.rose-hulman.edu in a web browser. If you see something there, you are connected. If you get a server error or something similar, you are not.
Alternatively, if you prefer the command line, type ping mirror.csse.rose-hulman.edu and see if there is a response from the server - if you are connected, it should say PING from (ip address): 20ms or similar.
To disconnect, press the Control and C keys at the same time in the terminal.
Wait until you see your normal shell prompt such as:
username@hostname:directory$(source: https://www.howtogeek.com/307701/how-to-customize-and-colorize-your-bash-prompt/).
EDIT 6/26/21: This currently errors out with this message, and logging in via that URL will not work (it redirects to a success page that doesn't do anything):
SSL negotiation with gp.rose-hulman.edu
Connected to HTTPS on gp.rose-hulman.edu with ciphersuite (TLS1.2)-(ECDHE-SECP256R1)-(ECDSA-SHA256)-(AES-256-GCM)
SAML REDIRECT authentication is required via (long url)
When SAML authentication is complete, specify destination form field by appending :field_name to login URL.
Failed to parse server response
Failed to obtain WebVPN cookie
Historical information on Juniper/PulseSecure[edit | edit source]
Adapted from EIT's documentation: https://servicedesk.rose-hulman.edu/knowledgebase/article/KA-01093/en-us
Open a terminal, and type:
sudo openconnect --juniper sslvpn.rose-hulman.edu
When the following appears:
frmLogin realm [Users|DeltaV|Vendors]:
type in Users and press ENTER.
Then, when this appears:
frmLogin username:
Type in your Rose-Hulman network username, press ENTER.
Right after this, type in your network password, then press ENTER.
Now, when ESP session established with server appears in the terminal, you are connected.
To disconnect, press the Control and C keys at the same time in the terminal. Wait until you see your normal shell prompt such as:
username@hostname:directory$ (source: https://www.howtogeek.com/307701/how-to-customize-and-colorize-your-bash-prompt/).
openconnect debugging[edit | edit source]
[info ] Authenticating to VPN endpoint [openconnect_sso.app] address=gp.rose-hulman.edu name=
Traceback (most recent call last):
File "/usr/bin/openconnect-sso", line 33, in <module>
sys.exit(load_entry_point('openconnect-sso==0.7.3', 'console_scripts', 'openconnect-sso')())
File "/usr/lib/python3.9/site-packages/openconnect_sso/cli.py", line 169, in main
return app.run(args)
File "/usr/lib/python3.9/site-packages/openconnect_sso/app.py", line 34, in run
auth_response, selected_profile = asyncio.get_event_loop().run_until_complete(
File "/usr/lib/python3.9/asyncio/base_events.py", line 642, in run_until_complete
return future.result()
File "/usr/lib/python3.9/site-packages/openconnect_sso/app.py", line 139, in _run
auth_response = await authenticate_to(
File "/usr/lib/python3.9/site-packages/openconnect_sso/authenticator.py", line 22, in authenticate
response = self._start_authentication()
File "/usr/lib/python3.9/site-packages/openconnect_sso/authenticator.py", line 67, in _start_authentication
return parse_response(response)
File "/usr/lib/python3.9/site-packages/openconnect_sso/authenticator.py", line 137, in parse_response
xml = objectify.fromstring(resp.content)
File "src/lxml/objectify.pyx", line 1808, in lxml.objectify.fromstring
File "src/lxml/etree.pyx", line 3237, in lxml.etree.fromstring
File "src/lxml/parser.pxi", line 1896, in lxml.etree._parseMemoryDocument
File "src/lxml/parser.pxi", line 1784, in lxml.etree._parseDoc
File "src/lxml/parser.pxi", line 1141, in lxml.etree._BaseParser._parseDoc
File "src/lxml/parser.pxi", line 615, in lxml.etree._ParserContext._handleParseResultDoc
File "src/lxml/parser.pxi", line 725, in lxml.etree._handleParseResult
File "src/lxml/parser.pxi", line 654, in lxml.etree._raiseParseError
File "<string>", line 1
lxml.etree.XMLSyntaxError: Start tag expected, '<' not found, line 1, column 1