Wie konfiguriere ich Single Sign-On (SSO) in Shopify mit Keycloak als IDP (OAuth)?
Übersicht
miniOrange ermöglicht Keycloak als IDP (Identitätsanbieter), der es Benutzern ermöglicht
Single Sign-On (SSO) bei Shopify mit Keycloak-Anmeldeinformationen. Unsere Anwendung ist mit allen SAML-/OAuth-kompatiblen Identitätsanbietern kompatibel. Wir werden eine Schritt-für-Schritt-Anleitung zur Konfiguration durchgehen
Single Sign-On (SSO) bei Shopify mit automatisierten
Keycloak als IdP (Identitätsanbieter) und
Shopify-Shop als SP (Dienstleister).
Konfigurieren Sie [SAML] SSO in Shopify mit Keycloak als IdP
Um Single Sign-On (SSO) mit Shopify über das SAML-Protokoll mit Keycloak als Identitätsanbieter (IdP) einzurichten, folgen Sie den beschriebenen Schritten
..
Voraussetzungen: Single Sign On - SSO-Anmeldeanwendung
Starten Sie den Keycloak-Server basierend auf Ihrer Keycloak-Version. (Siehe Tabelle unten)
Für die Keycloak-Version 16 und niedriger
Gehen Sie zum Stammverzeichnis von keycloak
Kasten
standalone.sh
Für die Keycloak-Version 17 und höher
Gehen Sie zum Stammverzeichnis von keycloak
Kasten
kc.bat und führen Sie die folgenden Befehle aus.
1. kc.bat-Build
2. kc.bat start-dev
Version 18 und niedriger
Version 19 und höher
Bereich hinzufügen:
Melden Sie sich nun bei der Keycloak-Verwaltungskonsole an und navigieren Sie zu Ihrem gewünschten Realm. Sie können einen neuen Realm hinzufügen, indem Sie
Bereich hinzufügen .
Bereich erstellen:
Enter Bereichsname und halten Sie den Realm-Namen bereit, da er später für die Konfiguration des Realms unter dem OAuth-Client-Plugin benötigt wird. Klicken Sie auf CREATE Bereich hinzufügen.
OpenID-Client erstellen:
Klicken Sie auf
Kunden und wählen Sie erstellen , um einen neuen Client zu erstellen. Geben Sie Kunden-ID und wählen Sie das Client-Protokoll openeid-connect und wählen Sie
GespeichertBehalten Sie diesen Wert griffbereit, da er in weiteren Schritten verwendet wird.
Zugriffstyp ändern:
Nachdem der Client erstellt wurde, ändern Sie seinen Zugriffstyp in
vertraulich.
Geben Sie gültige Weiterleitungs-URIs ein:
Fügen Sie die kopierte Rückruf-URL ein von
Schritt 1 und dann auf klicken SPAREN.
Client-Geheimnis abrufen:
Jetzt müssen wir das Kundengeheimnis erfahren. Also auswählen
Kunden und wählen Sie Anmeldeinformationen und kopieren Sie Ihr Geheimnis von hier. Behalten Sie die Kundengeheimnis Wert griffbereit, da dieser im nächsten Schritt verwendet wird.
Benutzer hinzufügen:
Wir müssen dem Realm Benutzer hinzufügen, die auf die Ressourcen des Realms zugreifen können. Klick auf das Nutzer und wählen Sie zu
Fügen Sie einen neuen Benutzer hinzu.
Benutzer Konfiguration:
Nachdem der Benutzer erstellt wurde, muss die folgende Aktion für ihn ausgeführt werden.
1) Legen Sie ein Passwort dafür fest, klicken Sie also auf
Aus- und Fortbildungen und legen Sie ein neues Passwort für den Benutzer fest.
HINWEIS: Wenn Sie „Temporär“ deaktivieren, wird das Benutzerkennwort dauerhaft.
Kartenbenutzer:
Wir müssen den Benutzer einer Rolle zuordnen. Klicke auf
Rollenzuordnungen Weisen Sie dem Benutzer die gewünschte Rolle aus den verfügbaren Rollen zu und klicken Sie auf Auswahl hinzufügen.
ROLLE erstellen:
Die Rolle wird von Ihren Anwendungen verwendet, um zu definieren, welche Benutzer zum Zugriff auf die Anwendung berechtigt sind. Klick auf das
Rollen und wählen Sie Hinzufügen Rollen.
Schritt 1.1: Schritte zum Abrufen von Keycloak-Gruppen [Premium]
Gruppen erstellen: Klicken Sie auf
Groups und wählen Sie New um eine neue Gruppe zu erstellen.
Benutzer einer Gruppe zuweisen: Wählen Sie den Benutzer aus, den Sie zur Gruppe hinzufügen möchten. Wählen Sie auf der Registerkarte die Option „Gruppen“, wählen Sie dann den Gruppennamen aus und klicken Sie auf join.
Keycloak-Gruppen-Mapper: Um nun Gruppendetails abzurufen, müssen wir die Clientzuordnung mit der Gruppenmitgliedschaft durchführen, sonst werden die Gruppendetails nicht abgerufen. Also in Kundenbereich, wählen Sie Ihren Kunden aus und klicken Sie dann auf
Mapper->Erstellen.
Nun wähle Mapper-Typ as Gruppenmitgliedschaft und geben Sie die Name und Name des Tokenanspruchs d. h. der Attributname, dem die Gruppen zugeordnet sind. Deaktivieren Sie den vollständigen Gruppenpfad, die Optionen Zum ID-Token hinzufügen und Zum Zugriffstoken hinzufügen und klicken Sie auf
Gespeichert.
Hinweis: – Wenn der vollständige Pfad angegeben ist, wird der Gruppenpfad abgerufen, andernfalls wird der Gruppenname abgerufen.
Schritt 1.2: Schritte zum Abrufen von Keycloak-Rollen [Premium]
Keycloak-Rollenzuordnung: Um nun die Rollendetails für ein erfolgreiches Keycloak Single Sign-On (SSO) zu erhalten, müssen wir die Clientzuordnung mit der Rollenmitgliedschaft durchführen, sonst werden die Rollendetails nicht abgerufen. Also in Kundenbereich, wählen Sie Ihren Kunden aus und klicken Sie dann auf
Mapper->Erstellen.
Nun wähle Mapper-Typ as Benutzerbereichsrolle Mitgliedschaft und geben Sie die Name. und Name des Token-Anspruchs d.h. der Attributname, der den Gruppen entspricht, die abgerufen werden. Wählen Sie die Optionen Zum ID-Token hinzufügen und Zum Zugriffstoken hinzufügen aus und klicken Sie auf Gespeichert.
Bereich hinzufügen:
Melden Sie sich nun bei der Keycloak-Verwaltungskonsole an und navigieren Sie zu Ihrem gewünschten Realm. Sie können einen neuen Realm hinzufügen, indem Sie
Reich erstellen .
Bereich erstellen:
Enter Bereichsname und halten Sie den Realm-Namen bereit, da er später für die Konfiguration des Realms unter dem OAuth-Client-Plugin benötigt wird. Klicken Sie auf CREATE Bereich hinzufügen.
OpenID-Client erstellen:
Klicken Sie auf Kunden und wählen Sie
Client erstellen um einen neuen Kunden zu erstellen. Eingeben
Kunden-ID und wählen Sie das Client-Protokoll aus
openid-connect und klicken auf NächsterBewahren Sie diesen Wert griffbereit auf, da er in weiteren Schritten verwendet wird.
Aktivieren Sie die Client-Authentifizierung kombiniert mit einem nachhaltigen Materialprofil.
Genehmigung Umschalten.
Scrollen Sie nach unten zum Zugriffseinstellungen und fügen Sie die kopierte Rückruf-/Umleitungs-URL ein von
Schritt 1.
Gehen Sie zum Aus- und Fortbildungen Registerkarte, kopieren Sie die Kundengeheimnis und halten Sie es griffbereit, da wir es später beim Konfigurieren der Shopify Single Sign-On-Anwendung benötigen.
Benutzer hinzufügen:
Wir müssen Benutzer zum Realm hinzufügen, die auf die Ressourcen des Realms zugreifen können. Klicken Sie auf das Nutzer und klicken Sie auf
Neuen Benutzer erstellen um einen neuen Benutzer hinzuzufügen.
Benutzer Konfiguration:
Nachdem der Benutzer erstellt wurde, muss die folgende Aktion für ihn ausgeführt werden.
1) Legen Sie ein Passwort dafür fest, klicken Sie also auf
Aus- und Fortbildungen und legen Sie ein neues Passwort für den Benutzer fest.
HINWEIS: Wenn Sie „Temporär“ deaktivieren, wird das Benutzerkennwort dauerhaft.
Kartenbenutzer:
Wir müssen den Benutzer einer Rolle zuordnen. Klicke auf
Rollenzuordnungen und weisen Sie dem Benutzer aus den verfügbaren Rollen die gewünschte Rolle zu.
ROLLE erstellen:
Die Rolle wird von Ihren Anwendungen verwendet, um zu definieren, welche Benutzer auf die Anwendung zugreifen dürfen. Klicken Sie auf das
Rollen und wählen Sie Rolle erstellen.
Abschließend: Sie haben erfolgreich konfiguriert
Keycloak als OAuth-Anbieter, zum Erreichen SSO bei Shopify zur Benutzerauthentifizierung.
Schritt 3: Umfang und Endpunkte
Informationen zur Konfiguration finden Sie in der folgenden Tabelle
Umfang und Endpunkte für Keycloak Version 18 und höher im Plugin.
Abschließend haben Sie konfiguriert Shopify als Dienstleister, zum Erreichen SSO bei Shopify mit Keycloak als IDP zur Benutzerauthentifizierung.
Schritt 5: Verbindung testen
Nach dem Speichern der IDP-Konfiguration werden Sie weitergeleitet zum
Verbindung testen Schritt. Bitte führen Sie eine Testverbindung durch, bevor Sie Attribute zuordnen oder abrufen. Durch die Testverbindung wird sichergestellt, dass Ihre IDP-Konfiguration korrekt ist.
Klicken Sie auf Verbindung testen .
Wenn Sie gültige IDP-Anmeldeinformationen eingeben, wird ein Popup-Fenster angezeigt, das im folgenden Bildschirm dargestellt ist.
Klicken Sie auf Attribute abrufen Schaltfläche, um das IDP-Attribut abzurufen.
Schritt 6: Attributzuordnung
Klicken Sie auf + Attributzuordnung Schaltfläche, um Attribute zwischen Shopify und Ihrem IDP zuzuordnen.
Ordnen Sie die Attribute anhand der folgenden Tabelle zu:
Attributname in Shopify
Wählen Sie den Shopify-Kundenattributschlüssel aus, in den Sie eingehende Attributwerte von IDP synchronisieren möchten
Attributtyp
IDP-Attribut
Attributwert
Wählen Sie den Attributschlüssel aus, den Sie von Ihrem IDP abgerufen haben und in Shopify synchronisieren möchten
Klicken Sie auf Weiter.
Schritt 7: SSO-Konfigurationen aktivieren und testen
Wählen Sie den Shopify-Shop-Typ:
Non-Plus-Store
Plus Shop
SSO-Konfiguration in Nicht-Plus-Shopify-Shops
Wählen Sie den Kontotyp aus, den Sie in Ihrem Shopify Store aktiviert haben:
Kundenkonten
Legacy-Kundenkonten
Hinweis: Wenn Sie verwenden ein
passwortgeschützter Shop oder arbeiten an einem
Shopify-Entwicklungsshop, klicken
.
Um den Storefront-Digest-Cookie so einzurichten, dass SSO in Ihrem Shop funktioniert.
Gehen Sie zum Anwendungs-Dashboard, aktivieren Sie die
Kundenkontenerweiterung wie in der untenstehenden Abbildung dargestellt.
Aktivieren Sie die Neue Kundenkonten Erweiterung und klicken Sie auf Gespeichert.
Navigieren Sie zur Startseite der Anwendung und aktivieren Sie die
Umschaltoption für die IDP-Anmeldung gegen den von Ihnen konfigurierten Identitätsanbieter.
Nur SSO-Benutzern den Checkout erlauben – Andere einschränken
Diese Funktion ermöglicht es nur Nutzern, die sich per Single Sign-On (SSO) anmelden, den Bestellvorgang abzuschließen. Andere Nutzer können den Bestellvorgang nicht fortsetzen.
Navigieren Einstellungen .
Öffnen Sie den Microsoft Store auf Ihrem Windows-PC. Zur Kasse .
Scrollen Sie nach unten, in der
Checkout-Regeln Abschnitt, klicken Sie auf
Regel hinzufügen.
Klicken Sie auf SSO-Checkout-Validierung.
Deaktivieren Sie die Option
„Allen Kunden den Abschluss des Bestellvorgangs ermöglichen“
Option und klicken Sie auf Gespeichert.
Jetzt kannst du Einschalten die Checkout-Regel.
Wenn Sie versuchen, ohne SSO zur Kasse zu gehen, wird eine Fehlermeldung wie unten dargestellt angezeigt.
Testen von Single Sign-On (SSO) für Ihren Shopify-Shop
Gehen Sie zu Ihrem Shopify Store. (https:// )
Klicken Sie auf Benutzer-Login-Symbol.
Sie werden zur Anmeldeseite des Identitätsanbieters (IDP) weitergeleitet, den Sie im vorherigen Schritt konfiguriert haben. Melden Sie sich mit den Anmeldeinformationen Ihres IDP-Kontos an.
Geben Sie anschließend das sechsstellige OTP ein, das an Ihre registrierte E-Mail-Adresse gesendet wird. (Dies ist ein einmaliger Vorgang.)
Sie werden erfolgreich in Ihrem Shopify-Shop angemeldet.
Gehen Sie zum Anwendungs-Dashboard. Auf der Kontoseite wird ein Warnfeld zum Hinzufügen der Login-Button-Erweiterung angezeigt. Klicken Sie auf
Login-Widget-Erweiterung Um die Funktion zu aktivieren, folgen Sie dem Link in der untenstehenden Abbildung.
Navigieren Sie zur Startseite der Anwendung und aktivieren Sie die
Umschaltoption für die IDP-Anmeldung gegen den von Ihnen konfigurierten Identitätsanbieter.
Wenn Sie konfigurieren möchten
SSO bei Shopify mit mehreren IDPsWählen Sie anschließend Ihren Identitätsanbieter aus der bereitgestellten Liste aus.
., und richten Sie SSO mit diesem IDP ein.
Aktivieren Sie die IDP-Anmelde-Umschaltoption zur Aktivierung von SSO bei Shopify unter Verwendung mehrerer Identitätsanbieter.
Testen von Single Sign-On (SSO) für Ihren Shopify-Shop
Gehen Sie zur Anmeldeseite Ihres Shopify Stores. (https:// /Konto/Anmeldung)
Klicken Sie auf Login-Button Sie haben die Einstellungen zuvor vorgenommen.
Sie werden zur Anmeldeseite des Identitätsanbieters (IDP) weitergeleitet. Melden Sie sich nun mit Ihren bestehenden Kontoanmeldeinformationen an.
Wenn nach der Anmeldung die Fehlermeldung „Ungültiges oder fehlendes reCAPTCHA-Token“ zusammen mit der Meldung „Etwas ist schiefgelaufen“ auftritt, lesen Sie bitte diesen Artikel.
FAQ
um den Fehler zu beheben.
SSO-Konfiguration in Plus Shopify Stores
Wählen Sie den Kontotyp aus, den Sie in Ihrem Shopify Store aktiviert haben:
Kundenkonten
Legacy-Kundenkonten
Navigieren Sie zurück zur SSO-Anwendung und klicken Sie auf die
Shop verbinden Tab.
Kopieren Sie die Discovery-Endpunkt-URLClient-ID, Client-Geheimnis, zusätzliche Bereiche
kombiniert mit einem nachhaltigen Materialprofil. URI-Parameter für die Umleitung nach dem Abmelden und halten Sie sie griffbereit.
Klicken Sie auf Kundenkonten Link wie im untenstehenden Bild dargestellt.
Wähle aus Kundenkonten Die von Shopify empfohlene Option. Suchen Sie anschließend nach der
Authentifizierung Option und klicken Sie auf
Verwalten.
Falls Sie diese Option nicht finden, wenden Sie sich bitte an
shopifysupport@xecurify.com
falls Sie Unterstützung benötigen.
Klicken Sie auf Anbieter verwalten .
Klicken Sie auf Mit Anbieter verbinden .
Fügen Sie den Namen des Identitätsanbieters hinzu und aus dem
Provider Dropdown, wählen Sie
Kundenspezifisch oder andere.
Füllen Sie die Details aus, wie zum Beispiel
URL des Discovery-Endpunkts, Client-ID, Client-Geheimnis, zusätzliche Bereiche, URI-Parameter für die Umleitung nach der Abmeldung
den du kopiert hast
oben Schritt. Klicken Sie auf Gespeichert.
Sobald der Identitätsanbieter hinzugefügt wurde, führen Sie die folgenden Schritte aus
Verbindung testen.
Nach der Überprüfung des Flusses machen Sie den Identitätsanbieter zu
Aktives.
Navigieren Sie zur Startseite der Anwendung und aktivieren Sie die
Umschaltoption für die IDP-Anmeldung gegen den von Ihnen konfigurierten Identitätsanbieter.
Testen von Single Sign-On (SSO) für Ihren Shopify-Shop
Gehen Sie zu Ihrem Shopify Store. (https:// )
Klicken Sie auf Benutzer-Login-Symbol.
Sie werden zur Anmeldeseite des Identitätsanbieters (IDP) weitergeleitet, den Sie im vorherigen Schritt konfiguriert haben. Melden Sie sich mit den Anmeldeinformationen Ihres IDP-Kontos an.
Sie werden erfolgreich in Ihrem Shopify-Shop angemeldet.
Melden Sie sich mit Benutzername und Passwort an
Wenn Sie für Ihren B2B-Shop zusätzlich zu Ihrer IDP-Login-Option auch die Anmeldung mit Benutzername und Passwort anbieten möchten, dann
bitte hier klicken
Geben Sie die Anmeldung per E-Mail-OTP an
Wenn Sie die Anmeldung per E-Mail-OTP zusammen mit Ihrer Anmeldung mit IDP-Option für Ihren B2B-Shop anbieten möchten, dann
bitte hier klicken
Klicken Sie nun auf Einrichtungsanleitung Klicken Sie auf die Schaltfläche und folgen Sie den angegebenen Schritten, um ein Multipass-Token zu erhalten.
Aktivieren Sie die Multipass-Token Option. Siehe hier.
Faq
um den Multipass-Token-Wert zu erhalten und ihn in das unten stehende Feld einzufügen.
Klicken Sie auf Gespeichert.
Gehen Sie zum Anwendungs-Dashboard. Auf der Kontoseite wird ein Warnfeld zum Hinzufügen der Login-Button-Erweiterung angezeigt. Klicken Sie auf
Login-Widget-Erweiterung Um die Funktion zu aktivieren, folgen Sie dem Link in der untenstehenden Abbildung.
Navigieren Sie zur Startseite der Anwendung und aktivieren Sie die
Umschaltoption für die IDP-Anmeldung gegen den von Ihnen konfigurierten Identitätsanbieter.
Wenn Sie konfigurieren möchten
SSO bei Shopify mit mehreren IDPsWählen Sie anschließend Ihren Identitätsanbieter aus der bereitgestellten Liste aus.
., und richten Sie SSO mit diesem IDP ein.
Aktivieren Sie die IDP-Anmelde-Umschaltoption zur Aktivierung von SSO bei Shopify unter Verwendung mehrerer Identitätsanbieter.
Testen von Single Sign-On (SSO) für Ihren Shopify-Shop
Gehen Sie zur Anmeldeseite Ihres Shopify Stores. (https:// /Konto/Anmeldung)
Klicken Sie auf Login-Button Sie haben die Einstellungen zuvor vorgenommen.
Sie werden zur Anmeldeseite des Identitätsanbieters (IDP) weitergeleitet. Melden Sie sich nun mit Ihren bestehenden Kontoanmeldeinformationen an.
Wenn Sie auf die Fehlermeldung „Ungültiges oder fehlendes reCAPTCHA-Token“ stoßen, die von der Meldung „Etwas ist schiefgelaufen“ begleitet wird, lesen Sie bitte diesen Artikel.
FAQ
um den Fehler zu beheben.
Sie werden erfolgreich in Ihrem Shopify-Shop angemeldet.
Ich habe die Schritte zum Einrichten von IDP befolgt, aber wo kann ich SSO überprüfen?
Befolgen Sie die beschriebenen Schritte
.
um SSO in Shopify mit Ihrem bevorzugten IDP zu konfigurieren.
Ich habe die Shopify SSO-Anwendung installiert. Ich habe auf die Option „IDP EINRICHTEN“ geklickt, aber es öffnete sich nichts.
Die Weiterleitung zu einer anderen Website ist möglicherweise im Browser blockiert. Bitte befolgen Sie die angegebenen Schritte
.
um das Problem zu lösen.
Nach der Durchführung des SSO möchte ich, dass meine Kunden auf die Seite mit den Sammlungen oder Rabattangeboten weitergeleitet werden.
Befolgen Sie die beschriebenen Schritte
.
um Ihren Kunden zu Sammlungen/Warenkorb oder einer anderen Seite weiterzuleiten.
Wie aktiviere ich die automatische Weiterleitung der SSO-Anwendung zur IDP-Funktion in meinem Shopify-Shop?
Sie müssen auf den Enterprise-Plan der SSO-Anwendung upgraden, um die Funktion „Automatische Umleitung zum IDP“ zu aktivieren. Folgen Sie den beschriebenen Schritten
.
, um diese Funktion zu aktivieren.
Bitte erreichen Sie uns unter
shopifysupport@xecurify.com, und unser Team unterstützt Sie bei der Einrichtung der Shopify SSO-Anwendung. Unser Team hilft Ihnen, die am besten geeignete Lösung/den am besten geeigneten Plan entsprechend Ihren Anforderungen auszuwählen.
×
Hallo!
Brauchen Sie Hilfe? Wir sind hier!
Kontaktieren Sie den miniOrange-Support
Vielen Dank für Ihre Anfrage.
Wenn Sie innerhalb von 24 Stunden nichts von uns hören, können Sie gerne eine Folge-E-Mail an senden info@xecurify.com