Benutzer-Werkzeuge

Webseiten-Werkzeuge


authentisierung

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
authentisierung [2017/02/22 12:58] – [Authentisierung gegen MySQL] lwsystemsauthentisierung [2020/08/25 17:22] (aktuell) lwsystems
Zeile 9: Zeile 9:
 Die Pflege der Benutzerdaten erfolgt auf der Konsole mit dem Kommando ''[[Benno-useradmin|benno-useradmin]]'' Die Pflege der Benutzerdaten erfolgt auf der Konsole mit dem Kommando ''[[Benno-useradmin|benno-useradmin]]''
  
 +===== Test der Authentisierung =====
 +
 +Mit Hilfe von ''benno-useradmin'' können die Authentisierungsmodule und die Rückgabewerte einfach getestet werden.
 +
 +<code>
 +# benno-useradmin -t -u admin
 +Password: 
 +50_benno_dbauth: Passwort fuer User lwsystems falsch.
 +ROLE USER
 +DISPLAYNAME LWsystems
 +MAIL lwsystems@lwsystems.intern
 +ARCHIVE BennoContainer
 +AUTH OK
 +</code>
 +
 +Das Passwort kann auch per Parameter //-p PASSWORT// übergeben werden.
 ====== Anmeldevorgang ====== ====== Anmeldevorgang ======
  
Zeile 15: Zeile 31:
 ===== Authentisierung gegen MySQL ===== ===== Authentisierung gegen MySQL =====
  
-Alternativ kann auch eine [[datenbank-schema#mysql_datenbank|MySQL Datenbank]] zur Speicherung der Benutzerdaten angebunden werden.Nach Konfiguration der Datenbank und einem Benutzer mit Schreib- und Leserechten für die DB wird dieAnbindung in der Datei /etc/benno-web/benno.conf konfiguriert.+Alternativ kann auch eine [[datenbank-schema#mysql_datenbank|MySQL Datenbank]] zur Speicherung der Benutzerdaten angebunden werden.Nach Konfiguration der Datenbank und einem Benutzer mit Schreib- und Leserechten für die DB wird die Anbindung in der Datei /etc/benno-web/benno.conf konfiguriert.
    
 <code> <code>
Zeile 28: Zeile 44:
 Die MySQL Tabellen werden wie [[datenbank-schema#mysql_datenbank|hier]] angegeben erzeugt.  Die MySQL Tabellen werden wie [[datenbank-schema#mysql_datenbank|hier]] angegeben erzeugt. 
  
-===== Externe Authentisierungs-Backends ===== +====== Externe Authentisierungs-Backends ======
- +
- +
-Zur Authentisierung gegen externe Backends bietet Benno MailArchiv eine [[Externe Authentisierungsschnittstelle|generische Schnittstelle]]. Hierbei wird ein externes Programm oder Script aufgerufen und diesem der Benutzername und das Passwort als Kommandozeilenargumente übergeben. Das Programm gibt das Ergebnis des Authentisierungsversuchs per STDOUT zurück. Im Erfolgsfall sind das die dem Benutzer zugeordneten Daten. Im Fehlerfall wird ein Fehlercode zurückgegeben, der im Web-UI einer Text-Meldung zugeordnet werden kann.  +
- +
-====== Konfiguration  ====== +
- +
-Die externe Authentisierung wird aktiviert, wenn in der Datei [[Benno.conf|/etc/benno-web/benno.conf]] der Parameter //EXTERNAL_AUTH// entkommentiert. +
-  +
-<code> +
-EXTERNAL_AUTH = /usr/lib/benno-web/benno_ldapauth +
-</code>  +
-  +
- +
-====== Authentisierungs-Protokoll  ====== +
- +
-Dem Programm werden Benutzername und Passwort per STDIN übergben. Ein Test des Authentisierungsmoduls kann daher wie folgt durchgeführt werden. Die Konfiguration der Authentisierung gegen LDAP wird im Artikel [[LDAP-Authentisierungsmodul]] beschrieben. +
- +
-<code> +
-echo "$USERNAME $PASSWORD" | /usr/lib/benno-web/benno_ldapauth +
-</code>  +
- +
-Im Falle einer erfolgreichen Authentisierung gibt das Modul mehrere Zeilen mit den Metadaten des Benutzers aus STDOUT zurück.  +
- +
-  +
-<code> +
-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 +
-</code> +
- +
-Falls ein Fehler auftritt, wird eine Zeile zurückgegeben, die mit ERROR beginnt. (z.B. "ERROR ERR_AUTH")  +
- +
-Nach dem ERROR wird mit Leerzeichen getrennt ein symbolischer für eine Fehlermeldung zurück gegeben. Die zugeordneten Fehlermeldungen sind in der Datei /etc/benno/benno-errors.txt hinterlegt und werden in der Nachrichtenbox der Anmeldemaske ausgegeben.   +
- +
-===== Metadaten-Parameter ===== +
- +
-==== ARCHIVE ==== +
- +
-Nach dem Schlüsselwort ARCHIVE wird die Bezeichnung des Containers 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|benno.xml.]] +
- +
-==== ROLE ====+
  
-Dieser Wert gibt an, ob der Benutzer ein einfacher Benutzer (USER), Admin (ADMIN) oder ein Revisor (REVISOR) ist. Im praktischen Betrieb hat der Wert derzeit keine Auswirkungen. Das mitgelieferte Authentisierungs-Modul setzt für Benutzer, die in der Datenbank auf ADMIN oder REVISOR gesetzt sind der Wert von MAIL auf //*@*//.+Zur Authentisierung gegen externe Backends bietet Benno MailArchiv eine [[Externe Authentisierungsschnittstelle|generische Schnittstelle]]. Hierbei wird ein externes Programm oder Script aufgerufen und diesem der Benutzername und das Passwort als Kommandozeilenargumente übergeben. Das Programm gibt das Ergebnis des Authentisierungsversuchs per STDOUT zurück.
  
-==== DISPLAYNAME ==== +Ein externes Authentisierungs-Backend kann relativ einfach durch ein Programms, welches das [[Authentisierungs-Protokoll|Authentisierungs-Protokolls]] implementiert, erstellt werden.
-Der Name des Benutzers zur Anzeige im Web-UI.+
  
-==== MAIL ==== +Im Erfolgsfall sind das die dem Benutzer zugeordneten Daten. Im Fehlerfall wird ein Fehlercode zurückgegeben, der im Web-UI einer Text-Meldung zugeordnet werden kann
-Dieser Wert setzt den Filter der anzuzeigenden E-Mails. Er sollte alle E-Mail Adressen enthalten, die der Benuzter lesen darf.+
  
-Jede MAIL-Zeile enthält eine E-Mail Adresse, deren Mails der Benutzer lesen kann. Dieser Wert kann als Lucene Filterstring ausgeführt werden, so daß Wildcards möglich sind. 
authentisierung.1487768338.txt.gz · Zuletzt geändert: 2017/02/22 12:58 von lwsystems