mirror of
https://github.com/adulau/ootp.git
synced 2024-11-22 01:57:08 +00:00
166 lines
3.2 KiB
Text
166 lines
3.2 KiB
Text
<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
|
|
|
|
<!-- $Id: otp-ov-plugin.sgml 177 2011-05-16 02:37:28Z maf $ -->
|
|
|
|
<refentry>
|
|
|
|
<refmeta>
|
|
<refentrytitle>
|
|
<application>otp-ov-plugin</application>
|
|
</refentrytitle>
|
|
<manvolnum>1</manvolnum>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>
|
|
<application>otp-ov-plugin</application>
|
|
</refname>
|
|
<refpurpose>
|
|
OpenVPN plug-in authentication module for OTP database.
|
|
</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>otp-ov-plugin</command>
|
|
<arg>-?hv</arg>
|
|
<arg>-o<replaceable> otpdb_fname</replaceable></arg>
|
|
<arg>-V<replaceable> service_name</replaceable></arg>
|
|
<arg>-w<replaceable> otp_window</replaceable></arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
|
|
<refsect1>
|
|
<title>DESCRIPTION</title>
|
|
<para>
|
|
The <command>otp-ov-plugin</command> command is plug-in authentication
|
|
module for OpenVPN authenticating to the OTP database. The username
|
|
and password (challenge response) are passed via environment variables
|
|
<emphasis>user</emphasis> and <emphasis>pass</emphasis>.
|
|
A successful authentication will set a return code of
|
|
<returnvalue>0</returnvalue>, authentication failure
|
|
<returnvalue>1</returnvalue>, and program failure
|
|
<returnvalue>-1</returnvalue>.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>OPTIONS</title>
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term>-h, --help</term>
|
|
<listitem>
|
|
<para>
|
|
Help
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>-o, --otp-db=<replaceable> otpdb_pathname</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Pathname of OTP database.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>-u, --otp-allow-unknown-user</term>
|
|
<listitem>
|
|
<para>
|
|
Allow users which do not exist in the OTP database to successfully
|
|
authenticate without using a One Time Password.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>-V, --service-name=<replaceable> service_name</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
Set service name for send-token function.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>-v, --verbose</term>
|
|
<listitem>
|
|
<para>
|
|
Verbose
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>-w, --otp-challenge-window=</term>
|
|
<listitem>
|
|
<para>
|
|
Set the OTP challenge window.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>--version</term>
|
|
<listitem>
|
|
<para>
|
|
Display software version.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>EXAMPLES</title>
|
|
|
|
<informalexample>
|
|
<para>
|
|
Test the module with user bob.
|
|
</para>
|
|
<para>
|
|
<command>export user="bob"</command>
|
|
</para><para>
|
|
<command>export pass="882B0E8410"</command>
|
|
</para><para>
|
|
<command>otp-ov-plugin; echo $?</command>
|
|
</para>
|
|
<screen>
|
|
1
|
|
</screen>
|
|
</informalexample>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>AUTHOR</title>
|
|
<para>
|
|
<author>
|
|
<firstname>Mark</firstname>
|
|
<surname>Fullmer</surname>
|
|
</author>
|
|
<email>maf@splintered.net</email>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>SEE ALSO</title>
|
|
<para>
|
|
<application>otp-sca</application>(1)
|
|
<application>otp-sct</application>(1)
|
|
<application>otp-control</application>(1)
|
|
<application>pam_otp</application>(1)
|
|
<application>htsoft-downloader</application>(1)
|
|
<application>urd</application>(1)
|
|
<application>bcload</application>(1)
|
|
<application>OpenVPN</application>(8)
|
|
<hardware>spyrus-par2</hardware>(7)
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|