Synchronisation mit Okta

Dieser Artikel wird Ihnen helfen, den Directory Connector zu verwenden, um Benutzer und Gruppen aus Ihrem Okta-Verzeichnis mit Ihrer Bitwarden-Organisation zu synchronisieren.

Directory Connector erfordert Kenntnisse eines von Okta generierten Tokens, um eine Verbindung zu Ihrem Verzeichnis herzustellen. Führen Sie die folgenden Schritte aus, um ein Okta API-Token für die Verwendung durch Directory Connector zu erstellen und zu erhalten:

1. Von Ihrer Okta Developer Console (https://yourdomain-admin.okta.com) navigieren Sie zu Sicherheit → API → Token.

2. Wählen Sie die Schaltfläche Token erstellen und geben Sie Ihrem Token einen Bitwarden-spezifischen Namen (zum Beispiel, bitwarden-dc).

3. Kopieren Sie den generierten Token-Wert in die Zwischenablage.

   Warnung

   Your token value will not be shown again. Paste it somewhere safe to prevent it from being lost.

Führen Sie die folgenden Schritte aus, um den Directory Connector für die Verwendung Ihres Okta-Verzeichnisses zu konfigurieren:

1. Öffnen Sie die Directory Connector Desktop-App.

2. Navigieren Sie zum Einstellungen Tab.

3. Wählen Sie aus dem Dropdown-Menü Typ die Option Okta aus.

   Die verfügbaren Felder in diesem Abschnitt ändern sich je nach Ihrem ausgewählten Typ.

4. Geben Sie Ihre Okta-Organisation-URL in das Feld Organisation-URL ein (zum Beispiel, https://yourdomain.okta.com).

5. Fügen Sie den API-Token-Wert in das Token-Feld ein.

Führen Sie die folgenden Schritte aus, um die Einstellungen zu konfigurieren, die verwendet werden, wenn die Synchronisation mit dem Directory Connector durchgeführt wird:

1. Öffnen Sie die Directory Connector Desktop-App.

2. Navigieren Sie zum Einstellungen Tab.

3. Im Abschnitt Synchronisation konfigurieren Sie die folgenden Optionen nach Wunsch:

Verwenden Sie durch Kommas getrennte Listen, um basierend auf der Benutzer-E-Mail-Adresse oder dem Gruppennamen einzuschließen oder auszuschließen. Zusätzlich bieten Okta APIs begrenzte Filterfunktionen für Benutzer und Gruppen, die in den Filterfeldern des Directory Connectors verwendet werden können.

Konsultieren Sie die Okta-Dokumentation für weitere Informationen zur Verwendung des Filter-Parameters für Benutzer und Gruppen.

Benutzerfilter

Benutzer per E-Mail-Adresse einbeziehen/ausschließen

Um spezifische Benutzer basierend auf der E-Mail-Adresse einzuschließen oder auszuschließen:

Bash
include:joe@example.com,bill@example.com,tom@example.com

Bash
exclude:joe@example.com,bill@example.com,tom@example.com

Verknüpfen mit Filter

Um einen Benutzerfilter mit dem Filter-Parameter zu verketten, verwenden Sie ein Pipe-Zeichen (|):

Bash
include:john@example.com,bill@example.com|profile.firstName eq "John"

Bash
exclude:john@example.com,bill@example.com|profile.firstName eq "John"

Verwenden Sie nur Filter

Um nur den Filter-Parameter zu verwenden, stellen Sie der Abfrage ein Pipe-Zeichen (|) voran:

Bash
|profile.lastName eq "Smith"

Gruppenfilter

Gruppen einbeziehen/ausschließen

Gruppen nach Namen ein- oder ausschließen:

Bash
include:Group A,Group B

Bash
exclude:Group A,Group B

Verknüpfen Sie mit Filter

Um einen Gruppenfilter mit dem Filter-Parameter zu verketten, verwenden Sie ein Pipe (|):

Bash
include:Group A|type eq "APP_GROUP"

Bash
exclude:Group A|type eq "APP_GROUP"

Verwenden Sie nur Filter

Um nur den Filter-Parameter zu verwenden, stellen Sie der Abfrage ein Pipe-Zeichen (|) voran:

Bash
|type eq "BUILT_IN"

Um zu testen, ob der Directory Connector erfolgreich eine Verbindung zu Ihrem Verzeichnis herstellt und die gewünschten Benutzer und Gruppen zurückgibt, navigieren Sie zum Dashboard Tab und wählen Sie die Jetzt testen Schaltfläche aus. Wenn erfolgreich, werden Benutzer und Gruppen gemäß den angegebenen Synchronisationsoptionen und Filtern im Directory Connector-Fenster angezeigt:

Sobald die Synchronisationsoptionen und Filter nach Wunsch konfiguriert sind, können Sie mit der Synchronisation beginnen. Führen Sie die folgenden Schritte aus, um die automatische Synchronisation mit dem Directory Connector zu starten:

1. Öffnen Sie die Directory Connector Desktop-App.

2. Navigieren Sie zum Dashboard Tab.

3. Im Abschnitt Synchronisation, wählen Sie die Schaltfläche Synchronisation starten.

   Sie können alternativ die Schaltfläche Jetzt synchronisieren auswählen, um eine einmalige manuelle Synchronisation auszuführen.

Der Directory Connector beginnt mit dem Abfragen Ihres Verzeichnisses basierend auf den konfigurierten Synchronisationsoptionen und Filtern.

Wenn Sie die Anwendung beenden oder schließen, wird die automatische Synchronisation gestoppt. Um den Directory Connector im Hintergrund laufen zu lassen, minimieren Sie die Anwendung oder verstecken Sie sie im Infobereich.