eurephia_init(7)

Initialisation utility for the eurephia OpenVPN plug-in.

Section 7 eurephia bookworm source

Description

eurephia_init

NAME

eurephia_init - Initialisation utility for the eurephia OpenVPN plug-in.

SYNOPSIS

DESCRIPTION

This utility is only supposed to be used when installing eurephia. The purpose is to initialise the database eurephia will use, by setting up some standard configuration values and create an administrator account

OPTIONS

Arguments used by eurephia_init:
-V | --version

Show version information

-h | --help

This help screen

-l | --log <filename>

Log file for debugging

-L | --log-level <log level>

Sets the log level

	-N \| --hash-threshold-min <ms> : Benchmarking parameter, see below. Default 95ms
	-M \| --hash-threshold-max <ms> : Benchmarking parameter, see below. Default 200ms

-D | --database-driver <full path>

Full path to the database driver (Required)

-d | --database-args <arguments>

Required database arguments for the driver (Required)

BENCHMARKING

During the initialisation this utility will benchmark the CPU power by
doing multiple SHA512 hash calculations. This is to determinate the
optimal rounds the password hashes should use on the current computer. To
make it more difficult to brute force passwords, eurephia implements
dynamic password hash rounds, based on a random number within in a given
range. This benchmark will suggest an optimal range. To do this, two
limits are defined, the shortest time and the longest time to be used for
calculating a hash. The default values are 95ms and 200ms.
If you want to modify those thresholds, you can do so with the
--hash-threshold-min and --hash-threshold-max options. By increasing these
numbers, you will allow the number of rounds to be increased.