eurephiadm - Man Page

eurephia administration utility

Synopsis

eurephiadm <command> [-h|--help] [-V|--version] [<global options>] [-l|--log <filename>] [-L|--log-level <log level>] [<command arguments>]

Description

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

Commands

Available commands in eurephiadm

help [<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

~/.eurephia/eurephiadm.cfg

Default configuration file which defines the database driver and the needed database parameters.

Configuration File

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.

username

eurephiadm 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.

See Also

eurephiadm-users(7), eurephiadm-lastlog(7), eurephiadm-attempts(7), eurephiadm-blacklist(7), eurephiadm-certs(7), eurephiadm-usercerts(7), eurephiadm-fwprofiles(7), eurephiadm-adminaccess(7), eurephiadm-config(7), edb-sqlite(7)

Author

Copyright (C) 2008-2012  David Sommerseth <dazo@users.sourceforge.net>

Referenced By

edb-sqlite(7), eurephiadm-adminaccess(7), eurephiadm-config(7), eurephiadm-fwprofiles(7), eurephiadm-lastlog(7), eurephiadm-users(7).

July 2010 David Sommerseth