# 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 Desktop-App ](https://bitwarden.com/assets/7r6eylncijFasEUrKXe2Hk/b6eec60c8a6452a300eeba5272c46ea4/app.png)

Directory Connector ist auch als [CLI-Tool](https://bitwarden.com/de-de/help/directory-sync-cli/) verfügbar. Die Desktop-App und CLI [teilen sich eine Datenbank und Konfigurationen](https://bitwarden.com/de-de/help/directory-sync-shared/), 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](https://bitwarden.com/de-de/help/directory-sync-desktop/) abzuschließen und anschließend die [CLI](https://bitwarden.com/de-de/help/directory-sync-cli/) zu verwenden, um die [automatische Synchronisation](https://bitwarden.com/de-de/help/schedule-directory-sync/) mit Ihrer Produktionsorganisation zu planen.

## Erste Schritte

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](https://github.com/bitwarden/directory-connector/releases) herunter oder verwenden Sie einen der folgenden offiziellen Links:

 - 🪟 [Windows Installer (.exe)](https://bitwarden.com/download/?app=connector&platform=windows)
 - 🪟 [Windows Portable (.exe)](https://bitwarden.com/download/?app=connector&platform=windows&variant=portable)
 - 🍎 [macOS (.dmg)](https://bitwarden.com/download/?app=connector&platform=macos)
 - 🐧 [Linux (.AppImage)](https://bitwarden.com/download/?app=connector&platform=linux)
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](https://bitwarden.com/de-de/help/server-geographies/) 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](https://bitwarden.com/de-de/help/public-api/#authentication/) verwenden. Wenn Sie den API-Schlüssel nicht haben, wenden Sie sich an einen [Organisationseigentümer](https://bitwarden.com/de-de/help/user-types-access-control/).
4. Verbinden Sie sich im ⚙️ **Einstellungen**-Tab mit Ihrem Verzeichnis und konfigurieren Sie [Synchronisationsoptionen](https://bitwarden.com/de-de/help/user-group-filters/). 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](https://bitwarden.com/de-de/help/ldap-directory/)
 - [Synchronisation mit Azure Active Directory](https://bitwarden.com/de-de/help/microsoft-entra-id/)
 - [Synchronisation mit G Suite (Google)](https://bitwarden.com/de-de/help/workspace-directory/)
 - [Synchronisation mit Okta](https://bitwarden.com/de-de/help/okta-directory/)
 - [Synchronisation mit OneLogin](https://bitwarden.com/de-de/help/onelogin-directory/)

> [!NOTE] Clear sync cache
> 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](https://bitwarden.com/de-de/help/clear-sync-cache/)).
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] **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](https://bitwarden.com/de-de/help/directory-sync-desktop/#sync-with-directory-connector/).

## Synchronisation mit dem Directory Connector

Directory Connector kann verwendet werden, um eine einmalige [manuelle Synchronisation](https://bitwarden.com/de-de/help/directory-sync-desktop/#manual-sync/) durchzuführen oder [automatische Synchronisationsabfragen](https://bitwarden.com/de-de/help/directory-sync-desktop/#automatic-sync/):

### Manuelle Synchronisation

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

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

### Automatische Synchronisierung

Die automatische Synchronisation wird Ihr Verzeichnis basierend auf dem in Ihren **Synchronisationsoptionen** angegebenen [Intervall](https://bitwarden.com/de-de/help/user-group-filters/) 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] **Dashboard**-Tab und wählen Sie die Schaltfläche [play] **Synchronisation starten** aus.

> [!NOTE] Teams Starter + BWDC
> Wenn Sie den [Teams Starter](https://bitwarden.com/de-de/help/password-manager-plans/#teams-starter-organizations/)-Tarif haben, sind Sie auf 10 Mitglieder begrenzt. Der Directory Connector zeigt einen Fehler an und stoppt die Synchronisation, wenn Sie versuchen, mehr als 10 Mitglieder zu synchronisieren.