WooCommerce SSO-Integration für WordPress mit Keycloak zur Benutzersynchronisierung

Single Sign-On (SSO) erfüllt die grundlegendste Anforderung der Authentifizierung mit nur einem Satz Anmeldeinformationen in jeder Geschäftsumgebung und steigert so die Effizienz der Benutzerdatenverwaltung. Wir betrachten hier einen praktischen Anwendungsfall, in dem Benutzer SSO auf einer WooCommerce-WordPress-Website nutzen und eine Synchronisierung erforderlich ist, um Benutzer in Keycloak (Identitätsanbieter) anzulegen. Das SAML-SSO-Plugin ermöglicht die sichere Authentifizierung für WordPress und bietet Attribut- und Rollenzuordnung. Dadurch können Benutzerprofile von Keycloak (Identitätsanbieter) mit den WooCommerce-Profilfeldern synchronisiert bzw. zugeordnet und Rollen basierend auf der Benutzergruppe zugewiesen werden.

Szenario

Sie verfügen über eine WordPress-Site, auf der Sie Rabattgutscheine für Kurse auf einer externen LMS-Plattform verkaufen können, und Ihre Benutzer sind in Keycloak gespeichert.

• Woocommerce ist auf der WordPress-Site installiert, um Rabattgutscheine zu verkaufen
• Keycloak ist der Identitätsanbieter, dh Benutzer werden in Keycloak gespeichert
• Benutzer registrieren sich auf der Woocommerce-Website, um Rabattgutscheine für LMS-Kurse zu erwerben

Voraussetzungen:

1. WooCommerce Single Sign-On (SSO): Einmaliges Anmelden auf der Woocommerce-Website für Benutzer, damit sich Benutzer mit ihren Keycloak-Anmeldeinformationen bei Woocommerce anmelden und Rabattgutscheine kaufen können. Wenn der Benutzer bereits bei der LMS-Plattform angemeldet ist, ermöglicht Woocommerce SSO Benutzern den Zugriff auf die Woocommerce-Rabattgutscheine, ohne ihre Anmeldeinformationen zur Authentifizierung erneut eingeben zu müssen.
2. WooCommerce-Benutzersynchronisierung mit Keycloak: Synchronisieren Sie Benutzer mit Keycloak, die sich während des Bezahlvorgangs auf der WooCommerce-Website registrieren. Dadurch können die Benutzer mit denselben Anmeldeinformationen auf die LMS-Plattform zugreifen.

Beteiligte Komponenten

1. SAML-SSO-Plugin Für - Das SAML SSO for WordPress Plugin dient zur Authentifizierung (Single Sign-On) von Benutzern und ermöglicht ihnen, sich mit Keycloak als Identitätsanbieter bei der WooCommerce-Website anzumelden.

SAML Single Sign On – SAML SSO-Anmeldung
By miniOrange
(135)
Single Sign-On (SSO)-Anmeldung mit Azure, Azure B2C, Okta, ADFS, Keycloak, Salesforce, Ping, Onelogin, G Suite, Shibboleth und vielen SAML-Identitätsanbietern [24/7-Support]
 Getestet mit 5.8.2
Holen Sie sich dieses Plugin


2. Keycloak-Benutzersynchronisierungs-Plugin - Das miniOrange Woocommerce Keycloak User Sync-Add-on ermöglicht die Erstellung von Benutzerkonten in Keycloak, wenn ein neuer Benutzer ein Konto in WordPress erstellt, während er eine Bestellung auf der Woocommerce-Checkout-Seite auscheckt.

Keycloak-Benutzersynchronisierungs-Plugin
By miniOrange
[24/7-SUPPORT]
 Getestet mit 5.8.2
Kontakt

Lösung

Wenn der Benutzer vor dem Kauf auf die Checkout-Seite gelangt, kann vor Abschluss der Transaktion eines der beiden folgenden Szenarios eintreten:

1. Benutzer registrieren sich bei WooCommerce

• Mit Hilfe der Gastbenutzeroption In WooCommerce können neue Konten an der Kasse erstellt werden.



