Richten Sie die Drupal Okta-Benutzersynchronisierung ein
Übersicht
Die Integration von Okta User Provisioning mit Drupal vereinfacht die Benutzerverwaltung und sorgt für aktuelle Benutzerinformationen im System. Diese Schritt-für-Schritt-Anleitung unterstützt Sie bei der Konfiguration der Benutzerbereitstellung/-synchronisierung von der Drupal-Site zur Okta-Anwendung. So können Administratoren problemlos Benutzer bereitstellen und Benutzerdaten mit manueller, automatischer oder zeitplanbasierter Bereitstellung verwalten, indem sie die Drupal Okta User Sync-Modul. Dieses Modul ist mit Drupal 9, Drupal 10 und Drupal 11 kompatibel.
Installationsschritte
- Verwenden von Composer
- Mit Drush
- Manuelle Installation
Konfigurationsschritte
Konfigurieren Sie Drupal als SCIM-Client
- Navigieren Sie nach der Installation des Moduls auf der Drupal-Site im Menü „Verwaltung“ zu Konfiguration → Personen → miniOrange Okta User Sync. (/admin/config/people/okta_user_sync/overview)
- Werfen Sie einen Blick auf die Funktion des Moduls und klicken Sie auf Lassen Sie uns das Modul konfigurieren .
Integration von Drupal mit Okta
- Konfigurieren Sie die im folgenden Screenshot genannten Werte von Okta in Drupal.
- Okta-Portal-URL: Die Okta-Portal-URL ist nichts anderes als die Okta-Domäne oder man kann sagen, es ist die Basis-URL für den Org-Autorisierungsserver von Okta. Zum Beispiel https://{yourOktaDomain}.okta.com Kopieren Sie diese URL und fügen Sie sie in Drupals ein. Okta-Portal-URL Textfeld.
- Okta-Inhaber-Token:
- Der Okta Bearer Token ist ein Schlüssel, der zur Authentifizierung von Anfragen an Okta-APIs verwendet wird. Wenn Sie einen Okta-API-Endpunkt aufrufen, müssen Sie für die Authentifizierung einen gültigen API-Token angeben.
- Um dieses API-Token zu generieren, melden Sie sich mit den Administratoranmeldeinformationen bei Ihrer Okta-Organisation an.
- Navigieren Sie in der Admin-Konsole zu Sicherheit → API aus dem Menü.
- Navigieren Sie auf der API-Seite zu Tokens Klicken Sie auf die Registerkarte Token erstellen .
- Geben Sie den Namen Ihres Tokens ein und klicken Sie Token erstellen.

- Kopieren Sie das generierte Token-Wert und notieren Sie es, da Sie keine weitere Gelegenheit haben werden, es anzusehen und aufzuzeichnen.

- Navigieren Sie zurück zur Drupal-Site und fügen Sie die kopierte Datei ein Inhaber-Token bei Drupal
Okta-Inhaber-Token Textfeld.

