Release Notes#

These are the releases notes of eduVPN / Let’s Connect! 3.x. They will be updated as needed. It is a big release consisting of many changes.

As this is a new major release, we expect some (minor) issues to still exist that we’ll run into in the next weeks/months, so it is important to regularly update your system using the vpn-maint-update-system command. If you are currently deploying eduVPN / Let’s Connect! in production, we highly recommend that you first install 3.x on a test system before planning an upgrade or new installation.

New Features#

• Use WireGuard in addition to OpenVPN for VPN connections
• Support High Availability deployments (memcached, PostgreSQL)
• Allow limits on number of (concurrent) connections per user
• Support OpenID Connect for user authentication

Other Changes#

• APIv3 (also implemented in eduVPN / Let’s Connect! 2.x servers) that greatly simplifies the API and also supports WireGuard;
• Usage statistics are retained for longer than 30 days;
• Remove 2FA/MFA support, 2FA is supported by leveraging an identity provider

Security#

• TLS >= 1.3 only for OpenVPN
• Ed25519 key/certificate for OpenVPN
• Tighten OAuth security by implementing OAuth 2.1 draft specification

Operating System Support#

We support installation of the VPN server software on the following operating systems:

• Debian >= 12
• Ubuntu LTS >= 22.04
• Fedora >= 40
• Enterprise Linux 9

Recommended OS: Debian 12

We will support future releases of the above operating systems as soon as they become available. We will never support “EOL” releases of operating systems, and only commit to support operating systems up to 1 year after a new version of that OS is available. Example: you MUST upgrade to Debian 12 within one year of its release.

Upgrading#

In case you are currently running eduVPN / Let’s Connect! 2.x on Debian 11 or 12 you can use the Upgrade Instructions to move to 3.x. Please note that your users will be forced to reauthorize the official apps and/or download a new configuration file from the portal.

However, it is HIGHLY RECOMMENDED, if at all possible, to perform a fresh installation of the 3.x server!

Issues#

If you find any issue, feel free to report it:

• Public Mailing List
• Issue Trackers
• Private Mailing List if you are in Research & Education

If you find issues with our documentation, some parts are not fully updated for 3.x yet, we’ll work with you to update the documentation when necessary so it will benefit all.

Client Applications#

All the official eduVPN / Let’s Connect! applications have been updated to support the 3.x server with both OpenVPN and WireGuard. Make sure all your clients are updated to their latest available version.

Full list of the available applications:

• eduVPN
• Let’s Connect!

Guest Access#

Guest Access (only available for NRENs, disabled by default) has switched to the new OAuth token format. It also “obfuscates” the local user identifiers now so they are not leaked to other servers by using a HMAC.

“Guest Access” is only available in vpn-user-portal >= 3.1.0.

Known Issues#

We are aware of the following issue(s) with 3.x:

• VPN clients (all platforms) will always appear “Connected” when using WireGuard, even if there is no VPN traffic (possible).

Changes#

The table below lists the changes to the release notes.