• Wenn ein nicht registrierter Benutzer versucht, einen Rabattcoupon auf WooCommerce zu kaufen, registriert sich der Benutzer zuerst über WordPress auf der WooCommerce-Website.
• Zur Registrierung gibt der Nutzer seine persönlichen Daten an und im Zuge des Bestellvorgangs wird für den Nutzer ein Konto in WordPress erstellt.
• Nach der Erstellung des WordPress-Kontos wird mit Hilfe der Clients Grant-Konfiguration in Keycloak User Sync ein Zugriffstoken von Keycloak abgerufen, um Benutzer zu synchronisieren.
• Mithilfe des Keycloak User Sync-Plugins wird ein Keycloak-Konto für den Benutzer mit identischen Attributen erstellt.
• Der Benutzer wird dann einer bereits bestehenden Gruppe in Keycloak zugewiesen.

2. Der Benutzer meldet sich mit Keycloak an

• Sobald das Benutzerkonto in WooCommerce registriert ist, kann der Benutzer eine SSO-Verbindung zur WordPress-Site herstellen und dabei Keycloak als Identitätsanbieter verwenden.
• Wenn der Benutzer erneut einen Kauf tätigen möchte, hat er/sie die Möglichkeit, Keycloak auszuwählen, um sich auf der Anmeldeseite der WooCommerce-Site anzumelden.
• Mit Hilfe des SAML-SSO-Plugins haben wiederkehrende Benutzer die Möglichkeit, sich mit Hilfe von IDP einmalig bei WooCommerce anzumelden.
• Wenn der Benutzer eine aktive Sitzung auf Keycloak hat, wird der Benutzer authentifiziert und zur Checkout-Seite weitergeleitet.
• Wenn der Benutzer von Keycloak abgemeldet ist, also keine aktive Sitzung in Keycloak hat, wird er zur Anmeldeseite von Keycloak weitergeleitet, um sich zu authentifizieren.

So richten Sie die Keycloak-Benutzersynchronisierung mit WooCommerce ein

Voraussetzung: SAML-SSO-Plugin für WordPress einrichten

Um Single Sign-On mit WordPress als Dienstanbieter und Keycloak als Identitätsanbieter einzurichten, folgen Sie den Schritten in der hier bereitgestellten Einrichtungsanleitung.

Richten Sie die Keycloak-Benutzersynchronisierung mit WooCommerce ein

Um die Benutzersynchronisierung von WooCommerce zu Keycloak einzurichten, führen Sie die folgenden Schritte aus:

1. Keycloak-Client einrichten

• Melden Sie sich als Administrator bei Ihrem Keycloak-Server an.

Rollen hinzufügen:

• Navigieren Sie zu Ihrem Realm und klicken Sie auf Rollen. Klicken Sie Speichern .
  

Hinweis: Wenn Ihr Realm-Name ein Leerzeichen enthält, schlagen API-Anfragen fehl. Stellen Sie daher sicher, dass er kein Leerzeichen enthält.

• Geben Sie als Rollennamen „create-realm“ ein und geben Sie im Feld „Beschreibung“ ${role_create-realm} ein. Klicken Sie darauf Gespeichert.


• Gehen Sie nun zurück zu Rollen und klicken Sie erneut auf Speichern.
• Geben Sie den Rollennamen als Administratorbeschreibung als ${role_admin} ein und klicken Sie auf Speichern.
• Aktivieren Sie den Schalter „Zusammengesetzte Rollen“. Unten wird ein neuer Abschnitt angezeigt.
• Wählen Sie das aus und fügen Sie es hinzu Bereich erstellen Rolle, die mit dem verknüpft werden soll Admin Rolle.

Client erstellen:

• Navigieren Sie zu Ihrem Realm > Kunden und klicken Sie auf Erstellen, um einen neuen Kunden zu erstellen.


• Geben Sie eine Client-ID für Ihren Client ein, wählen Sie als Client-Protokoll „openid-connect“ aus und klicken Sie auf „Speichern“ (schließen Sie keine Leerzeichen in die Client-ID ein).



Nachdem Sie auf „Speichern“ geklickt haben, werden mehrere Konfigurationseinstellungen angezeigt. Scrollen Sie nach unten, übernehmen Sie die folgenden Client-Konfigurationen und klicken Sie auf „Speichern“:

• Client-Protokoll: openid-connect
• Zugriffstyp: vertraulich
• Direktzugriffszuschüsse aktiviert: EIN
• Dienstkonten aktiviert: EIN

