INTRODUCTION

The openvpn-auth-ldap plugin implements username/password authentication via LDAP.

You may send patches, bug reports, and complaints to: landonf@threerings.net

REQUIREMENTS

• OpenLDAP Headers & Library
• GNU Objective-C Compiler
• OpenVPN Plugin Header (included with the OpenVPN sources)
• re2c (http://www.re2c.org)

BUILD

To build, you will need to configure the sources appropriately. Example: ./configure --prefix=/usr/local --with-openldap=/usr/local --with-openvpn=/usr/ports/security/openvpn/work/openvpn-2.0.2

The module will be build in src/openvpn-auth-ldap.so and installed as ${prefix}/lib/openvpn-auth-ldap.so.

USAGE

Add the following to your OpenVPN configuration file (adjusting the plugin path as required):

plugin /usr/local/lib/openvpn-auth-ldap.so "<config>"

The config directive must point to an auth-ldap configuration file. An example is provided with the distribution.

CAVEATS

This plugin only works with the OpenLDAP libraries.