Sie befinden sich in der bearbeitbaren Version des Einsatzleiterwiki-Projekts. Klicken Sie hier für allgemeine Informationen zum Projekt.

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

--- wiki:hilfe:plugins:standard:authad [21.05.2019 18:18] – ↷ Seite von wiki:hilfe:installation_anpassung_authad nach wiki:hilfe:plugins:standard:authad verschoben und umbenannt christoph_ziehr
+++ wiki:hilfe:plugins:standard:authad [24.02.2021 11:39] (aktuell) – ↷ Links angepasst weil Seiten im Wiki verschoben wurden
@@ Zeile 1: / Zeile 1: @@
-====== Einrichtung der Active-Directory-Anbindung ======
+====== authad-Plugin: Benutzer und Gruppen aus einem Active Directory verwenden ======
-siehe auch die Original-Dokumentation aus dem DokuWiki-Projekt, auf dem das Einsatzleiterwiki basiert: https://www.dokuwiki.org/plugin:authad
+Mittels des authad-Plugins kann das Wiki auf einen [[wpde>Active_Directory|Active-Directory-Verzeichnisdienst]] zurückgreifen, um dessen Benutzer statt der [[wiki:hilfe:administration:benutzer_und_gruppen|Wiki-internen Benutzerverwaltung]] zu verwenden.
+Bitte lesen Sie zur Einrichtung auch die Original-Dokumentation aus dem DokuWiki-Projekt, auf dem das Einsatzleiterwiki basiert: [[doku>plugin:authad]]
 ===== Apache-Konfiguration =====
-In der Apache-Konfigurationsdatei, standardmäßig zu finden unter ''C:\Program Files (x86)\Einsatzleiterwiki\xampp\apache\conf\httpd.conf'', muss vor folgenden Zeilen das Kommentarzeichen **#** entfernt werden:
+Um den Active-Directory-Zugriff nutzen zu können, müssen in der Apache-Konfiguration die Module ''mod_ldap.so'' und ''mod_authnz_ldap.so'' aktiviert werden (das Active Directory basiert auf LDAP).
-<code>
+In der Standard-Installation des Einsatzleiterwikis, welche Sie als Komplettpaket herunterladen können, sind diese Module im mitgelieferten //Microapache//-Server nicht enthalten. In der Regel werden Sie das Wiki aber auch auf einem //richtigen// Webserver wie dem Standard-Apache-Webserver betreiben, wenn Sie Ihr Wiki dauerhaft in einem Netzwerk verfügbar machen wollen.
-LoadModule ldap_module modules/mod_ldap.so
-</code>
-und
+Falls Sie einen anderen Webserver als den Apache-Server einsetzen, müssen Sie vermutlich entsprechende Erweiterungen für den von Ihnen gewählten Webserver installieren.
-<code>
-LoadModule authnz_ldap_module modules/mod_authnz_ldap.so
-</code>
-Die Änderung wird erst nach einem Neustart des Apache-Servers wirksam, im nächsten Schritt muss jedoch sowieso nochmals der Computer neugestartet werden, somit kann dies hier i.d.R. entfallen.
 ===== Umgebungsvariable einrichten =====
-Zusätzlich zu der Konfiguration des Apache-Servers muss noch der Pfad zu PHP in die Umgebungsvariablen aufgenommen werden, damit die AD-Anbindung funktioniert.
+Zusätzlich zu der Konfiguration des Apache-Servers muss gegebenenfalls noch der Pfad zu PHP in die Umgebungsvariablen aufgenommen werden, damit die AD-Anbindung funktioniert. Recherchieren Sie bitte gegebenenfalls im Internet, wie sie den Pfad in die Umgebungsvariablen eintragen.
-Um die Umgebungsvariablen zu bearbeiten, folgende Dialogfenster öffnen:
-//Systemsteuerung// -> Punkt //System und Sicherheit// -> //System// -> in der Spalte ganz links auf //erweiterte Systemeinstellungen// klicken -> auf dem Reiter //Erweitert// auf den Button //Umgebungsvariablen...// klicken.
-In der unteren Liste //Systemvariablen// beim Eintrag //Path// ans Ende ein Semikolon als Trennzeichen einfügen und danach den Pfad zu PHP eintragen. Standardmäßig lautet der Eintrag
-''C:\Program Files (x86)\Einsatzleiterwiki\xampp\php''
-(kann sich je nach Auswahl des Installationsordners selbstverständlich ändern und sollte vor dem Eintragen überprüft werden).
-Nach einem Neustart des Systems ist die Umgebungsvariable verfügbar.
 ===== Wiki-Konfiguration =====
