1eurephiadm(7) eurephiadm(7)
2
6 eurephiadm - eurephia administration utility
7
9 eurephiadm <command> [-h|--help] [-V|--version] [<global options>]
10 [-l|--log <filename>] [-L|--log-level <log level>] [<command argu‐
11 ments>]
12
14 eurephiadm is a generic command line tool for administering and config‐
15 uring the eurephia plug-in for OpenVPN.
16
18 Available commands in eurephiadm
19 help [<command>]
21 This help screen if no arguments are given. If a command is
22 given, the help screen for that command is provided.
23 logout Logout from an active eurephiadm session. Most of the opera‐
25 tions in eurephiadm requires the user to authenticate him/her‐
26 self. The session will then be active for a predefined amount
27 of time, not requiring new authentications. The user will have
28 to authenticate him/herself again if the session timesout or the
29 logout command is used.
30 users [<arguments>]
32 User management module. Lists, adds, removes, activates, deac‐
33 tivates and shows user account information for each eurephia
34 user.
35 lastlog
37 Query the eurephia lastlog. This log contains information about
38 OpenVPN session authenticated via eurephia.
39 attempts [<arguments>]
41 Show or reset registered failed login attempts registrations.
42 blacklist [<arguments>]
44 Show, add or delete blacklisted user accounts, certificates or
45 IP addresses.
46 certs [<arguments>]
48 SSL Certificate management for eurephia authentication.
49 usercerts [<arguments>]
51 Manages the relations between eurephia user accounts and cer‐
52 tificates. This combination is called a user access, and
53 defines which access level the authenticated eurephia user will
54 have to the network.
55 fwprofiles [<arguments>]
57 Firewall profile management. Add, list or delete (iptables)
58 profiles available for eurephia in the operating system. This
59 feature is only available if eurephiadm was compiled with fire‐
60 wall support.
61 adminaccess [<arguments>]
63 Manages eurephia user accesses to administration utilities like
64 eurephiadm.
65 show-config
67 List all config settings set in the database and in the
68 ~/.eurephia/eurephiadm.cfg file.
69 show-configfile
71 Similar to the show-config command, but lists only the parsed
72 settings in the ~/.eurephia/eurephiadm.cfg file.
73 config [<arguments>]
75 Add, delete or show eurephia configuration settings stored in
76 the database.
77
79 ~/.eurephia/eurephiadm.cfg
80 Default configuration file which defines the database driver and
81 the needed database parameters.
82
84 The configuration file is a simple key-value based text file, where
85 keys and values are separated by an equal sign ("="). All text coming
86 after a hash ("#") will be ignored and considered as comments. The
87 variables eurephiadm uses are:
88 database_driver
90 Contains a full path to the database driver eurephiadm need to
91 use.
92 database_params
94 All database arguments the database driver requires must be set
95 here. See the man page for the corresponding database driver
96 for more information about valid options.
97 log Defines how to log. If a file name is given, logging will be
99 sent to this log file. Other valid values are:
100 stderr: or stdout:
102 Logging will go directly to stderr or stdout
103 syslog:[local0..local7 | daemon | authpriv]
105 Logging will be sent to syslog. The default syslog destination
106 is daemon.
107 log_level
109 Sets the log verbosity. Normally the values will be from 0 to
110 10, where 0 is as little logging as possible and 10 is very ver‐
111 bose. If eurephiadm or the database driver is compiled with
112 debug logging, values up to 50 will be valid.
113 username
115 eurephiadm will always be asking for a user name when logging
116 into the administration application. By setting this variable,
117 you will set a default user name eurephiadm will use when log‐
118 ging in and it will only ask for a password directly.
119
121 EUREPHIA_DIR
122 The eurephiadm utility looks for a configuration file by default
123 in ~/.eurephia/eurephiadm.cfg. This directory can be overridden
124 by setting the EUREPHIA_DIR environment variable, and eurephiadm
125 will use the eurephiadm.cfg file in this directory instead.
126
128 eurephiadm-users(7), eurephiadm-lastlog(7), eurephiadm-attempts(7),
129 eurephiadm-blacklist(7), eurephiadm-certs(7), eurephiadm-usercerts(7),
130 eurephiadm-fwprofiles(7), eurephiadm-adminaccess(7), eurephiadm-con‐
131 fig(7), edb-sqlite(7)
132
134 Copyright (C) 2008-2012 David Sommerseth <dazo@users.sourceforge.net>
135David Sommerseth July 2010 eurephiadm(7)