Provided by:
eurephia_1.0.1-3build1_i386 
NAME
eurephia-auth - The eurephia OpenVPN authentication plug-in
DESCRIPTION
The eurephia-auth.so is a plug-in for OpenVPN. It is loaded by
providing the --plugin option in the OpenVPN configuration.
The syntax for OpenVPN and eurephia-auth is:
plugin eurephia-auth.so "<plugin args> -- <DB args>"
Please notice the quotes and the double dash. They are important
markers so that the eurephia-auth module receives all arguments (the
quotes) and that it knows when to pass on the rest of the arguments to
the defined database driver, separated by the double dash. This manual
page will only look at the <plugin args> options. For the <DB args>
options, refer to the corresponding database driver you are using.
OPTIONS
--log-destination | -l
This defines how eurephia will do its logging. It can take a
filename to log to a file. If the string is openvpn: it will
pass the log data over to OpenVPN, which will combine the
OpenVPN and eurephia logs. You can also log via syslog, by
indicating syslog:. The last possible special value is none:
which will disable logging completely.
With syslog: you can also define which syslog facility the
logging will go to. The default is to log to the user facility.
Other supported facilities are authpriv, daemon and local0 to
local7. To send log data to the daemon the --log-destination
argument need to be
--log-destination syslog:daemon
--log-level | -L
This defines how verbose the eurephia logging will be. The
required argument to this option must be a numeric value, where
0 indicates as little logging as possible - only giving
informative messages, or a high value like 50 to give really
verbose logging. In general a log level less than 4 should be
more than enough under normal circumstances.
NOTICE: The highest log level is 10, unless the eurephia-auth
modules have been compiled with debug features.
--database-interface | -i
This argument must have a full path to the eurephia database
driver module. This defines which database interface eurephia
will use.
OPENVPN CLIENTS
The only change the OpenVPN clients needs to do is to add
auth-user-pass
to their configuration file. This instructs the OpenVPN client to ask
for user name and password when starting the connection.
SEE ALSO
eurephia-sqlite(8), eurephia_init(8)
AUTHOR
Copyright (C) 2008-2010 David Sommerseth <dazo@users.sourceforge.net>