-Im Administrationsbereich muss das Plugin //authad// aktiviert werden, soweit nicht schon geschehen.
+Im [[wiki:hilfe:administration:admin-bereich|Administrationsbereich]] muss unter dem Punkt //Erweiterungen verwalten// das Plugin //authad// aktiviert werden, soweit nicht schon geschehen.\\ :!: Dieser Schritt wird oft übersehen!
-Danach muss im Administrationsbereich des Wikis die //Konfiguration// geöffnet werden. Im Bereich //Authentifizierung// beim Punkt //Authentifizierungsmechanismus// kann nun aus der Liste //authad// ausgewählt werden, um die Active-Directory-Anbindung zu aktivieren.
+Danach muss im Administrationsbereich des Wikis die [[wiki:hilfe:administration:konfigurations-manager|Konfiguration]] geöffnet werden. Im Bereich //Authentifizierung// beim Punkt //Authentifizierungsmechanismus// kann nun aus der Liste //authad// ausgewählt werden, um die Active-Directory-Anbindung zu aktivieren.
 Es müssen in der Konfiguration zumindest folgende Einstellungen gesetzt sein, welche auch die ersten drei Eingabefelder bei der Konfiguration des AuthAD-Plugins sind:
@@ Zeile 49: / Zeile 31: @@
 Nun am Ende der Seite auf Speichern klicken.
-Ab sofort sollte eine Anmeldung mit dem Windows-Benutzerkonto möglich sein.
+Ab sofort sollte eine Anmeldung mit dem Active-Directory-Benutzerkonto möglich sein.
-===== HILFE!!! =====
+===== Hinweis auf der Login-Seite =====
+Damit Ihre Nutzer auch wissen, dass sie sich mit ihrem AD-Konto anmelden können, ist ein Hinweis auf der Login-Seite des Wikis sinnvoll. Legen Sie hier die folgende Datei an, um den Text der Login-Seite anzupassen: ''/conf/lang/de/login.txt'' (ausgehend vom Wiki-Hauptverzeichnis, nicht existierende Unterordner ggf. anlegen)
+<file plain login.txt>
+====== Anmelden ======
-Sollte etwas schiefgelaufen und eine Anmeldung im Wiki nicht mehr möglich sein, so kann die AD-Authentifizierung auch per Hand wieder deaktiviert bzw. auf das Standardverfahren zurückgesetzt werden. Dafür vom Wiki-Hauptverzeichnis ausgehend im Unterordner ''conf'' die Datei ''local.php'' öffnen und die Zeile
+Bitte gleichen Benutzernamen und Passwort wie bei der Anmeldung in Windows verwenden, um sich anzumelden.
+</file>
+===== HILFE!!! =====
-<code>
+Sollte etwas schiefgelaufen und eine Anmeldung im Wiki nicht mehr möglich sein, so kann die [[wiki:hilfe:fehler:active_directory-anmeldungsfehler|AD-Authentifizierung auch per Hand wieder deaktiviert bzw. auf das Standardverfahren zurückgesetzt werden.]]
-$conf['authtype'] = 'authad';
-</code>
-ändern auf
+===== Installation des Plugins =====
-<code>
+Dieses Plugin ist in der Standard-Einsatzleiterwiki-Installation enthalten. Eine Anleitung, wie Sie ein Plugin installieren, finden Sie auf [[wiki:hilfe:plugins:plugins_installieren|dieser Seite]].
-$conf['authtype'] = 'authplain';
-</code>
-Damit wird wieder die DokuWiki-eigene Benutzerdatenbank aktiviert und die Active-Directory-Anbindung deaktiviert.
+[[doku>plugin:authad|Dokumentation des authad-Plugins auf dokuwiki.org]]