--- title: "Active Directory (AD) on-premise für Linux | Vizito Hilfe-Center" description: "Active Directory (AD) on-premise für Linux | Active Directory einbinden, AD-Benutzerdaten von Kollegen und Mitarbeitern als Kontaktpersonen für …" url: https://vizito.eu/faq/de/integrationen/active-directory-on-premise-fuer-linux/ language: de-de --- # Active Directory (AD) on-premise für Linux Pieter-Jan Dries · 01.09.2026 · 3 min In diesem Artikel Wenn Sie bei den folgenden Schritten Hilfe brauchen, melden Sie sich gerne: [info@vizito.be](mailto:info@vizito.be) oder über den Chat. Die AD-Integration wird über den Vizito-AD-Client konfiguriert, der auf einem Gerät oder Server installiert werden muss, mit dem sich das Tablet verbinden kann. Das Tablet muss dieses Gerät beziehungsweise diesen Server also über sein Netzwerk erreichen können. Unten finden Sie eine schematische Darstellung: ![Netzwerk des Vizito-LDAP-Clients](https://vizito.eu/faq/de/integrationen/active-directory-on-premise-fuer-linux/ldap_client_network.png?width=900) ### Schritt 1: NodeJS Laden Sie die neueste Version von NodeJS von der [NodeJS-Website](https://nodejs.org/en) herunter und installieren Sie sie. ### Schritt 2: Vizito-AD-Client [Laden Sie](https://bitbucket.org/modulage/ldap_client/downloads/) unseren Vizito-AD-Client herunter und entpacken Sie ihn in einen Ordner Ihrer Wahl. ### Schritt 3: Konfiguration Passen Sie config.json an Ihre Umgebung an. Hier finden Sie die Konfigurationswerte und eine Beschreibung der Angaben, die Sie eintragen müssen: | **JSON-Eigenschaft** | **Pflicht** | **Beschreibung** | | --- | --- | --- | | ldap\*url | Ja | Die interne URL oder IP Ihres LDAP-Servers. Beispiel: \_ldap://ldap.forumsys.com .\* | | ldap\*bind\_credentials.user\_cn | Ja | Der Benutzer-CN, der für den LDAP-Bind verwendet wird. Üblicherweise wird dafür ein eigener technischer Benutzer mit reinen Leserechten angelegt. | | ldap\_bind\_credentials.password | Ja | Das Passwort des LDAP-Bind-Benutzers. | | search\_scope | Ja | Legt die Suchtiefe fest: \_base\* durchsucht nur die Ebene der search_base; \_one_ durchsucht nur die direkt untergeordneten Objekte der Basis, nicht aber das Basisobjekt selbst; _sub_ durchsucht die Ebene der search\*base und alle ihre Teilbäume. | | search\*base | Ja | Die Suchbasis für das Nachschlagen von CN-Einträgen. Das sollte die oberste Ebene Ihrer LDAP-Domäne sein, in der Sie nach Einträgen suchen möchten. | | mobile\_prefix | Nein | Wenn Ihr LDAP-Verzeichnis lokale oder interne Mobilnummern ohne Landesvorwahl enthält, können Sie ein Präfix mit der Landesvorwahl ergänzen. Das erste Zeichen der lokalen oder internen Mobilnummer wird durch dieses Präfix ersetzt. | | ldap\_filter | Nein | Wenn Sie die LDAP-Suchergebnisse einschränken möchten, geht das über einen LDAP-Filter. Damit wird nur nach passenden Datensätzen gesucht. | | Beispiele für solche Filter sind: nur Personen einer bestimmten Gruppe, nur Personen mit hinterlegter Mobilnummer und so weiter. | | | | Ein Beispielfilter: \*(&(memberof=OU=VizitoGroup,OU=Applications,OU=Groups,DC=company,DC=com))\* . | | | | api\*port | Ja | Standardwert: \_48800\*. Legt den Port fest, an dem die Node-Anwendung auf HTTP(S)-Anfragen wartet. | | use\*ssl\_for\_api | Ja | Standardwert: \_false\*. Auf \_true\_ gesetzt, verwendet die Anwendung die Konfigurationseinträge _ssl.ca_, _ssl.key_ und _ssl.cert_, um ein Schlüsselpaar für die TLS-Kommunikation zu laden. | | Lesen Sie dazu, wie Sie [eigene selbstsignierte Zertifikate mit einer eigenen Root-CA erstellen](https://gist.githubusercontent.com/fntlnz/cf14feb5a46b2eda428e000157447309/raw/318beb5642577c16de2564666b04de99a215308e/self-signed-certificate-with-custom-ca.md). | | | | authentication.enabled | Ja | Gibt an, ob für eine Anfrage an diesen Server eine Basisauthentifizierung nötig ist. | | authentication.username | Nein | Der für die Basisauthentifizierung konfigurierte Benutzername. | | authentication.password | Nein | Das für die Basisauthentifizierung konfigurierte Passwort. | ### Schritt 4: Starten Wechseln Sie in den Ordner, in dem Ihr LDAP-Client liegt, und führen Sie aus: - “npm install” (nur einmal nötig) - “node server.js” Wenn alles wie vorgesehen funktioniert, sehen Sie “Server is listening”. Sie können den LDAP-HTTP-Server nun im Browser testen, indem Sie `http://ip_oder_hostname_des_rechners_mit_dem_ldap_client:48800/` aufrufen (passen Sie den Port an, wenn Sie ihn in der Konfigurationsdatei geändert haben). Wenn Ihr Browser ein JSON-Objekt mit den Benutzern anzeigt, die Sie bereitstellen möchten, funktioniert alles. ### Schritt 5: Das Backoffice so konfigurieren, dass sich das Tablet mit dem Client verbindet Gehen Sie ins [Vizito-Backoffice](https://backoffice.vizito.be/) und setzen Sie unter den Einstellungen “Datenquelle Kontaktpersonen” auf “extern verwaltet” und tragen Sie die “URL für Integration” ein. Ein Beispiel: _http://192.168.1.100:48800_. Das Tablet holt sich die Informationen nun vom installierten Client. ### Schritt 6: Den Node-Prozess mit PM2 als Dienst betreiben Wie Sie PM2 installieren und verwenden, steht im [PM2-Handbuch](https://github.com/Unitech/pm2). ### Fehlerbehebung Zu Testzwecken stehen Demodienste bereit. Sie enthalten Namen wie “Tesla”, “Newton” und so weiter. - HTTP-Variante: `http://178.162.136.223:48800` - HTTPS-Variante: `https://source.vizito.eu:48801` Wenn Sie eine HTTPS-Konfiguration verwenden, können Sie mehrere CA-Referenzen hinterlegen. Setzen Sie jede CA in Anführungszeichen in das CA-Array, das Sie in der Datei config.JSON finden.