Joomla User Sync Integration mit Keycloak
Übersicht
Keycloak-Benutzersynchronisierung ist ein benutzerfreundliches Plugin für Joomla, das die Synchronisierung von Benutzerdaten zwischen Keycloak, einer Identitätsmanagement-Plattform, und Joomla erleichtert. Dieses Plugin verwendet die Keycloak Rest-API zum Abrufen aller Benutzerprofile von Keycloak in die Joomla-Datenbank. Nahtlose Unterstützung für erweiterte Synchronisierungsfunktionen wie bidirektionale Benutzersynchronisierung, automatische Benutzererstellung und -löschung, Gruppenzuordnung und vieles mehr. Es bietet eine einfache und sichere Möglichkeit, Benutzerinformationen zu synchronisieren. Administratoren können Benutzer bereitstellen und Benutzerdaten manuell, bedarfsgesteuert oder planmäßig verwalten.
Schritte zum Einrichten der Keycloak-Benutzersynchronisierung für Joomla
Schritt 1: Installieren Sie das User Provisioning Plugin
- Laden Sie die ZIP-Datei für das miniOrange User Provisioning/User Sync-Plugin von herunter Link hier .
- Melden Sie sich bei der Administratorkonsole Ihrer Joomla-Site an.
- Klicken Sie im Menü auf System, dann unter Installieren Klicken Sie im Abschnitt auf Erweiterungen.
- Laden Sie die heruntergeladene ZIP-Datei hoch, um die zu installieren Benutzerbereitstellung/Benutzersynchronisierung plugin.
- Die Installation des Plugins ist erfolgreich. Klicken Sie nun auf Jetzt loslegen! .
- Auswählen „Schlüsselumhang“ aus der Anbieterliste.
Schritt 2: Keycloak konfigurieren
- Gehen Sie zu Ihrem Keycloak-Konsole und wählen Sie Ihr Reich aus und klicken Sie auf Nutzer. Stellen Sie sicher, dass der Name Ihres Realms kein Leerzeichen enthält.
- Gehe zu Nutzer und klicken Sie auf Benutzer hinzufügen Schaltfläche zum Erstellen eines neuen Benutzers.
- Geben Sie beim Erstellen eines neuen Benutzers die erforderlichen Details ein und klicken Sie auf Kreation.
- Nachdem ein Benutzer erstellt wurde, gehen Sie zu Registerkarte „Anmeldeinformationen“. und klicken Sie auf das Passwort festlegen Klicken Sie auf die Schaltfläche, um ein Passwort für den Benutzer festzulegen.
- Geben Sie das Benutzerpasswort ein und klicken Sie auf Gespeichert.
Hinweis: Wenn Sie „Temporär“ deaktivieren, wird das Benutzerkennwort dauerhaft.
- Sobald das Benutzerpasswort festgelegt ist, gehen Sie zu Rollenzuordnung und weisen Sie dem Benutzer die Rolle 'Benutzer verwalten' unter dem 'Realm-Management' Kundenrollen.
- Filtern Sie die Rollen nach Nach Kunden filtern und suchen Sie nach BenutzerWählen Sie die Realm-Management, Benutzer verwalten Rolle und klicken Sie auf Weisen .
Schritt 3: Erstellen Sie einen Client
- Um einen Kunden zu erstellen, klicken Sie auf Kunden Abschnitt im linken Bereich und klicken Sie auf das Client erstellen .
- Um den Client zu erstellen, geben Sie die erforderlichen Details ein und klicken Sie auf Nächster .
Hinweis: Zwischen der Client-ID dürfen keine Leerzeichen stehen.
- Wählen Sie im nächsten Schritt nur die aus Direktzugriffsgewährung geben Sie ein und klicken Sie auf das Gespeichert .
- Alle Konfigurationen sind auf der Keycloak-Seite abgeschlossen. Gehen wir zu unserem Joomla Keycloak-Synchronisations-Plugin und schließen die Plugin-Konfiguration ab.
Schritt 4: Konfigurieren Sie das Keycloak User Sync Plugin
- Gehen Sie zur Registerkarte „Keycloak konfigurieren“ und geben Sie die Keycloak-Domäne, die Client-ID und Ihren Realm-Namen aus der Keycloak-Anwendung ein, die Sie oben erstellt haben.
- Um die Keycloak-Domäne zu kopieren, gehen Sie zu Ihrem Keycloak-Konsole und kopieren Sie die Domain.
- Geben Sie das kopierte ein Keycloak-Domäne Name in der Feld „Keycloak-Domäne“. auf der Registerkarte „Keycloak konfigurieren“ vorhanden.
- Um die Client-ID zu kopieren, bewegen Sie den Mauszeiger über Ihre Keycloak-Einstellungen und kopieren Sie die Client-ID von dort wie unten gezeigt.
- Kopieren Sie die Client-ID und fügen Sie sie in das Feld „Client-ID“ auf der Registerkarte „Keycloak konfigurieren“ ein.
- Um den Realm-Namen zu kopieren, gehen Sie zu Ihrem Keycloak-Bedienfeld und kopieren Sie den Realm-Namen.
- Fügen Sie es dann in das Feld „Realm“ auf der Registerkarte „Keycloak konfigurieren“ ein.
- Geben Sie den Benutzernamen und das Passwort des Benutzers ein, den Sie mit der Erlaubnis von erstellt haben 'Benutzer verwalten'.
- Geben Sie die Benutzername eines beliebigen Benutzers (mit der Berechtigung „Benutzer verwalten“) aus Ihrer Keycloak-Anwendung. Dies wird für die Testkonfiguration verwendet.
- Geben Sie die Testbenutzername hier und klicken Sie dann auf die Konfiguration speichern .
- Herzlichen Glückwunsch, Sie haben das erfolgreich verifiziert E-Mail-Adresse des Benutzers bei der Anmeldung.
Schritt 5: Testkonfiguration
- Um zu testen, ob die Verbindung erfolgreich ist oder nicht, klicken Sie auf Verbindung testen Schaltfläche vorhanden im Konfigurieren Sie Keycloak Tab.
Schritt 6: Benutzer mit Joomla-Datenbank synchronisieren
- Navigieren Sie zur Registerkarte Keycloak -> Joomla. Unter dem Zuordnung von Benutzerattributen Ordnen Sie im Abschnitt den Keycloak-Attributnamen dem entsprechenden Joomla-Attributnamen zu und klicken Sie auf Konfiguration speichern.
Synchronisieren Sie einen einzelnen Benutzer oder alle Benutzer
- Enter UserPrincipalName/ID eines beliebigen Benutzers Ihrer Keycloak-Anwendung.
- Klicken Sie auf Benutzer erstellen Schaltfläche, um Ihren Keycloak-Benutzer für die Datenbank Ihrer Joomla-Site zu erstellen.
- Oder klicken Sie auf Alle Benutzer erstellen Schaltfläche, um alle Benutzer aus den Keycloak-Benutzern mit der Datenbank Ihrer Joomla-Site zu synchronisieren. (Hinweis: Dies ist eine Premium-Funktion.)
Benutzergruppen synchronisieren (Premium-Funktion)
- Unter dem Benutzergruppen synchronisierenSie können Benutzergruppen von Keycloak zu Joomla-Benutzergruppen zuordnen. Wählen Sie außerdem die Standardgruppe für neue/angemeldete Benutzer aus.
Legen Sie das Benutzersynchronisierungsintervall fest (Premium-Funktion)
- Der Legen Sie das Benutzersynchronisierungsintervall fest Richten Sie im Abschnitt „Benutzersynchronisierung“ einen Zeitplan für die automatische Benutzersynchronisierung auf stündlicher, täglicher oder wöchentlicher Basis ein.
Schritt 7: Benutzer erstellen und löschen
Benutzer erstellen und löschen
- Navigieren Sie zur Registerkarte Joomla -> Keycloak. Hier, unter dem Erstellen Sie einen einzelnen Benutzer Abschnitt: Jeder in Joomla erstellte Benutzer wird automatisch synchronisiert und in Keycloak erstellt.
- Unter dem Benutzer löschen Im Abschnitt können Sie einen einzelnen Benutzer aus Keycloak löschen.
Automatische Bereitstellung (Premium-Funktion)
- Unter dem Automatische Bereitstellung Im Abschnitt „Benutzerverwaltung“ können Sie die Bereitstellung automatisieren, wenn ein Benutzer erstellt, gelöscht oder aktualisiert wird. Sie können auch die automatische Synchronisierung des Joomla-Benutzerkennworts aktivieren.
Benutzerattribute synchronisieren und Intervall festlegen (Premium-Funktion)
- Unter dem Benutzerattribut synchronisieren Auf der Registerkarte können Sie Benutzerattribute von Joomla zu Keycloak zuordnen.
- Sie können auch einen Zeitplan für die automatische Benutzersynchronisierung einrichten Benutzersynchronisierungsintervall festlegen Tab.
Sie haben Keycloak User Sync erfolgreich mit Joomla konfiguriert. Sollten Sie etwas nicht finden, schreiben Sie uns bitte eine E-Mail an joomlasupport@xecurify.com.
