Skip to content

Wrapper script around openconnect for JMU VPN authentication on Linux

License

Notifications You must be signed in to change notification settings

TabulateJarl8/jmu-openconnect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JMU OpenConnect

PyPI Downloads License Maintenance GitHub Issues GitHub followers
Kofi Badge

Important

DEPRECATION NOTICE: This project is based on Ivanti Pulse Secure, which JMU no longer uses as of January 6th, 2025. Now that JMU has switched to GlobalProtect, you can switch to using yuezk/GlobalProtect-openconnect if needed. While the GUI frontend has some weird licensing restrictions, the CLI component will always be free, and you could just make a GUI wrapper around that if needed.

You can use gp.jmu.edu as the portal server address when connecting to the VPN.

This is a wrapper script around openconnect to help with authentication for the JMU VPN on Linux. Openconnect used to work fine until Ivanti purchased Pulse Secure, and then that broke something. This script opens up a web browser to allow the user to authenticate with Duo, and then grabs the DSID cookie to use for openconnect authentication.

Installation

This script can easily be installed with pip or pipx with the following commands:

$ pipx install jmu-openconnect
$ # OR
$ pip3 install jmu-openconnect

Usage

Once the script is installed, you can run the following command in your terminal:

$ jmu-openconnect

You can also specify a username and password to be automatically typed in, however you will still have to do 2FA manually. You can specify one or the other or both, and if both are specified, the "Log in" button will automatically be clicked.

$ jmu-openconnect -u <EID> -p <PASSWORD>

You can alternatively specify the --prompt-password (or -P) option instead of using -p, which will prompt the user for a password without echoing, much like sudo. This is more secure as your password won't be saved in your command line history.

JMU OpenConnect defaults to using firefox, but you can easily change which browser you're using by specifying --browser, which accepts firefox, chrome, or edge.

The first time that you launch JMU OpenConnect, it may take a little longer than normal, as selenium has to download and cache your webdriver.

$ jmu-openconnect --browser chrome

To see all of the available options, run jmu-openconnect --help.

Dependencies

This script just requires openconnect and selenium. If you are having problems, check the Selenium Python Documentation.

DSID Cookie was not found

If you get the error that the DSID cookie was not found, then you may be logged on in multiple places at once. Navigate to https://vpn.jmu.edu and after signing in, you should see a screen like this:

Maximum number of open user sessions screenshot

If this is the case, just select the box to remove that sign in and press "Close Selected Sessions and Log in". After this, you will need to press the log out button in the upper right corner of the VPN website, and then you can retry the script. If this is not the problem, try running the script with jmu-openconnect --debug-auth-error to see the error for a longer period of time.

About

Wrapper script around openconnect for JMU VPN authentication on Linux

Resources

License

Stars

Watchers

Forks

Languages