Wie richte ich Single Sign-On (SSO) in Shopify mit Keycloak als IDP (SAML) ein?
miniOrange ermöglicht es Keycloak (SAML), als Identitätsanbieter (IdP) zu fungieren und Nutzern so ein nahtloses Login mit Single Sign-On (SSO) und Keycloak-Zugangsdaten bei Shopify zu ermöglichen . Sie können Ihren eigenen Identitätsanbieter mit Kundenkonten verbinden und so eine reibungslose und zuverlässige Integration gewährleisten. miniOrange funktioniert sowohl mit Shopify-Kundenkonten als auch mit älteren Systemen, unterstützt Shopify Plus- und Nicht-Plus-Shops und ist speziell auf B2B-Shops mit Shopify B2B-Login- Anforderungen zugeschnitten. Unsere Anwendung ist mit allen SAML-, OAuth- und OpenID-Identitätsanbietern (IdPs) kompatibel.
Nachfolgend finden Sie eine Schritt-für-Schritt-Anleitung zur Konfiguration von Single Sign-On (SSO) bei Shopify mit Keycloak als Identitätsanbieter (IdP) und Ihrem Shopify-Shop als Dienstanbieter (SP). Die Anleitung behandelt die Einrichtung für Kunden- und Legacy-Konten sowie für Shopify Plus- und Nicht-Plus-Konten.
Konfigurieren Sie [OAuth] SSO in Shopify mit Keycloak als IdP
Um Single Sign-On (SSO) mit Shopify über das OAuth-Protokoll unter Verwendung von Keycloak als Identitätsanbieter (IdP) einzurichten, folgen Sie den hier beschriebenen Schritten.
Voraussetzungen: App-Installation
- Einloggen, um Shopify-Administrator.
- Zurück Nach Apps → Laden Sie den App Store herunter
- Suchen Sie nach miniOrange Single Sign-On – SSO
- Klicken Sie auf Installieren um die App zu Ihrem Store hinzuzufügen
- Öffnen Sie die App von Apps Keycloak SSO in der Shopify-Konfiguration starten
Schritt-für-Schritt-Anleitung zur Konfiguration von Keycloak als Identitätsanbieter (OAuth) für SSO bei Shopify
Schritt 1: Shopify als SP in Keycloak konfigurieren
- Melden Sie sich beim Keycloak Admin-Panel an.
- Klicken Sie auf Kunden aus dem linken Menü und klicken Sie dann auf Erschaffung Klicken Sie auf die Schaltfläche, um einen neuen Client/eine neue Anwendung zu erstellen.
- Für die oben genannten SAML-Konfiguration, du musst das bekommen Entitäts-ID und ACS-URL von Shopify.
- Jetzt geh zu deinem Shopify-Shop, navigiere zum App Abschnitt und klicken Sie auf Single Sign On – SSO-Anmeldung Anwendung.
- Klicken Sie auf Identitätsanbieter hinzufügen Klicken Sie auf die Schaltfläche, um Ihren IDP hinzuzufügen.
- Auswählen SAML Protokoll.
- Jetzt wählen Schlüsselumhang aus der Liste der Binnenvertriebenen.
- Klicken Sie auf Metadaten abrufen Drücken Sie die unten abgebildete Schaltfläche, um die Metadaten des Dienstanbieters abzurufen.
- Navigieren Sie zu der SP-initiierte Metadaten Abschnitt und kopieren Sie ihn nach unten ACS-URL und Entitäts-ID oder Aussteller.
- Geben Sie die von Shopify bereitgestellten Werte wie folgt ein:
| Kunden-ID | Entitäts-ID/Aussteller |
| Client-SAML-Endpunkt | ACS-URL |
- Geben Sie die von Shopify bereitgestellten Werte wie folgt ein:
- Geben Sie hier die Konfigurationswerte von Shopify an:
| Name | Geben Sie den Namen Ihrer Wahl an |
| Client-Protokoll | SAML |
| Unterschreiben Sie die Behauptung | On |
| Behauptung verschlüsseln | Off |
| Unterschrift des Kunden erforderlich | Off |
| Namens-ID-Format | Benutzername |
| Gültige Weiterleitungs-URIs | ACS-URL |
- Jetzt in Feinkörnige SAML-Endpunktkonfiguration Geben Sie die Werte wie folgt ein.
| Assertion Consumer Service POST-Bindungs-URL | ACS-URL |
| URL der Abmeldedienst-Umleitungsbindung | Single-Sign-Out-URL |
- Klicken Sie auf Gespeichert .
- Für IDP-Metadaten gehen Sie zu Realms im linken Bereich und klicken Sie auf Metadaten des SAML 2.0-Identitätsanbieters.
Sie haben die Keycloak-seitige Konfiguration abgeschlossen.
Schritt 2: Keycloak als IDP in Shopify konfigurieren
- Navigieren Sie zurück zu miniOrange Single Sign On-SSO Anwendung und klicken Sie auf die Identitätsanbieter hinzufügen .
- Auswählen SAML Protokoll.
- Wählen Sie aus der Liste der IDPs aus Schlüsselmantel.
- Klicken Sie auf IDP-Metadaten importieren .
- Wählen Sie die Upload-Methode als Metadaten-LinkFügen Sie den kopierten Link zur XML-Datei ein. Schritt 1: und klicken Sie auf Import.
- Fügen Sie den entsprechenden IDP-Namen hinzu und klicken Sie auf Speichern.
Sie haben die Shopify-Seitenkonfiguration abgeschlossen.
Schritt 3: Verbindungen testen
-
Nach dem Speichern der IDP-Konfiguration werden Sie weitergeleitet zum
Verbindung testen Schritt.
Führen Sie vor dem Zuordnen oder Abrufen von Attributen einen Verbindungstest durch. Durch den Verbindungstest wird sichergestellt, dass Ihre IDP-Konfiguration korrekt ist. - Klicken Sie auf Verbindung testen .
- Nach Eingabe gültiger Keycloak-Zugangsdaten erscheint ein Popup-Fenster, das im folgenden Screenshot dargestellt ist.
- Klicken Sie auf Attribute abrufen Schaltfläche, um das IDP-Attribut abzurufen.
Schritt 4: Attributzuordnung
- Klicken Sie auf + Attributzuordnung Schaltfläche zum Zuordnen von Attributen zwischen Shopify und Keycloak.
- Ordnen Sie die Attribute anhand der folgenden Tabelle zu:
| Attributname in Shopify | Wählen Sie das Attribut aus der Liste der vordefinierten Attribute aus |
| Attributtyp | IDP-Attribut |
| Attributwert | Wählen Sie den Attributwert aus, den Sie von Ihrem IDP abgerufen haben |
- Klicken Sie auf Speichern.
Schritt 5: SSO-Konfigurationen aktivieren und testen
Wählen Sie den Shopify-Shop-Typ:
- Non-Plus-Store
- Plus Shop
Sie haben Keycloak SSO erfolgreich für Ihren Shopify-Shop eingerichtet . Keycloak fungiert dabei als Identitätsanbieter (IdP) und Ihr Shopify-Shop als Dienstanbieter (SP). Diese Konfiguration ermöglicht es Nutzern, sich mit ihren Keycloak-Zugangsdaten in Ihrem Shopify-Shop anzumelden. Dadurch wird der Anmeldevorgang vereinfacht und die Sicherheit durch die Reduzierung von Passwortmüdigkeit erhöht.
Unterstützte Integrationen und Funktionen
Weitere Funktionen ➔Problemlösung
Ich habe die Schritte zur Konfiguration von Shopify SSO mit Keycloak als IDP befolgt. Wo kann ich die SSO-Einstellungen überprüfen?
Gehen Sie zu Ihrem Shopify-Shop und prüfen Sie, ob der Button „Konto/Anmelden“ in der Navigationsleiste sichtbar ist. Falls ja, fahren Sie mit „Zu Ihrem Shopify-Shop“ fort. Falls nein, gehen Sie in Ihr Shopify-Admin-Panel, navigieren Sie zu Einstellungen und wählen Sie „Kundenkonten“. Aktivieren Sie die Option „Anmeldelink im Header des Onlineshops und im Checkout anzeigen“.
Für ältere Shopify-Kundenkonten
Sie sollten nun oben im Shop den Link „Konto/Anmelden“ sehen. Klicken Sie darauf. Wählen Sie das Keycloak SSO-Anmelde-Widget über den Feldern für E-Mail und Passwort aus. Geben Sie Ihre Keycloak-Zugangsdaten ein, um sich in Ihrem Shopify-Shop anzumelden.
Für Shopify-Kundenkonten
Klicken Sie oben rechts in Ihrem Shopify-Shop auf das Benutzersymbol. Sie werden zur Keycloak-Anmeldeseite weitergeleitet. Melden Sie sich mit Ihrem Keycloak-Konto an und bestätigen Sie die 6-stellige Einmalpasswort-Authentifizierung. Anschließend sind Sie in Ihrem Shopify-Shop angemeldet.
Eine detaillierte Anleitung finden Sie hier.
Wie kann ich Kunden nach dem Einloggen über Keycloak SSO auf eine bestimmte Seite, z. B. zu den Shopify-Kollektionen, weiterleiten?
Nachdem Sie Keycloak SSO für Shopify konfiguriert haben, können Sie Kunden nach dem Login ganz einfach auf eine bestimmte Seite in Ihrem Shop weiterleiten. Öffnen Sie dazu die Shopify Single Sign-On (SSO)-Anwendung und klicken Sie auf „Weitere Aktionen“. Wählen Sie anschließend „Zusätzliche Einstellungen“ für die von Ihnen eingerichtete Keycloak-Verbindung. Geben Sie im Tab „Konfigurationen nach dem Login“ den gewünschten Weiterleitungsendpunkt ein (z. B. /cart oder /collections). Achten Sie darauf, nur den Pfad und nicht die vollständige URL anzugeben. Bei Bedarf können Sie die Option zur Einschränkung der Benutzerregistrierung aktivieren und Ihre Einstellungen speichern. Eine detaillierte Anleitung finden Sie in diesem Leitfaden.
Wie kann ich die automatische Weiterleitung zu Keycloak für die Shopify SSO-Anwendung aktivieren?
Um die automatische Weiterleitung zu Keycloak für Ihren Shopify-Shop zu aktivieren, müssen Sie die miniOrange Single Sign-On (SSO)-Anwendung auf den Enterprise-Plan aktualisieren. Gehen Sie zu „Apps“ und wählen Sie dann „miniOrange Single Sign-On, SSO“ aus. Klicken Sie im Bereich „Preise“ unter „Scale Plan“ auf „Upgrade“. B2B-Nutzer aktivieren die Option auf der Registerkarte „Mitarbeiter“. Navigieren Sie nach dem Upgrade zur Registerkarte „Globale Konfigurationen“ und aktivieren Sie unter „Shop-Zugriffseinstellungen“ die Option „Automatische Weiterleitung zu Keycloak“. Falls eine Warnung angezeigt wird, klicken Sie auf den bereitgestellten Link, um die Keycloak-Erweiterung für die automatische Weiterleitung zu aktivieren. Speichern Sie anschließend Ihre Einstellungen. Legen Sie abschließend fest, ob die Funktion für den gesamten Shop oder nur für die Anmeldeseite gelten soll, und klicken Sie dann auf „Speichern“.
Häufig gestellte Fragen (FAQs)
Weitere FAQs ➔
Kann ich die Keycloak-Benutzerdaten mit meinen Shopify-Kundendaten synchronisieren, wenn sich die Kunden zum ersten Mal anmelden?
Ja, Sie können Keycloak-Benutzerdaten beim erstmaligen Anmelden mit Shopify-Kundenprofilen über die miniOrange SSO-Anwendung synchronisieren.
So synchronisieren Sie Keycloak-Benutzerdetails über die SSO-App mit Shopify:
- Richten Sie Keycloak als Identitätsanbieter ein: Wählen Sie in der SSO-Anwendung das SAML-Protokoll aus und konfigurieren Sie Keycloak als IdP mit seinen Metadaten.
- Konfigurieren Sie die Attributzuordnung: Ordnen Sie Keycloak-Attribute wie E-Mail-Adresse, Name, Telefonnummer usw. den entsprechenden Shopify-Kundenfeldern zu.
- Aktivieren Sie Profilaktualisierungen bei SSO: Aktivieren Sie unter „Konfigurationen nach dem Login“ die Option, das Kundenprofil nach der SSO-Anmeldung eines Benutzers zu aktualisieren.
Dadurch wird sichergestellt, dass Kundendaten von Keycloak problemlos mit Shopify synchronisiert werden.
Wie kann ich alle Anmeldeversuche in meinem Shopify-Shop direkt zur Authentifizierung an Keycloak umleiten?
Sie können alle Anmeldeversuche an Keycloak umleiten, indem Sie die Funktion „Automatische Umleitung an IdP“ in der miniOrange SSO-App verwenden.
So konfigurieren Sie es:
- Richten Sie Keycloak als Identitätsanbieter ein: Konfigurieren Sie in der miniOrange SSO-Anwendung Keycloak als Identitätsanbieter (IdP) mithilfe seiner SAML-Metadaten oder OAuth-Endpunkte.
- Aktivieren Sie die automatische Weiterleitung zum IdP: Navigieren Sie zu den globalen Einstellungen und aktivieren Sie die Funktion „Automatische Weiterleitung an IDP“ unter „Zugriffseinstellungen für den Shop“. Wählen Sie aus, ob diese Funktion für den gesamten Shop oder nur für die Anmeldeseite aktiviert werden soll.
Dies gewährleistet ein reibungsloses Anmeldeerlebnis, bei dem alle Anmeldeversuche in Ihrem Shopify-Shop zu Keycloak umgeleitet werden.
Ist es möglich, Benutzer nach dem SSO-Login über Keycloak auf bestimmte Seiten oder Bereiche meines Shopify-Shops weiterzuleiten?
Ja, es ist möglich, Benutzer nach der SSO-Anmeldung über Keycloak auf bestimmte Seiten oder Abschnitte meines Shopify-Shops weiterzuleiten.
Hier erfahren Sie, wie Sie die Weiterleitung von Benutzern auf bestimmte Seiten über die SSO-App konfigurieren:
- Konfigurieren Sie Keycloak als Identitätsanbieter: Wählen Sie in der SSO-Anwendung das gewünschte SSO-Protokoll aus und konfigurieren Sie Keycloak als IdP mit seinen Metadaten.
- Konfigurieren Sie Shopify als Dienstanbieter: Richten Sie Shopify als Service Provider (SP) ein und importieren Sie die Keycloak IdP-Metadaten. Aktivieren Sie die SSO-Anmeldung für Kunden, damit diese sich mit ihren Keycloak-Zugangsdaten anmelden können.
- Benutzerdefinierte Weiterleitung: Unter „Konfigurationen nach dem Login“ geben Sie den Endpunkt ein, zu dem Benutzer nach dem Login weitergeleitet werden sollen. Zum Beispiel: /cart, /account
Kann ich Keycloak verwenden, damit sich Mitarbeiter mit denselben Anmeldedaten in mehrere Shopify-Shops einloggen können?
Ja, Sie können Keycloak als Identitätsanbieter (IdP) verwenden, um Single Sign-On (SSO) für mehrere Shopify-Shops zu ermöglichen.
Hier erfahren Sie, wie Sie SSO konfigurieren, damit sich Mitarbeiter in mehreren Shopify-Shops anmelden können:
- Installieren Sie die Shopify SSO-Anwendung: Installieren Sie auf jedem Shopify-Shop die Shopify SSO-Anwendung aus dem App Store.
- Konfigurieren Sie Keycloak als IdP: Erstellen Sie in Keycloak für jeden Shopify-Shop einen Client mit entweder dem SAML- oder dem OIDC-Protokoll.
- Konfigurieren Sie die SSO-App in Shopify: Geben Sie die Keycloak IdP-Details (SAML-Metadaten oder OIDC-Endpunkte) in der SSO-Anwendung jedes Shops ein.
- Verwenden Sie denselben Realm und Benutzerspeicher in Keycloak: Gewährleistet, dass alle Mitarbeiter in allen Filialen die gleichen Zugangsdaten verwenden.
Diese Konfiguration gewährleistet, dass Mitarbeiter mit einem einzigen Satz Keycloak-Zugangsdaten nahtlos auf mehrere Shopify-Shops zugreifen können, was sowohl die Sicherheit als auch den Benutzerkomfort verbessert.
Danke für Ihre Antwort. Wir werden uns bald bei Ihnen melden.
Etwas ist schief gelaufen. Bitte senden Sie Ihre Anfrage erneut
