projekt kivitendo

6 Benutzerauthentifizierung und Administratorpasswort

  6.1 Grundlagen zur Benutzerauthentifizierung

  6.2 Administratorpasswort

  6.3 Authentifizierungsdatenbank

  6.4 Passwort?berpr?fung

  6.5 Name des Session-Cookies

  6.6 Anlegen der Authentifizierungsdatenbank

7 Benutzer- und Gruppenverwaltung

  7.1 Zusammenh?nge

  7.2 Datenbanken anlegen

  7.3 Gruppen anlegen

  7.4 Benutzer anlegen

  7.5 Gruppenmitgliedschaften verwalten

  7.6 Migration alter Installationen

8 OpenDocument-Vorlagen

9 Lx-Office ERP verwenden

6 Benutzerauthentifizierung und Administratorpasswort

*****************************************************

Informationen ?ber die Einrichtung der Benutzerauthentifizierung, ?ber

die Verwaltung von Gruppen und weitere Einstellungen

6.1 Grundlagen zur Benutzerauthentifizierung

============================================

Lx-Office verwaltet die Benutzerinformationen in einer Datenbank, die

im folgenden "Authentifizierungsdatenbank" genannt wird. F?r jeden

Benutzer kann dort eine eigene Datenbank f?r die eigentlichen

Finanzdaten hinterlegt sein. Diese beiden Datenbanken k?nnen, m?ssen

aber nicht unterschiedlich sein.

   Im einfachsten Fall gibt es f?r Lx-Office nur eine einzige Datenbank,

in der sowohl die Benutzerinformationen als auch die Daten abgelegt

werden.

   Zus?tzlich erm?glicht es Lx-Office, dass die Benutzerpassw?rter

entweder gegen die Authentifizierungsdatenbank oder gegen einen

LDAP-Server ?berpr?ft werden.

   Welche Art der Passwort?berpr?fung Lx-Office benutzt und wie

Lx-Office die Authentifizierungsdatenbank erreichen kann, wird in der

Konfigurationsdatei `config/authentication.pl' festgelegt. Diese muss

bei der Installation und bei einem Upgrade von einer Version vor v2.4.4

angelegt werden. Eine Beispielkonfigurationsdatei

`config/authentication.pl.default' existiert, die als Vorlage benutzt

werden kann.

6.2 Administratorpasswort

=========================

Das Passwort, das zum Zugriff auf das Aministrationsinterface benutzt

wird, wird ebenfalls in dieser Datei gespeichert. Es kann auch nur dort

und nicht mehr im Administrationsinterface selber ge?ndert werden. Der

Parameter dazu hei?t `$self->{admin_password}'.

6.3 Authentifizierungsdatenbank

===============================

Die Verbindung zur Authentifizierungsdatenbank wird mit den Parametern

in `$self->{DB_config}' konfiguriert. Hier sind die folgenden Parameter

anzugeben:

   * `host' - Der Rechnername oder die IP-Adresse des Datenbankservers

   * `port' - Die Portnummer des Datenbankservers, meist 5432

   * `db' - Der Name der Authentifizierungsdatenbank

   * `user' - Der Benutzername, mit dem sich Lx-Office beim

     Datenbankserver anmeldet (z.B. "postgres")

   * `password' - Das Passwort f?r den Datenbankbenutzer

   Die Datenbank muss noch nicht existieren. Lx-Office kann sie

automatisch anlegen (mehr dazu siehe unten).

6.4 Passwort?berpr?fung

=======================

Lx-Office unterst?tzt Passwort?berpr?fung auf zwei Arten: gegen die

Authentifizierungsdatenbank und gegen einen externen LDAP- oder

Active-Directory-Server. Welche davon benutzt wird, regelt der

Parameter `$self->{module}'.

   Sollen die Benutzerpassw?rter in der Authentifizierungsdatenbank

gespeichert werden, so muss der Parameter `$self->{module}' den Wert

`DB' enthalten. In diesem Fall k?nnen sowohl der Administrator als auch

die Benutzer selber ihre Psasw?rter in Lx-Office ?ndern.

   Soll hingegen ein externer LDAP- oder Active-Directory-Server benutzt

werden, so muss der Parameter `$self->{module}' auf `LDAP' gesetzt

werden. In diesem Fall m?ssen zus?tzliche Informationen ?ber den

