Difference between revisions of "Accessing the Off-Campus VPN"
AlphaCubed (talk | contribs) |
AlphaCubed (talk | contribs) |
||
Line 1: | Line 1: | ||
= Connecting to GlobalProtect = | = Connecting to GlobalProtect = | ||
Due to 2-factor authentication, you | Due to 2-factor authentication, you will need to use some special steps to use openconnect. It will require you to use a GUI (for the time being). | ||
The other approach is to use the GlobalProtect GUI, which is officially supported by Rose-Hulman and will work for the | In case you prefer the command line, we don't yet have a working tutorial. You may be able to write an app around GlobalProtect-openconnect to perform the same functionality (enter URL, open a browser with the login page in Lynx, get relevant tokens, etc.) if you feel inclined. | ||
The other approach is to use the GlobalProtect GUI, which is officially supported by Rose-Hulman and will work in case things break. | |||
== Using openconnect with a GUI == | |||
== Installing == | |||
Install <code>GlobalProtect-openconnect</code> 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''':<code>sudo pacman -S yay && yay -S globalprotect-openconnect</code> (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 == | |||
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 <code>gpclient</code> and press ENTER. | |||
== Connecting == | |||
Type in <code>gp.rose-hulman.edu</code> 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 == | == Using the GlobalProtect GUI == | ||
Line 14: | Line 49: | ||
You will need to download the Word document which opens fine in LibreOffice Writer or the OnlyOffice Desktop Editors. | You will need to download the Word document which opens fine in LibreOffice Writer or the OnlyOffice Desktop Editors. | ||
== Using openconnect (WIP) == | == Using openconnect on the command line (WIP) == | ||
Due to 2-factor authentication on the VPN, this tutorial will not work with the current configuration, but it is currently being experimented with. | 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 <code>openconnect-sso</code> using the following commands in a terminal: | Install <code>openconnect-sso</code> using the following commands in a terminal: | ||
'''Ubuntu/Debian/ | '''Ubuntu/Debian/Debian-based Linux Distros''': follow the instructions in this section: https://github.com/vlaci/openconnect-sso#using-pippipx | ||
'''Arch Linux''':<code>sudo pacman -S yay && yay -S openconnect-sso</code> (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.) | '''Arch Linux''':<code>sudo pacman -S yay && yay -S openconnect-sso</code> (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.) |
Revision as of 02:32, 27 June 2021
Connecting to GlobalProtect
Due to 2-factor authentication, you will need to use some special steps to use openconnect. It will require you to use a GUI (for the time being).
In case you prefer the command line, we don't yet have a working tutorial. You may be able to write an app around GlobalProtect-openconnect to perform the same functionality (enter URL, open a browser with the login page in Lynx, get relevant tokens, etc.) if you feel inclined.
The other approach is to use the GlobalProtect GUI, which is officially supported by Rose-Hulman and will work in case things break.
Using openconnect with a GUI
Installing
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
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
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
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)
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
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
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
[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