Skip to content

Simple openvpn plugin to do deferred authentication requests

License

Notifications You must be signed in to change notification settings

mozilla-it/openvpn_defer_auth

Repository files navigation

openvpn_defer_auth

This is a VERY simple openvpn plugin to do deferred authentication requests.

Why do this?

When doing MFA (multifactor authentication), it is common to require human interaction. That introduces a time delay to the authentication process, and openvpn blocks waiting for a reply. One person being asleep can hang your whole server.

Configuration

After installing the openvpn_defer_auth.so file, add something like this to your openvpn config:

plugin /usr/lib64/openvpn/plugins/openvpn_defer_auth.so /usr/lib/openvpn/plugins/duo_openvpn.py

This tells openvpn to use your plugin... and your plugin will fork+exec THAT executable (in the above example case, a 'duo_openvpn' python script) to do the authentication and return success/failure.

Building

There is a build_notes subdirectory explaining the methodology of how to build this plugin. Essentially, how we get from 'sample code distributed by openvpn' to 'our plugin'.

License

This library's source is shipped under a GPLv2 license, the same as OpenVPN 2.

The plugin is greatly derived from their sample code.

Compatibility

The plugin was tested against 2.4.6 initially, and has worked through-and-including 2.6.12.

About

Simple openvpn plugin to do deferred authentication requests

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published