Revision 23bb6a8c
Von Bernd Bleßmann vor 12 Monaten hinzugefügt
| doc/html/ch02s09.html | ||
|---|---|---|
|
<html><head>
|
||
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
|
<title>2.9. Benutzerauthentifizierung und Administratorpasswort</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.8.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s08.html" title="2.8. Der Task-Server"><link rel="next" href="ch02s10.html" title="2.10. Mandanten-, Benutzer- und Gruppenverwaltung"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.9. Benutzerauthentifizierung und Administratorpasswort</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s08.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s10.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.9. Benutzerauthentifizierung und Administratorpasswort"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Benutzerauthentifizierung-und-Administratorpasswort"></a>2.9. Benutzerauthentifizierung und Administratorpasswort</h2></div></div></div><p>Informationen über die Einrichtung der Benutzerauthentifizierung,
|
||
|
über die Verwaltung von Gruppen und weitere Einstellungen</p><div class="sect2" title="2.9.1. Grundlagen zur Benutzerauthentifizierung"><div class="titlepage"><div><div><h3 class="title"><a name="Grundlagen-zur-Benutzerauthentifizierung"></a>2.9.1. Grundlagen zur Benutzerauthentifizierung</h3></div></div></div><p>kivitendo 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.</p><p>Im einfachsten Fall gibt es für kivitendo nur eine einzige
|
||
|
Datenbank, in der sowohl die Benutzerinformationen als auch die Daten
|
||
|
abgelegt werden.</p><p>Zusätzlich ermöglicht es kivitendo, dass die Benutzerpasswörter gegen die Authentifizierungsdatenbank oder gegen einen oder
|
||
|
mehrere LDAP-Server überprüft werden.</p><p>Welche Art der Passwortüberprüfung kivitendo benutzt und wie
|
||
|
kivitendo die Authentifizierungsdatenbank erreichen kann, wird in der
|
||
|
Konfigurationsdatei <code class="filename">config/kivitendo.conf</code>
|
||
|
festgelegt. Diese muss bei der Installation und bei einem Upgrade von
|
||
|
einer Version vor v2.6.0 angelegt werden. Eine
|
||
|
Beispielkonfigurationsdatei
|
||
|
<code class="filename">config/kivitendo.conf.default</code> existiert, die als
|
||
|
Vorlage benutzt werden kann.</p></div><div class="sect2" title="2.9.2. Administratorpasswort"><div class="titlepage"><div><div><h3 class="title"><a name="Administratorpasswort"></a>2.9.2. Administratorpasswort</h3></div></div></div><p>Das Passwort, das zum Zugriff auf das Administrationsinterface
|
||
|
von kivitendo 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 <code class="varname">admin_password</code> im Abschnitt
|
||
|
<code class="varname">[authentication]</code>.</p></div><div class="sect2" title="2.9.3. Authentifizierungsdatenbank"><div class="titlepage"><div><div><h3 class="title"><a name="Authentifizierungsdatenbank"></a>2.9.3. Authentifizierungsdatenbank</h3></div></div></div><p>Die Verbindung zur Authentifizierungsdatenbank wird mit den
|
||
|
Parametern in <code class="varname">[authentication/database]</code>
|
||
|
konfiguriert. Hier sind die folgenden Parameter anzugeben:</p><div class="variablelist"><dl><dt><span class="term">
|
||
|
<code class="literal">host</code>
|
||
|
</span></dt><dd><p>Der Rechnername oder die IP-Adresse des
|
||
|
Datenbankservers</p></dd><dt><span class="term">
|
||
|
<code class="literal">port</code>
|
||
|
</span></dt><dd><p>Die Portnummer des Datenbankservers, meist 5432</p></dd><dt><span class="term">
|
||
|
<code class="literal">db</code>
|
||
|
</span></dt><dd><p>Der Name der Authentifizierungsdatenbank</p></dd><dt><span class="term">
|
||
|
<code class="literal">user</code>
|
||
|
</span></dt><dd><p>Der Benutzername, mit dem sich kivitendo beim
|
||
|
Datenbankserver anmeldet (z.B.
|
||
|
"<code class="literal">postgres</code>")</p></dd><dt><span class="term">
|
||
|
<code class="literal">password</code>
|
||
|
</span></dt><dd><p>Das Passwort für den Datenbankbenutzer</p></dd></dl></div><p>Die Datenbank muss noch nicht existieren. kivitendo kann sie
|
||
|
automatisch anlegen (mehr dazu siehe unten).</p></div><div class="sect2" title="2.9.4. Passwortüberprüfung"><div class="titlepage"><div><div><h3 class="title"><a name="Passwort%C3%BCberpr%C3%BCfung"></a>2.9.4. Passwortüberprüfung</h3></div></div></div><p>kivitendo unterstützt Passwortüberprüfung auf zwei Arten: gegen
|
||
|
die Authentifizierungsdatenbank und gegen externe LDAP- oder
|
||
|
Active-Directory-Server. Welche davon benutzt wird, regelt der
|
||
|
Parameter <code class="varname">module</code> im Abschnitt
|
||
|
<code class="varname">[authentication]</code>.</p><p>Dieser Parameter listet die zu verwendenden Authentifizierungsmodule auf. Es muss mindestens ein Modul angegeben werden, es
|
||
|
können aber auch mehrere angegeben werden. Weiterhin ist es möglich, das LDAP-Modul mehrfach zu verwenden und für jede Verwendung
|
||
|
eine unterschiedliche Konfiguration zu nutzen, z.B. um einen Fallback-Server anzugeben, der benutzt wird, sofern der Hauptserver
|
||
|
nicht erreichbar ist.</p><p>Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank geprüft werden, so muss der Parameter
|
||
|
<code class="varname">module</code> das Modul <code class="literal">DB</code> enthalten. Sofern das Modul in der Liste enthalten ist, egal an welcher
|
||
|
Position, können sowohl der Administrator als auch die Benutzer selber ihre Passwörter in kivitendo ändern.</p><p>Wenn Passwörter gegen einen oder mehrere externe LDAP- oder Active-Directory-Server geprüft werden, so muss der Parameter
|
||
|
<code class="varname">module</code> den Wert <code class="literal">LDAP</code> enthalten. In diesem Fall müssen zusätzliche Informationen über den
|
||
|
LDAP-Server im Abschnitt <code class="literal">[authentication/ldap]</code> angegeben werden. Das Modul kann auch mehrfach angegeben werden,
|
||
|
wobei jedes Modul eine eigene Konfiguration bekommen sollte. Der Name der Konfiguration wird dabei mit einem Doppelpunkt getrennt an
|
||
|
den Modulnamen angehängt (<code class="literal">LDAP:Name-der-Konfiguration</code>). Der entsprechende Abschnitt in der Konfigurationsdatei
|
||
|
lautet dann <code class="literal">[authentication/Name-der-Konfiguration]</code>.</p><p>Die verfügbaren Parameter für die LDAP-Konfiguration lauten:</p><div class="variablelist"><dl><dt><span class="term">
|
||
|
<code class="literal">host</code>
|
||
|
</span></dt><dd><p>Der Rechnername oder die IP-Adresse des LDAP- oder
|
||
|
Active-Directory-Servers. Diese Angabe ist zwingend
|
||
|
erforderlich.</p></dd><dt><span class="term">
|
||
|
<code class="literal">port</code>
|
||
|
</span></dt><dd><p>Die Portnummer des LDAP-Servers; meist 389.</p></dd><dt><span class="term">
|
||
|
<code class="literal">tls</code>
|
||
|
</span></dt><dd><p>Wenn Verbindungsverschlüsselung gewünscht ist, so diesen
|
||
|
Wert auf ‘<code class="literal">1</code>’ setzen, andernfalls auf
|
||
|
‘<code class="literal">0</code>’ belassen</p></dd><dt><span class="term">
|
||
|
<code class="literal">verify</code>
|
||
|
</span></dt><dd><p>Wenn Verbindungsverschlüsselung gewünscht und der Parameter <em class="parameter"><code>tls</code></em> gesetzt ist, so gibt dieser
|
||
|
Parameter an, ob das Serverzertifikat auf Gültigkeit geprüft wird. Mögliche Werte sind <code class="literal">require</code> (Zertifikat
|
||
|
wird überprüft und muss gültig sei; dies ist der Standard) und <code class="literal">none</code> (Zertifikat wird nicht
|
||
|
überpfüft).</p></dd><dt><span class="term">
|
||
|
<code class="literal">attribute</code>
|
||
|
</span></dt><dd><p>Das LDAP-Attribut, in dem der Benutzername steht, den der
|
||
|
Benutzer eingegeben hat. Für Active-Directory-Server ist dies
|
||
|
meist ‘<code class="literal">sAMAccountName</code>’, für andere
|
||
|
LDAP-Server hingegen ‘<code class="literal">uid</code>’. Diese Angabe ist
|
||
|
zwingend erforderlich.</p></dd><dt><span class="term">
|
||
|
<code class="literal">base_dn</code>
|
||
|
</span></dt><dd><p>Der Abschnitt des LDAP-Baumes, der durchsucht werden soll.
|
||
|
Diese Angabe ist zwingend erforderlich.</p></dd><dt><span class="term">
|
||
|
<code class="literal">filter</code>
|
||
|
</span></dt><dd><p>Ein optionaler LDAP-Filter. Enthält dieser Filter das Wort
|
||
|
<code class="literal"><%login%></code>, 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.</p></dd><dt><span class="term">
|
||
|
<code class="literal">bind_dn</code> und
|
||
|
<code class="literal">bind_password</code>
|
||
|
</span></dt><dd><p>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
|
||
|
‘<code class="literal">bind_dn</code>’ entweder eine komplette LDAP-DN wie
|
||
|
z.B. ‘<code class="literal">cn=Martin
|
||
|
Mustermann,cn=Users,dc=firmendomain</code>’ auch nur der
|
||
|
volle Name des Benutzers eingegeben werden; in diesem Beispiel
|
||
|
also ‘<code class="literal">Martin Mustermann</code>’.</p></dd><dt><span class="term">
|
||
|
<code class="literal">timeout</code>
|
||
|
</span></dt><dd><p>Timeout beim Verbindungsversuch, bevor der Server als nicht erreichbar gilt; Standardwert: 10</p></dd></dl></div></div><div class="sect2" title="2.9.5. Name des Session-Cookies"><div class="titlepage"><div><div><h3 class="title"><a name="Name-des-Session-Cookies"></a>2.9.5. Name des Session-Cookies</h3></div></div></div><p>Sollen auf einem Server mehrere kivitendo-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 <code class="varname">cookie_name</code> im Abschnitt
|
||
|
<code class="varname">[authentication]</code>gesetzt.</p><p>Diese Angabe ist optional, wenn nur eine Installation auf dem
|
||
|
Server existiert.</p></div><div class="sect2" title="2.9.6. Anlegen der Authentifizierungsdatenbank"><div class="titlepage"><div><div><h3 class="title"><a name="Anlegen-der-Authentifizierungsdatenbank"></a>2.9.6. Anlegen der Authentifizierungsdatenbank</h3></div></div></div><p>Nachdem alle Einstellungen in
|
||
|
<code class="filename">config/kivitendo.conf</code> vorgenommen wurden, muss
|
||
|
kivitendo die Authentifizierungsdatenbank anlegen. Dieses geschieht
|
||
|
automatisch, wenn Sie sich im Administrationsmodul anmelden, das unter
|
||
|
der folgenden URL erreichbar sein sollte:</p><p>
|
||
|
<a class="ulink" href="http://localhost/kivitendo-erp/controller.pl?action=Admin/login" target="_top">http://localhost/kivitendo-erp/controller.pl?action=Admin/login</a>
|
||
|
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s08.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s10.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.8. Der Task-Server </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.10. Mandanten-, Benutzer- und Gruppenverwaltung</td></tr></table></div></body></html>
|
||
|
<title>2.9. Konfiguration der Hintergrund-Jobs</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.8.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s08.html" title="2.8. Der Task-Server"><link rel="next" href="ch02s10.html" title="2.10. Benutzerauthentifizierung und Administratorpasswort"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.9. Konfiguration der Hintergrund-Jobs</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s08.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s10.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.9. Konfiguration der Hintergrund-Jobs"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Hintergrund-Jobs konfigurieren"></a>2.9. Konfiguration der Hintergrund-Jobs</h2></div></div></div><p>Hintergrund-Jobs werden über System -> Hintergrund-Jobs und Task-Server -> Aktuelle Hintergrund-Jobs anzeigen -> Aktions-Knopf 'erfassen' angelegt. </p><p>Nachdem wir über das Menü dort angelangt sind, legen wir hier unseren Hintergrund-Jobs an:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
|
||
|
<code class="literal">Aktiv:</code> Hier ein 'Ja' auswählen</p></li><li class="listitem"><p>
|
||
|
<code class="literal">Ausführungsart:</code> 'wiederholte Ausführung' auswählen</p></li><li class="listitem"><p>
|
||
|
<code class="literal">Paketname:</code> Hintergrundjob auswählen</p></li><li class="listitem"><p>
|
||
|
<code class="literal">Ausführungszeitplan:</code> Hier entsprechend Werte wie in der crontab eingeben.</p><p>Syntax:</p><pre class="programlisting">* * * * *
|
||
|
┬ ┬ ┬ ┬ ┬
|
||
|
│ │ │ │ │
|
||
|
│ │ │ │ └──── Wochentag (0-7, Sonntag ist 0 oder 7)
|
||
|
│ │ │ └────── Monat (1-12)
|
||
|
│ │ └──────── Tag (1-31)
|
||
|
│ └────────── Stunde (0-23)
|
||
|
└──────────── Minute (0-59) </pre><p>Die Sterne können folgende Werte haben:</p><pre class="programlisting">
|
||
|
1 2 3 4 5
|
||
|
|
||
|
1 = Minute (0-59)
|
||
|
2 = Stunde (0-23)
|
||
|
3 = Tag (0-31)
|
||
|
4 = Monat (1-12)
|
||
|
5 = Wochentag (0-7, Sonntag ist 0 oder 7)
|
||
|
</pre><p>Um die Ausführung auf eine Minute vor den Jahreswechsel zu setzen, müssen die folgenden Werte eingetragen werden:</p><pre class="programlisting">59 23 31 12 *</pre></li><li class="listitem"><p>
|
||
|
<code class="literal">Daten:</code>In diesem Feld können optionale Parameter für den Hintergrund im YAML-Format gesetzt werden.</p></li></ul></div><div class="sect2" title="2.9.1. SetNumberRange"><div class="titlepage"><div><div><h3 class="title"><a name="Hintergrund-Job SetNumberRange"></a>2.9.1. SetNumberRange</h3></div></div></div><p> Der Hintergrund-Job <code class="literal">SetNumberRange</code> akzeptiert im Feld <code class="literal">Daten</code> zwei Variablen nämlich <code class="literal">digit_year</code> sowieso <code class="literal">multiplier</code>.</p><p>
|
||
|
<code class="literal">digit_year</code> kann zwei Werte haben entweder 2 oder 4, darüber wird gesteuert ob die Jahreszahl zwei oder vierstellig kodiert wird (für 2019, dann entweder 19 oder 2019). Der Standardwert ist vierstellig.</p><p>
|
||
|
<code class="literal">multiplier</code> ist ein Vielfaches von 10, darüber wird die erste Nummer im Nummernkreis (die Anzahl der Stellen) wie folgt bestimmt:</p><pre class="programlisting">
|
||
|
multiplier Nummernkreis 2020
|
||
|
10 -> 20200
|
||
|
100 -> 202000
|
||
|
1000 -> 2020000
|
||
|
</pre><p>Wir gehen jetzt beispielhaft von einer letzten Rechnungsnummer von RE2019456 aus. Demnach sollte ab Januar 2020 die erste Nummer RE2020001 sein. Da der Task auch Präfixe berücksichtigt, kann dies mit folgenden JSON-kodierten Werten umgesetzt werden:</p><p>
|
||
|
<code class="literal">Daten:</code>
|
||
|
</p><pre class="programlisting">multiplier: 100
|
||
|
digits_year: 4</pre></div><div class="sect2" title="2.9.2. ImportRecordEmails"><div class="titlepage"><div><div><h3 class="title"><a name="Hintergrund-Job ImportRecordEmails"></a>2.9.2. ImportRecordEmails</h3></div></div></div><p> Der Hintergrund-Job <code class="literal">ImportRecordEmails</code> kann vollständig über das Feld Daten konfiguriert werden. Er benötigt folgende Variablen:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
|
||
|
<code class="literal">hostname:</code> Hier wird der Emailserver eingetragen</p></li><li class="listitem"><p>
|
||
|
<code class="literal">username:</code> Benutzername, mit dem sich am Emailserver angemeldet wird. (Häufig die Emailadresse)</p></li><li class="listitem"><p>
|
||
|
<code class="literal">password:</code> Passwort des Benutzers</p></li><li class="listitem"><p>
|
||
|
<code class="literal">folder:</code> Hier wird der Ordner eingetragen, aus dem die Emails importert werden sollen. (bspw. INBOX)</p></li><li class="listitem"><p>
|
||
|
<code class="literal">port:</code> Port am Emailserver. Default ist 993</p></li><li class="listitem"><p>
|
||
|
<code class="literal">ssl:</code> Gibt an ob SSL verwendet werden soll. Default: 1</p></li></ul></div><p> Optional können außerdem folgende Variablen verwendet werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
|
||
|
<code class="literal">email_import_ids_to_delete:</code> Hier können IDs von Importen eingetragen werden, deren Emails aus dem Emailjournal gelöscht werden sollen.</p></li><li class="listitem"><p>
|
||
|
<code class="literal">process_imported_emails:</code> Wenn nach dem Import noch weitere Verarbeitung der angehangenen Dokument erfolgen soll, müssen hier die jeweiligen Schritte eingetragen werden. Aktuell ist es möglich, dass angehangene Zugpferd-Rechnung direkt verbucht und mit der Email verknüpft werden. Dazu muss hier '[zugpferd]' eingetragen werden.</p></li><li class="listitem"><p>
|
||
|
<code class="literal">processed_imap_flag:</code> Das hier eingetragenen Flag wird nach dem Verarbeiten an der Email gesetzt.</p></li><li class="listitem"><p>
|
||
|
<code class="literal">not_processed_imap_flag:</code> Dieses Flag wird gesetzt, wenn die Email nicht verarbeitet werden konnte.</p></li><li class="listitem"><p>
|
||
|
<code class="literal">record_type:</code> Einträge im Email-Journal können direkt einem Belegtypen zugrorndet werden. Wenn alle Emails, die mit einem Hintergrundjob importiert werden, den gleichen Belegtypen haben, kann man diesen hier festlegen und alle Einträge im Emailjournal werden entsprechend zugrordnet. Für Eingangsrechnungen muss man hier 'ap_transaction' setzen.</p></li></ul></div><p>Wie die Imap Flags von den jeweiligen Clients angezeigt und eingerichtet werden, ist aktuell om Thunderbird (Version 115.8.0) und SoGo (Version 5.9.1) getestet:</p><p>In Thunderbird heißen die Flags Schlagwörter. Sie werden durchnummeriert mit dem Prefix "$label". Über die Einstellungen kann man Schlagwort und Farbe für den jeweiligen Tag setzen und berabeiten. Um die vordefenierten Tags in Thunderbird zu netzen kann man $label1 - $label5 nutzen. Eigene Label werden dann von thunderbird automatisch hochgezählt.Um das korrekte Tag für ein Label zu finden oder auch selbst ein Tag mit einer selbst gewählten Zahl zu defnieren kann man in den Einstellunge gan am Ende über den Button <code class="literal">Konfiguration berabeiten...</code> die Werte in der Kofiguration einsehen, ändern und berabeiten. Hier muss man nach <code class="literal">mailnews.tags</code> suchen.</p><p>In SoGo kann man unter Einstellungen -> Mail -> Labels beliebige Label mit $ als Prefix anlegen und Namen und Farbe zuweisen.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s08.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s10.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.8. Der Task-Server </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.10. Benutzerauthentifizierung und Administratorpasswort</td></tr></table></div></body></html>
|
||
Auch abrufbar als: Unified diff
Doku PDF/HTML neu gebaut