Dem Programm werden Benutzername und Passwort zeilenweise per STDIN übergben. Ein Test des Authentisierungsmoduls kann daher wie folgt durchgeführt werden.

echo -e "${USERNAME}\n${PASSWORD}" | /usr/lib/benno-web/benno_ldapauth

In the event of successful authentication, the module returns several lines containing the user's metadata from STDOUT.

ARCHIVE BennoContainer ROLE USER DISPLAYNAME Sabine Petersen MAIL info@hansen-und-meyer.de MAIL s.petersen@hansen-und-meyer.de MAIL sabine.petersen@hansen-und-meyer.de USERID s.petersen AUTH OK

If an error occurs, a line beginning with ERROR is returned (e.g., "ERROR ERR_AUTH")

After the ERROR, a symbolic error message is returned, separated by spaces. The associated error messages are stored in the file /etc/benno/benno-errors.txt and are displayed in the message box of the login screen.

Nach dem Schlüsselwort ARCHIVE wird die Bezeichnung des Containers (in der Regel der <simplecontainer />) zurückgegeben, auf den in dieser Session User zugegriffen werden soll. Dieser Wert bezieht sich auf den jeweiligen Inhalte des <identifier>…</identifier> Tags in der Konfigurationsdatei benno.xml.

This value indicates whether the user is a regular user (USER), administrator (ADMIN), or auditor (REVISOR). In practical operation, this value currently has no effect. The included authentication module sets the value of MAIL to for users who are set to ADMIN or REVISOR in the database *@*.

The user's name for display in the web UI.

This value sets the filter for emails to be displayed. It should contain all email addresses that the user is allowed to read.

Each MAIL line contains an email address whose emails the user can read. This value can be executed as a Lucene filter string, allowing for wildcards.

Optionaler Rückgabewert wie zum Beispiel <username>@<mandantenbezeichnung>. Falls dieser Wert gesetzt ist, werden die temporären Daten des Bentzers mit dieser ID in der internen Datenbank zwischengespeichert.

The value of USERID must system-wide .

This line indicates that authentication was successful.

Der <Warnungstext> wird im Logfile des Webservers ausgegeben.

Diese Werte überschreiben die in der Konfigurationsdatei /etc/benno-web/rest.conf voreingestellten Werte.

The URL of the REST backend that the user should access in the session. For example, http://localhost:21080.

Username for authentication on the REST interface.

Password for authentication on the REST interface.