- Testen Sie Ihre Konfiguration: Im Testen Sie Ihre Konfiguration (Geben Sie die E-Mail-Adresse des Benutzers ein) Geben Sie in das Feld die E-Mail-ID eines Benutzers ein. (Stellen Sie sicher, dass in Ihrem Okta-Portal ein Benutzer mit derselben E-Mail-Adresse vorhanden ist.)
Testkonfiguration
- Wenn Sie mit allen Konfigurationen fertig sind, klicken Sie auf Konfiguration speichern und testen .
- Wenn die Testkonfiguration erfolgreich ist, erhalten Sie eine Erfolgsmeldung wie diese:
- Alternativ können Sie, wenn bei der Integration von Okta mit Drupal ein Fehler auftritt, die Fehlerursache überprüfen, indem Sie dem Link in der Fehlermeldung folgen oder nach unten zum Abschnitt „Testkonfigurationsergebnis“ scrollen.
- Wenn der Test erfolgreich war, klicken Sie auf Next .
- Das Modul unterstützt bidirektionale Synchronisierung. Um die Benutzer von Drupal mit Okta zu synchronisieren, wählen Sie Synchronisierung von Drupal mit Okta.
- In Schritt 3 gibt es drei Möglichkeiten, die Benutzerbereitstellung durchzuführen (manuell, automatisch oder zeitplanbasiert). Um die gewünschte Methode zu konfigurieren, klicken Sie innerhalb der entsprechenden Methode auf die Schaltfläche „Konfigurieren“ und wählen Sie die Vorgänge aus, die Sie durchführen möchten (Erstellen, Löschen, Deaktivieren und Aktualisieren).
- Klicken Sie nach der Konfiguration auf Alles erledigt .
- Manuelle/On-Demand-Bereitstellung
- Automatische Bereitstellung
Bei der manuellen/On-Demand-Bereitstellung können Sie den Benutzer manuell mit Okta synchronisieren. Außerdem ist die Bereitstellung eines einzelnen Benutzers sowie aller vorhandenen Benutzer auf einmal für Okta möglich.
Konfigurieren Sie die manuelle/On-Demand-Bereitstellung
- Erstellen Sie Benutzer in Okta:
- Im Drupal zu Okta Bitte stellen Sie sicher, dass Sie die Registerkarte ausgewählt haben Benutzer lesen und Benutzer erstellen Kontrollkästchen unter dem Manuelle Bereitstellungskonfiguration.
- Klicken Sie auf Benutzer manuell synchronisieren .
- Suchen Sie nach dem Benutzer, den Sie für Okta bereitstellen möchten, wählen Sie den Benutzer aus und klicken Sie auf
Synchronisierung .
- Um zu überprüfen, ob der Benutzer bereitgestellt ist oder nicht, navigieren Sie zu Personen unter dem Verzeichnis und bestätigen Sie den Status des Benutzers.
- Benutzer deaktivieren
- Stellen Sie sicher, dass Sie unter „Manuelle Bereitstellungskonfiguration“ ausgewählt haben Benutzer lesen und Benutzer deaktivieren Ankreuzfelder
- Um den Benutzer von Okta zu deaktivieren, muss sich der Benutzer auf der Drupal-Site im blockierten Zustand befinden.
- Navigieren Sie dazu zur Registerkarte „Personen“, bearbeiten Sie das Profil des jeweiligen Benutzers (/user/{user_id}/edit) und ändern Sie den Status des Benutzers in Gesperrt.
- Wenn Sie fertig sind, klicken Sie auf Speichern .
- Gehen Sie jetzt zurück zum Drupal zu Okta Sync und klicken Sie auf Benutzer manuell synchronisieren .
- Geben Sie den Benutzernamen des blockierten Benutzers in das Textfeld ein und klicken Sie auf Synchronisierung
Schaltfläche, um denselben Benutzer auf Okta zu deaktivieren.
- Um zu bestätigen, ob der Benutzer deaktiviert wurde oder nicht, gehen Sie zu Personen
von Okta und überprüfen Sie den Benutzerstatus.
Mit dieser Art der Bereitstellung können Sie Benutzer mit Okta synchronisieren, wenn in Drupal CRUD-Vorgänge für sie ausgeführt werden.
Konfigurieren Sie die automatische Bereitstellung
- Die automatische Bereitstellung hilft Ihnen bei der Bereitstellung Ihrer Benutzer mithilfe eines der folgenden Ereignisse:
- Admin-Oberfläche: Wenn Administratoren oder privilegierte Benutzer manuell CRUD-Operationen auf dem Konto eines Benutzerkontos über die Drupal-Administratoroberfläche durchführen.
- Änderung des Benutzerkontos: Immer wenn Benutzer selbst CRUD-Operationen an ihrem eigenen Informationsformular user/{user_id}/edit oder einem anderen benutzerdefinierten Formular durchführen.
- Module von Drittanbietern: Immer wenn eine Benutzerentität auf der Drupal-Site mithilfe von Modulen/Anwendungen von Drittanbietern oder benutzerdefiniertem Code aktualisiert/erstellt wird
- Benutzer Registration: Immer wenn ein Benutzer ein neues Konto in Drupal erstellt. (/user/register)
Sehen wir uns an, wie der Benutzer mithilfe der automatischen Bereitstellung in Okta erstellt werden kann.
- Benutzer erstellen:
- Im Drupal zu Okta Bitte stellen Sie sicher, dass Sie die Registerkarte ausgewählt haben Benutzer lesen und Benutzer erstellen Kontrollkästchen unter dem Automatische Bereitstellungskonfiguration.
- Benutzer können Okta auf folgende Weise bereitgestellt werden:
- Erstellen Sie den Benutzer ohne Anmeldeinformationen: Mit dieser Methode wird der Benutzer mit Ausnahme des Kennworts im Status „Staged“ für das Okta-Portal bereitgestellt. Der Administrator muss den Benutzer aktivieren und einen Link zum Zurücksetzen des Kennworts senden. Auf diese Weise können Sie die bereitgestellten Benutzer überprüfen und eine schnelle Kontrolle durchführen.
- Erstellen Sie den Benutzer mit dem Passwort: Bei dieser Methode wird der Benutzer zusammen mit einem Kennwort und einem Status „Staged“ für das Okta-Portal bereitgestellt. Sobald der Administrator den Benutzer aktiviert, kann der Benutzer mit demselben Kennwort wie auf der Drupal-Site auf das Okta-Portal zugreifen. (Bitte beachten Sie, dass die automatische Benutzerbereitstellung in diesem Fall fehlschlägt, wenn das Drupal-Benutzerkennwort gegen die Okta-Kennwortrichtlinie verstößt.) Auf diese Weise können Sie sicherstellen, dass für beide Anwendungen ein starkes und konsistentes Kennwort verwendet wird.
Hinweis: Falls Sie die Benutzer in Okta in einem aktiven Zustand bereitstellen möchten, um den zusätzlichen Schritt zu vermeiden, oder wenn Sie einen anderen spezifischen Anwendungsfall haben, können Sie sich gerne an uns wenden unter drupalsupport@xecurify.com.
- Sobald Sie mit der Konfiguration fertig sind, navigieren Sie zur Anmeldeseite von Drupal und klicken Sie auf
Neues Konto erstellen tab(/user/register).
- Geben Sie die Details ein und klicken Sie auf das Neues Konto erstellen .
- Nachdem Sie den Benutzer erfolgreich in Drupal erstellt haben, gehen Sie zu Personen Registerkarte unter dem
Verzeichnis von Okta. Hier sehen Sie, dass der Benutzer erfolgreich angelegt wurde
- Benutzer deaktivieren:
- Stellen Sie sicher, dass Sie unter „Konfiguration der automatischen Bereitstellung“ ausgewählt haben Benutzer lesen und Benutzer deaktivieren Ankreuzfelder
- Um den Benutzer von Okta zu deaktivieren, muss sich der Benutzer auf der Drupal-Site im blockierten Zustand befinden.
- Navigieren Sie dazu zu Personen Bearbeiten Sie das Profil des jeweiligen Benutzers (/user/{user_id}/edit) und ändern Sie den Status des Benutzers in Gesperrt.
- Wenn Sie fertig sind, klicken Sie auf Gespeichert .

- Um zu bestätigen, ob der Benutzer deaktiviert wurde oder nicht, gehen Sie zu Personen von Okta und überprüfen Sie den Benutzerstatus.

Das ist es!! Sie haben die Benutzer erfolgreich mit Okta bereitgestellt.
Wenn die Bereitstellung nicht erfolgreich war, kontaktieren Sie uns bitte unter drupalsupport@xecurify.com. Bitte senden Sie den Screenshot des Fehlerfensters. Wir helfen Ihnen dann bei der Lösung des Problems und führen Sie durch die Einrichtung.