NAME

SYNOPSIS

DESCRIPTION

eurephiadm is a generic command line tool for administering and
configuring the eurephia plug-in for OpenVPN.

COMMANDS

Available commands in eurephiadmhelp [<command>]
This help screen if no arguments are given. If a command is
given, the help screen for that command is provided.
logout Logout from an active eurephiadm session. Most of the
operations in eurephiadm requires the user to authenticate
him/herself. The session will then be active for a predefined
amount of time, not requiring new authentications. The user
will have to authenticate him/herself again if the session
timesout or the logout command is used.
users [<arguments>]
User management module. Lists, adds, removes, activates,
deactivates and shows user account information for each eurephia
user.
lastlog
Query the eurephia lastlog. This log contains information about
OpenVPN session authenticated via eurephia.
attempts [<arguments>]
Show or reset registered failed login attempts registrations.
blacklist [<arguments>]
Show, add or delete blacklisted user accounts, certificates or
IP addresses.
certs [<arguments>]
SSL Certificate management for eurephia authentication.
usercerts [<arguments>]
Manages the relations between eurephia user accounts and
certificates. This combination is called a user access, and
defines which access level the authenticated eurephia user will
have to the network.
fwprofiles [<arguments>]
Firewall profile management. Add, list or delete (iptables)
profiles available for eurephia in the operating system. This
feature is only available if eurephiadm was compiled with
firewall support.
adminaccess [<arguments>]
Manages eurephia user accesses to administration utilities like
eurephiadm.
show-config
List all config settings set in the database and in the
~/.eurephia/eurephiadm.cfg file.
show-configfile
Similar to the show-config command, but lists only the parsed
settings in the ~/.eurephia/eurephiadm.cfg file.
config [<arguments>]
Add, delete or show eurephia configuration settings stored in
the database.

FILES

CONFIGURATIONFILE

The configuration file is a simple key-value based text file, where
keys and values are separated by an equal sign ("="). All text coming
after a hash ("#") will be ignored and considered as comments. The
variables eurephiadm uses are:
database_driver
Contains a full path to the database driver eurephiadm need to
use.
database_params
All database arguments the database driver requires must be set
here. See the man page for the corresponding database driver
for more information about valid options.
log Defines how to log. If a file name is given, logging will be
sent to this log file. Other valid values are:
stderr: or stdout:
Logging will go directly to stderr or stdout
syslog:[local0..local7|daemon|authpriv]
Logging will be sent to syslog. The default syslog destination
is daemon.log_level
Sets the log verbosity. Normally the values will be from 0 to
10, where 0 is as little logging as possible and 10 is very
verbose. If eurephiadm or the database driver is compiled with
debug logging, values up to 50 will be valid.
usernameeurephiadm will always be asking for a user name when logging
into the administration application. By setting this variable,
you will set a default user name eurephiadm will use when
logging in and it will only ask for a password directly.

ENVIRONMENT

EUREPHIA_DIR
The eurephiadm utility looks for a configuration file by default
in ~/.eurephia/eurephiadm.cfg. This directory can be overridden
by setting the EUREPHIA_DIR environment variable, and eurephiadm
will use the eurephiadm.cfg file in this directory instead.