LDAP-Server in `$self->{LDAP_config}' angegeben werden:

   * `host' - Der Rechnername oder die IP-Adresse des LDAP- oder

     Active-Directory-Servers. Diese Angabe ist zwingend erforderlich.

   * `port' - Die Portnummer des LDAP-Servers; meist 389.

   * `tls' - Wenn Verbindungsverschl?sselung gew?nscht ist, so diesen

     Wert auf `1' setzen, andernfalls auf `0' belassen

   * `attribute'' - Das LDAP-Attribut, in dem der Benutzername steht,

     den der Benutzer eingegeben hat. F?r Active-Directory-Server   ist

     dies meist `sAMAccountName', f?r andere LDAP-Server hingegen

     `uid'. Diese Angabe ist zwingend erforderlich.

   * `base_dn' - Der Abschnitt des LDAP-Baumes, der durchsucht werden

     soll. Diese Angabe ist zwingend erforderlich.

   * `filter' - Ein optionaler LDAP-Filter. Enth?lt dieser Filter das

     Wort `<%login%>', so wird dieses durch den vom Benutzer

     eingegebenen Benutzernamen ersetzt. Andernfalls wird der LDAP-Baum

     nach einem Element durchsucht, bei dem das oben angegebene Attribut

      mit dem Benutzernamen identisch ist.

   * `bind_dn' und `bind_password' - Wenn der LDAP-Server eine

     Anmeldung erfordert, bevor er durchsucht werden kann (z.B. ist

     dies bei   Active-Directory-Servern der Fall), so kann diese hier

     angegeben werden. F?r Active-Directory-Server kann als `bind_dn'

     entweder eine   komplette LDAP-DN wie z.B. `cn=Martin

     Mustermann,cn=Users,dc=firmendomain' auch nur der volle Name des

     Benutzers   eingegeben werden; in diesem Beispiel also `Martin

     Mustermann'.

6.5 Name des Session-Cookies

============================

Sollen auf einem Server mehrere Lx-Office-Installationen aufgesetzt

werden, so m?ssen die Namen der Session-Cookies f?r alle Installationen

unterschiedlich sein. Der Name des Cookies wird mit dem Parameter

`$self->{cookie_name}' gesetzt.

   Diese Angabe ist optional, wenn nur eine Installation auf dem Server

existiert.

6.6 Anlegen der Authentifizierungsdatenbank

===========================================

Nachdem alle Einstellungen in `config/authentication.pl' vorgenommen

wurden, muss Lx-Office die Authentifizierungsdatenbank anlegen. Dieses

geschieht automatisch, wenn Sie sich im Administrationsmodul anmelden,

das unter der folgenden URL erreichbar sein sollte:

   `http://localhost/lx-erp/admin.pl'

7 Benutzer- und Gruppenverwaltung

*********************************

Nach der Installation m?ssen Benutzer, Gruppen und Datenbanken angelegt

werden.  Dieses geschieht im Administrationsmen?, dass Sie unter

folgender URL finden:

   Verwenden Sie zur Anmeldung das Password, dass Sie in der Datei

`config/authentication.pl' eingetragen haben.

7.1 Zusammenh?nge

=================

Lx-Office verwendet eine Datenbank zum Speichern all seiner

Informationen wie Kundendaten, Artikel, Angebote, Rechnungen etc. Um

mit Lx-Office arbeiten zu k?nnen, muss eine Person einen

Benutzeraccount haben. Jedem Benutzeraccount wiederum wird genau eine

Datenbank zugewiesen, mit der dieser Benutzer arbeiten kann. Es ist

m?glich und normal, dass mehreren Benutzern die selbe Datenbank

zugewiesen wird, sodass sie alle mit den selben Daten arbeiten k?nnen.

   Die Basisdaten der Benutzer, die in der Administration eingegeben

werden k?nnen, werden in einer zweiten Datenbank gespeichert, der

bereits erw?hnten Authentifizierungsdatenbank. Diese ist also den

Produktivdaten enthaltenden Datenbanken vorgeschaltet. Pro

Lx-Office-Installation gibt es nur eine Authentifizierungsdatenbank,

aber beliebig viele Datenbanken mit Firmendaten.

   Lx-Office lann seinen Benutzern Zugriff auf bestimmte

Funktionsbereiche erlauben oder verbieten. Wird der Zugriff nicht

gestattet, so werden der entsprechenden Men?punkte auch nicht

angezeigt. Diese Rechte werden ebenfalls in der

Authentifizierungsdatenbank gespeichert.

   Um Rechte verteilen zu k?nnen, verwendet Lx-Office ein

Gruppen-Prinzip. Einer Gruppe kann der Zugriff auf bestimmte Bereiche

erlaubt werden. Ein Benutzer wiederum kann Mitglied in einer oder

mehrerer Gruppen sein. Der Benutzer hat Zugriff auf alle diejenigen

Funktionen, die mindestens einer Gruppe erlaubt sind, in der der

Benutzer Mitglied ist.

   Die allgemeine Reihenfolge, in der Datenbanken, Gruppen und Benutzer

angelegt werden sollten, lautet:

  1. Datenbank anlegen

  2. Gruppen anlegen

  3. Benutzer anlegen

  4. Benutzer den Gruppen zuordnen

7.2 Datenbanken anlegen

=======================

Zuerst muss eine Datenbank angelegt werden. Verwenden Sie f?r den

Datenbankzugriff den vorhin angelegten Benutzer (in unseren Beispielen

ist dies `lxoffice').