Anwenden von Rollen auf den Client

• Klicken Sie nun in Ihrem Client auf die Registerkarte Dienstkontorollen.
• Von Realm-Rollen wählen Admin und füge es hinzu Zugewiesene Rollen.
• Aus der Dropdown-Liste von Kundenrollen Wählen Sie Realm-Management.
• Fügen Sie Benutzer verwalten Rolle zu Zugewiesene Rollen.

2. Einrichten des Keycloak User Sync-Plugins

Bitte füllen Sie die folgenden Felder mit den erforderlichen Werten im Keycloak User Sync Plugin aus:

Hinweis: Bei allen Feldern wird zwischen Groß- und Kleinschreibung unterschieden.

Server-URL	Geben Sie die URL Ihres Keycloak-Servers mit dem Schema-Präfix (http/https) ein, z. B.: https://example.com
Server-Port	Geben Sie die Portnummer ein, auf der Ihr Keycloak-Server läuft. Standardmäßig ist es 8080.
Bereichsname	Geben Sie den Namen des Keycloak-Bereichs ein, in dem Sie in den vorherigen Schritten einen Client konfiguriert haben.
Gruppenname	Geben Sie den Namen der Keycloak-Benutzergruppe ein, zu der Sie alle synchronisierten Benutzerkonten hinzufügen möchten.

Hinweis: Wenn Sie Keycloak IDP im miniOrange SAML 2.0 SSO-Plugin konfiguriert haben, werden die ersten beiden Felder (Server-URL & Server-Port) mit diesen Werten ausgefüllt. Sie können diese bei Bedarf bearbeiten.

Konfigurieren Sie unter „Client Credentials Grant Configuration“ die folgenden Werte:

Sie müssen zwei Felder für diesen Zuschuss konfigurieren:

• Kunden ID: Geben Sie die Client-ID des Clients ein, den Sie in Keycloak konfiguriert haben. Den Kunden finden Sie in der Kundenliste in Ihrem Realm.


• Kundengeheimnis: Um den Wert des Client-Geheimnisses zu erhalten, navigieren Sie in Ihrem Client zur Registerkarte „Anmeldeinformationen“. Wählen Sie „Client-ID und -Geheimnis“ aus der Dropdown-Liste „Client-Authentifikator“ aus und kopieren Sie das Client-Geheimnis.

3. Aktivieren Sie die Gastbenutzeroption in WooCommerce

Mit dieser Option können Ihre Benutzer beim Bezahlvorgang Konten erstellen.

Schritte:

• Navigieren Sie in Ihrem Woocommerce-Plugin zu Konten und Datenschutz Registerkarte in den Einstellungen.
• Stellen Sie sicher, dass Sie das Kontrollkästchen deaktivieren Ermöglichen Sie Kunden, Bestellungen ohne Konto aufzugeben Mit dieser Option werden Benutzer dazu gezwungen, an der Kasse ein Konto zu erstellen.
• Aktivieren Sie die Ermöglichen Sie Kunden, während des Bezahlvorgangs ein Konto zu erstellen .

Fazit

Mithilfe des SAML SSO-Plugins für WordPress und des Keycloak User Sync-Plugins haben Sie Ihre WooCommerce-Website so konfiguriert, dass Benutzer bei der Registrierung in WordPress angelegt und erfolgreich mit Keycloak (Identitätsanbieter) synchronisiert werden . Diese Benutzer authentifizieren sich bei der Registrierung über Keycloak, um sich in Zukunft in die WooCommerce-Website einzuloggen und Rabattcoupons sowie Single Sign-On für WordPress mit Keycloak zu erwerben.

Unser SAML-SSO-Plugin für WordPress unterstützt Integrationen mit einer Reihe von Addons um die Funktionalität Ihrer Website zu erweitern.
Wenn Sie individuelle Anforderungen haben, kontaktieren Sie uns bitte unter samlsupport@xecurify.com und wir helfen Ihnen, Ihren Anwendungsfall zu verwirklichen.

Weitere Informationen

• WooCommerce-Integration
• Was ist Single Sign-On (SSO)?
• SSO in WooCommerce
• Keycloak SAML Single Sign-On für WordPress
• Was ist SAML?
• Häufig gestellte Fragen (FAQs)
• Top-Tools zum Aufbau einer E-Commerce-Website