--- title: "Azure Entra ID für Windows-Server | Vizito Hilfe-Center" description: "Azure Entra ID für Windows-Server | Azure-Entra-ID-Benutzerdaten von Kollegen und Mitarbeitern als Kontaktpersonen für Benachrichtigungen einbinden, LDAP | …" url: https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/ language: de-de --- # Azure Entra ID für Windows-Server Pieter-Jan Dries · 01.09.2026 · 5 min In diesem Artikel Vizito hat vor Kurzem eine Funktion eingeführt, mit der Sie Ihre Azure-Mitarbeiter direkt aus unseren Cloudsystemen synchronisieren, ohne selbst Software installieren zu müssen. Mehr dazu unter [Azure-Synchronisierung](https://vizito.eu/faq/de/integrationen/azure-synchronisierung/). Der Vorteil ist, dass die Einrichtung einfacher ist. Wenn Ihnen Datenschutz wichtiger ist als Bequemlichkeit, können Sie weiterhin unsere Azure-Entra-ID-Client-Synchronisierung nutzen, die nicht sämtliche Mitarbeiterdaten auf unsere Server dupliziert. Wenn Sie bei den folgenden Schritten Hilfe brauchen, melden Sie sich gerne: [info@vizito.be](mailto:info@vizito.be) oder über den Chat. Die Azure-Entra-ID-Integration wird über den Vizito-Azure-Entra-ID-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/azure-entra-id-fuer-windows-server/ldap_client_network.png?width=900) ### Schritt 1: NodeJS Installieren Sie NodeJS mit Ihrem bevorzugten Paketmanager. ### Schritt 2: Vizito-Azure-Entra-ID-Client [Laden Sie](https://bitbucket.org/modulage/azure_ad_client/downloads/) unseren Azure-Entra-ID-Client herunter und entpacken Sie ihn in ein Verzeichnis Ihrer Wahl. Die Schritte 3 und 4 muss Ihre Azure-Entra-ID-Administration ausführen. ### Schritt 3: Eine App-Registrierung in Ihrem Azure Entra ID anlegen Gehen Sie zum [Azure-Portal](https://portal.azure.com/) und melden Sie sich an. Wählen Sie die Domäne beziehungsweise den Mandanten, den Sie mit Vizito verbinden möchten. Gehen Sie dann so vor: Navigieren Sie zu Azure Active Directory: ![Vizito-Integration Azure Active Directory](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_01.webp?width=900) Klicken Sie auf _App Registrations_ und dann auf _New registration_: ![Vizito-Integration Azure Active Directory App-Registrierung](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_02.webp?width=900) Füllen Sie die erforderlichen Felder aus. Wählen Sie einen Namen: _Vizito Azure Client_ Wählen Sie, wer auf diese API zugreifen darf, für einen einzelnen Mandanten die erste Option. Wählen Sie unter _Redirect URI (optional)_ den Anwendungstyp _Web_ und als Anmelde-URL: `https://backoffice.vizito.be/oauth`. Klicken Sie auf _Register_. ![Vizito-Integration Azure Active Directory Felder](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_03.webp?width=900) Kopieren Sie die “Application (client) ID” und verwenden Sie diesen Wert für den Konfigurationseintrag _client\_id_ in der Datei config.json. Kopieren Sie die “Directory (tenant) ID” und verwenden Sie diesen Wert für den Konfigurationseintrag _tenant\_id_ in der Datei config.json. ![Vizito-Integration Azure Active Directory Application ID](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_04.webp?width=900) Klicken Sie auf _Certificates & secrets_ > _Client secrets_ > _New Client secret_ Wählen Sie eine Beschreibung, etwa _Vizito Azure client secret_, und setzen Sie eine Ablaufoption (24 Monate). Klicken Sie auf _Add_. ![Vizito-Integration Azure Active Directory Client Secret](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_05.webp?width=900) Kopieren Sie den _value_ und verwenden Sie ihn für den Konfigurationseintrag _client\_secret_ in der Datei config.json. **Wichtig: Sie können diesen Wert nur jetzt kopieren. Aus Sicherheitsgründen wird er später, wenn Sie zu Ihren Client Secrets zurückkehren, nicht mehr angezeigt.** ![Vizito-Integration Azure Active Directory Übersicht der Client Secrets](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_06.webp?width=900) Klicken Sie auf _API permissions_ > _Microsoft APIs_ > _Microsoft Graph_ ![Vizito-Integration Azure Active Directory API-Berechtigungen](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_07.webp?width=900) Klicken Sie auf _Application permissions_ ![Vizito-Integration Azure Active Directory API-Berechtigungen Anwendung](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_08.webp?width=900) Scrollen Sie zu _Directory_ und wählen Sie **Directory.Read.All** ![Vizito-Integration Azure Active Directory API-Berechtigungen Directory](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_09.webp?width=900) Scrollen Sie zu _Group_ und wählen Sie **Group.Read.All** ![Vizito-Integration Azure Active Directory API-Berechtigungen Group](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_10.webp?width=900) Scrollen Sie zu _User_ und wählen Sie **User.Read.All** Klicken Sie auf _Add permission_ ![Vizito-Integration Azure Active Directory API-Berechtigungen User](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_11.webp?width=900) Klicken Sie danach auf _Grant admin consent for_ und dann auf _Yes_: ![Vizito-Integration Azure Active Directory Berechtigungen erteilen](https://vizito.eu/faq/de/integrationen/azure-entra-id-fuer-windows-server/vizito_ldap_azure_integration_12.webp?width=900) ### Schritt 4: Konfiguration des Vizito-Azure-Entra-ID-Clients 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** | | --- | --- | --- | | domain | Ja | Domänenangabe, Beispiel: vizito.eu | | client\*id | Ja | Die Client ID für den Zugriff auf Azure Entra ID (in Schritt 3 angelegt). | | client\_secret | Ja | Das Client Secret für den Zugriff auf Azure Entra ID (in Schritt 3 angelegt). | | tenant\_id | Ja | Ihre Tenant ID (in Schritt 3 ausgewählt). | | group | Nein | Optionale Filterung auf eine bestimmte Gruppe: Geben Sie die Object ID der Azure-Entra-ID-Gruppe an, deren Mitglieder abgerufen werden sollen. | | 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. | | 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). | | | WICHTIG: Sie können mehrere Domänen im Array “domains” konfigurieren. Achten Sie darauf, jede vollständige Domänenkonfiguration in geschweifte Klammern { } zu setzen. ### Schritt 5: Starten Öffnen Sie eine Eingabeaufforderung, wechseln Sie in den Ordner, in dem Ihr Azure-Entra-ID-Client liegt, und führen Sie aus: - “npm install” (nur einmal nötig) - “node server.js” Wenn alles wie vorgesehen funktioniert, sehen Sie in Ihrer Konsole eine Zeile wie diese: `https://graph.microsoft.com/v1.0/users?$top=999`. Sie können den Azure-Entra-ID-HTTP-Server nun im Browser testen, indem Sie `http://ip_oder_hostname_des_rechners_mit_dem_azure_entra_id_client:8080` aufrufen. Wenn Sie eine Firewall betreiben, geben Sie den Port 48800 frei. Wenn Ihr Browser ein JSON-Objekt mit den Benutzern anzeigt, die Sie bereitstellen möchten, funktioniert alles. ### Schritt 6: 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. Das Tablet holt sich die Informationen nun vom installierten Client. ### Schritt 7 (optional): Den Node-Prozess mit NSSM als Windows-Dienst betreiben Laden Sie die [neueste Version von NSSM](https://nssm.cc/download) herunter und entpacken Sie die zu Ihrer Architektur passende ausführbare Datei in einen Ordner Ihrer Wahl. Führen Sie dann folgenden Befehl aus: nssm install vizito\_azure\_entra\_id\_client Es öffnet sich ein Fenster, in dem Sie die Dienstparameter konfigurieren können. - Wählen Sie “node.exe” als Path. Sie finden es üblicherweise unter c:\\Program Files (x86)\\nodejs\\node.exe - Tragen Sie den vollständigen Pfad zu server.js in das Feld “Arguments” ein. - Optional können Sie im Tab “Details” einen Anzeigenamen für Ihren Dienst festlegen. Gehen Sie nun zu Ihren Windows-Diensten, starten Sie den neu angelegten Dienst und testen Sie. Denken Sie daran, alle manuell gestarteten Instanzen des Azure-Entra-ID-Clients zu beenden, bevor Sie den Dienst starten. ### 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.