NAME

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