m?ssen Sie vor dem Anlegen der Datenbank in der Datei

`config/lx-erp.conf' die Variable `$dbcharset' auf den Wert `UTF-8'

setzen. Zus?tzlich muss beim Anlegen der Datenbank `UTF-8 Unicode' als

Schriftsatz ausgew?hlt werden.

   Bitte beachten Sie, dass alle Datenbanken den selben Zeichensatz

verwenden m?ssen, da diese Einstellungen momentan global in Lx-Office

vorgenommen wird und nicht nach Datenbank unterschieden werden kann.

Auch die Authentifizierungsdatenbank muss mit diesem Zeichensatz

angelegt worden sein.

7.3 Gruppen anlegen

===================

Eine Gruppe wird in der Gruppenverwaltung angelegt. Ihr muss ein Name

gegeben werden, eine Beschreibung ist hingegen optional. Nach dem

Anlegen k?nnen Sie die verschiedenen Bereiche w?hlen, auf die

Mitglieder dieser Gruppe Zugriff haben sollen.

   Benutzergruppen sind unabh?ngig von Datenbanken, da sie in der

Authentifizierungsdatenbank gespeichert werden. Sie gelten f?r alle

Datenbanken, die in dieser Installation verwaltet werden.

7.4 Benutzer anlegen

====================

Beim Anlegen von Benutzern werden f?r viele Parameter

Standardeinstellungen vorgenommen, die den Gepflogenheiten des

deutschen Raumes entsprechen.

   Zwingend anzugeben sind der Loginname sowie die komplette

Datenbankkonfiguration. Wenn die Passwortauthentifizierung ?ber die

Datenbank eingestellt ist, so kann hier auch das Benutzerpasswort

gesetzt bzw. ge?ndert werden. Ist hingegen die LDAP-Authentifizierung

aktiv, so ist das Passwort-Feld deaktiviert.

   In der Datenbankkonfiguration m?ssen die Zugriffsdaten einer der eben

angelegten Datenbanken eingetragen werden.

7.5 Gruppenmitgliedschaften verwalten

=====================================

Nach dem Anlegen von Benutzern und Gruppen m?ssen Benutzer den Gruppen

zugewiesen werden. Dazu gibt es zwei M?glichkeiten:

  1. In der Gruppenverwaltung w?hlt man eine Gruppe aus. Im folgenden

     Dialog kann man dann einzeln die Benutzer der Gruppe hinzuf?gen.

  2. In der Gruppenverwaltung w?hlt man das Tool zur Verwaltung der

     Gruppenmitgliedschaft. Hier wird eine Matrix angezeigt, die alle im

     System angelegten Gruppen und Benutzer enth?lt. Durch Setzen der

     H?kchen wird der Benutzer in der ausgew?hlten Zeile der Gruppe in

     der ausgew?hlten Spalte hinzugef?gt.

7.6 Migration alter Installationen

==================================

Wenn Lx-Office 2.4.4 ?ber eine ?ltere Version installiert wird, in der

die Benutzerdaten noch im Dateisystem im Verzeichnis `users' verwaltet

wurden, so bietet Lx-Office die M?glichkeit, diese Benutzerdaten

automatisch in die Authentifizierungsdatenbank zu ?bernehmen. Dies

geschieht, wenn man sich nach dem Update der Installation das erste Mal

im Administrationsbereich anmeldet. Findet Lx-Office die Datei

`users/members', so wird der Migrationsprozess gestartet.

   Der Migrationsprozess ist nahezu vollautomatisch. Alle Benutzerdaten

k?nnen ?bernommen werden. Nach den Benutzerdaten bietet Lx-Office noch

die M?glichkeit an, dass automatisch eine Benutzergruppe angelegt wird.

Dieser Gruppe wird Zugriff auf alle Funktionen von Lx-Office gew?hrt.

Alle migrierten Benutzern werden Mitglied in dieser Gruppe. Damit wird

das Verhalten von Lx-Office bis Version 2.4.3 inklusive

wiederhergestellt, und die Benutzer k?nnen sich sofort wieder anmelden

und mit dem System arbeiten.

8 OpenDocument-Vorlagen

OpenDocument-Vorlagen zu aktivieren muss in der Datei

`config/lx-erp.conf' die Variable `$opendocument_templates' auf `1'

stehen.  Dieses ist die Standardeinstellung.

   Weiterhin muss in der Datei `config/lx-erp.conf' die Variable

`$dbcharset' auf die Zeichenkodierung gesetzt werden, die auch bei der

Speicherung der Daten in der Datenbank verwendet wird. Diese ist in den

meisten F?llen "ISO-8859-15".

   Nach der Installation m?ssen in der Datei `config/lx-erp.conf' zwei

weitere Variablen angepasst werden: `$openofficeorg_writer_bin' muss

den vollst?ndigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.

9 Lx-Office ERP verwenden