Directory Connector Desktop-App

Die Directory Connector Desktop-App ist eine eigenständige Desktop-Anwendung, die verwendet werden kann, um Benutzer, Gruppen und Gruppenzuordnungen aus einer Auswahl von Verzeichnisdiensten zu synchronisieren.

Directory Connector ist auch als CLI-Tool verfügbar. Die Desktop-App und CLI teilen sich eine Datenbank und Konfigurationen, daher wird die gleichzeitige Nutzung auf einem einzigen Gerät nicht empfohlen. Der empfohlene Weg besteht darin, die Konfiguration und das Testen mit der Desktop-App abzuschließen und anschließend die CLI zu verwenden, um die automatische Synchronisation mit Ihrer Produktionsorganisation zu planen.

Um die Directory Connector Desktop-App zu verwenden, gehen Sie wie folgt vor:

1. Laden Sie die neueste Version der App von unserer GitHub Releases-Seite herunter oder verwenden Sie einen der folgenden offiziellen Links:

   •  Windows Installer (.exe)

   •  Windows Portable (.exe)

   •  macOS (.dmg)

   •  Linux (.AppImage)

2. Stellen Sie die Server-URL ein, die vom Directory Connector verwendet wird, bevor Sie sich anmelden. Dies ist erforderlich, wenn Sie Bitwarden selbst hosten oder den EU-Server verwenden:

   1. Wählen Sie Einstellungen auf dem Anmeldebildschirm.

   2. Geben Sie im Feld Server-URL den Domain-Namen für die Bitwarden-Instanz mit https:// ein. Zum Beispiel, https://vault.bitwarden.eu oder https://your.domain.bitwarden.com.

   3. Wählen Sie Speichern.

3. Melden Sie sich bei Directory Connector an, indem Sie Ihren Organisations-API-Schlüssel verwenden. Wenn Sie den API-Schlüssel nicht haben, wenden Sie sich an einen Organisationseigentümer.

4. Verbinden Sie sich im  Einstellungen-Tab mit Ihrem Verzeichnis und konfigurieren Sie Synchronisationsoptionen. Dieses Verfahren hängt von dem verwendeten Verzeichnis ab, daher finden Sie in einem der folgenden Artikel entsprechende Anweisungen:

   • Synchronisation mit Active Directory oder LDAP

   • Synchronisation mit Azure Active Directory

   • Synchronisation mit G Suite (Google)

   • Synchronisation mit Okta

   • Synchronisation mit OneLogin

   Tipp

   Wenn Sie die Synchronisationsoptionen neu konfigurieren, anstatt sie zum ersten Mal einzustellen, navigieren Sie zum Mehr-Tab und wählen Sie die Schaltfläche Sync-Cache löschen aus, um mögliche Konflikte mit vorherigen Synchronisationsoperationen zu vermeiden (mehr erfahren).

5. Wählen Sie im  Einstellungen-Tab Ihre Organisation aus dem Organisations-Dropdown-Menü aus.

6. Führen Sie eine Testsynchronisierung durch . Um zu überprüfen, ob Ihre Verzeichnisverbindung und Synchronisationsoptionen erfolgreich konfiguriert sind und wie erwartet funktionieren:

   1. Öffnen Sie das  Dashboard-Tab.

   2. Wählen Sie die Schaltfläche Jetzt testen.

Die Synchronisationstests werden den Verzeichnisserver abfragen und die Ergebnisse auf dem Dashboard ausgeben. Wenn die gedruckten Ergebnisse Ihren Erwartungen entsprechen, sind Sie bereit, mit der Synchronisation zu beginnen.

Directory Connector kann verwendet werden, um eine einmalige manuelle Synchronisation durchzuführen oder automatische Synchronisationsabfragen:

Um eine einmalige manuelle Synchronisation von Ihrem Verzeichnis zu Ihrer Bitwarden Organisation durchzuführen, öffnen Sie den  Dashboard-Tab und wählen Sie die Schaltfläche  Jetzt synchronisieren aus.

Synchronisierte Benutzer werden zu Ihrer Organisation eingeladen und Gruppen werden sofort erstellt.

Die automatische Synchronisation wird Ihr Verzeichnis basierend auf dem in Ihren Synchronisationsoptionen angegebenen Intervall abfragen, solange die Anwendung geöffnet ist. Wenn Sie die Anwendung beenden oder schließen, wird die automatische Synchronisationsabfrage gestoppt.

Um die automatische Synchronisationsabfrage mit dem Directory Connector zu starten, öffnen Sie das  Dashboard-Tab und wählen Sie die Schaltfläche  Synchronisation starten aus.