authad-Plugin: Benutzer und Gruppen aus einem Active Directory verwenden

Mittels des authad-Plugins kann das Wiki auf einen Active-Directory-Verzeichnisdienst zurückgreifen, um dessen Benutzer statt der Wiki-internen Benutzerverwaltung zu verwenden.

Bitte lesen Sie zur Einrichtung auch die Original-Dokumentation aus dem DokuWiki-Projekt, auf dem das Einsatzleiterwiki basiert: https://www.dokuwiki.org/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:

LoadModule ldap_module modules/mod_ldap.so

und

LoadModule authnz_ldap_module modules/mod_authnz_ldap.so

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.

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.
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.

Es müssen in der Konfiguration zumindest folgende Einstellungen gesetzt sein, welche auch die ersten drei Eingabefelder bei der Konfiguration des AuthAD-Plugins sind:

Account-Suffix
Base-DN
Komma-separierte Liste von Domänen-Controllern

Nun am Ende der Seite auf Speichern klicken.

Ab sofort sollte eine Anmeldung mit dem Active-Directory-Benutzerkonto möglich sein.

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)

====== Anmelden ====== Bitte gleichen Benutzernamen und Passwort wie bei der Anmeldung in Windows verwenden, um sich anzumelden.

HILFE!!!

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.

Installation des Plugins

Dieses Plugin ist in der Standard-Einsatzleiterwiki-Installation enthalten. Eine Anleitung, wie Sie ein Plugin installieren, finden Sie auf dieser Seite.

Dokumentation des authad-Plugins auf dokuwiki.org

Tracedump:

newBaseSize: 16pt
newBaseSizeInPt: 16