• Startseite
• App-Integrationen
• Bigcommerce B2B Single Sign-On (SSO)

Bigcommerce B2B Single Sign-On (SSO)

---

Diese Anleitung enthält Schritt-für-Schritt-Anweisungen zur Konfiguration von Single Sign-On (SSO) zwischen miniOrange und BigCommerce B2B Edition. Diese Integration ermöglicht eine nahtlose Authentifizierung, sodass Benutzer mit ihren miniOrange-Anmeldeinformationen auf Ihren BigCommerce B2B-Shop zugreifen können, ohne separate Anmeldeinformationen zu benötigen.

Lösungsüberblick:

• Aktiviert SSO für Benutzer der BigCommerce B2B-Storefront.
• Stellt automatisch Kundenkonten in BigCommerce bereit.
• Synchronisiert Benutzerattribute zwischen BigCommerce und miniOrange oder einem beliebigen externen Identitätsanbieter (IdP).
• Erstellt und verwaltet B2B-Unternehmen und Benutzerrollen.

Voraussetzungen für Bigcommerce SSO

Bevor Sie mit der Einrichtung beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

• BigCommerce-Shop: Ein aktiver BigCommerce-Shop mit aktivierter B2B-Edition.
• Administratorzugriff: Berechtigungen als Shop-Eigentümer oder Administrator in BigCommerce.
• miniOrange-Konto: Aktives miniOrange-Konto.

Folgen Sie der unten stehenden Schritt-für-Schritt-Anleitung für Bigcommerce b2b Single-Sign-on (SSO).

Schritt 1: Erstellen Sie BigCommerce-API-Anmeldeinformationen

1.1 Zugriff auf die API-Kontoeinstellungen

• Melden Sie sich bei der BigCommerce-Administrationsbereich.
• Navigieren Einstellungen aus dem Hauptmenü.
• Scrollen Sie nach unten und wählen Sie API-Konten.




1.2 Neues API-Konto erstellen

• Klicken Sie auf API-Konto erstellen.
• Auswählen V2/V3-API-Token erstellen Aus dem Dropdown-Menü.
• Geben Sie einen beschreibenden Namen für Ihr API-Konto ein.

1.3 API-Berechtigungen konfigurieren

• Finde dein Hash speichern im Feld API-Pfad, das wie folgt angezeigt wird:

  https://api.bigcommerce.com/stores/{store_hash}/v3/




• Hinweis: Speichere das store_hash Wert - Sie werden ihn später brauchen
• Konfigurieren Sie die folgenden Berechtigungen:
• Kunden: Zum Ändern festlegen
• Kunden-Login: Auf Anmeldung einstellen



• Scrollen Sie nach unten und legen Sie fest B2B-Edition Umfang zu ändern. Klicken Sie auf Gespeichert.




1.4 Client-ID und Client-Geheimnis

• Nach dem Speichern zeigt BigCommerce Ihre Anmeldeinformationen auf dem Bildschirm an und lädt eine .txt Datei mit Ihren Anmeldeinformationen. Speichern Sie die Werte von Kunden-ID, Kundengeheimnis und Zugangstoken.

Schritt 2: Konfigurieren Sie die BigCommerce-Anwendung in miniOrange

2.1 Neue Anwendung hinzufügen

• Melden Sie sich bei der miniOrange Admin-Konsole.
• Zurück Nach Apps und klicken Sie auf Anwendung hinzufügen .



• Wählen Sie unter „Anwendung auswählen“ JWT als App-Typ.



• Suchen Sie im nächsten Schritt in der Liste nach der Anwendung BigCommerceB2B und klicken Sie darauf.




2.2 Grundeinstellungen konfigurieren

• Geben Sie auf der Registerkarte „Basis“ die folgenden Werte ein:

  Feld	Wert	Beschreibung
  Display Name	BigCommerce	Benutzerdefinierter Name für diese Integration
  Weiterleitungs-URL	https://{my-store}.mybigcommerce.com/login/token/	Ersetzen {my-store} mit Ihrer tatsächlichen Shop-URL
  Kunden-ID	[From Step 1.4]	Kopieren Sie die Anmeldeinformationen der BigCommerce-API
  Kundengeheimnis	[From Step 1.4]	Kopieren Sie die Anmeldeinformationen der BigCommerce-API
  Zugriffstoken (B2B)	[From Step 1.4]	Kopieren Sie die Anmeldeinformationen der BigCommerce-API
  Beschreibung	Optional	Kurzbeschreibung dieser Integration

2.3 Erweiterte Einstellungen konfigurieren

• Navigieren Sie zur Registerkarte „Erweitert“ und konfigurieren Sie:

  Rahmen	Wert	Beschreibung
  Signaturalgorithmus	HS256	Erforderlich für die BigCommerce JWT-Authentifizierung
  Logout-URL	https://{my-store}.mybigcommerce.com/login.php?action=logout	Ersetzen {my-store} mit Ihrer Shop-URL





2.3 Konfigurieren der erforderlichen Attributzuordnung

• Navigieren Sie zu der Attribut und konfigurieren Sie Folgendes Pflichtfeld Attribute:

  Attributname	Wert/Zuordnung	Beschreibung
  first_name	Dem Vornamenfeld des Benutzers zuordnen	Vorname des Benutzers
  last_name	Dem Nachnamenfeld des Benutzers zuordnen	Nachname des Benutzers
  email	Dem E-Mail-Feld des Benutzers zuordnen	E-Mail-Adresse des Benutzers (eindeutige Kennung)
  operation	customer_login	Statischer Wert – erforderlich für den SSO-Betrieb
  store_hash	[From Step 1.3]	Ihr Store-Hashwert
  redirect_to	/account.php or /	Umleitungsendpunkt nach der Anmeldung (z. B. /account.php für Kontoseite, / für Homepage)
  companyName	Zuordnen zu einem Firmenfeld oder statischen Wert	Firmenname für B2B-Konto

Anweisungen zur Attributzuordnung:

• Klicken Sie auf Attributzuordnung hinzufügen.
• Geben Sie den Attributnamen genau wie angezeigt ein (Groß-/Kleinschreibung beachten).
• Wählen Sie das entsprechende Benutzerfeld Ihres Identitätsanbieters aus.
• Für statische Werte geben Sie den Wert in Benutzerdefinierter Attributwert wie im Bild gezeigt.
• Klicken Sie auf Gespeichert.




2.4 Optionale Attribute konfigurieren

• Über die erforderlichen Attribute hinaus können Sie zusätzliche optionale Attribute konfigurieren, um die Benutzerbereitstellung und die Unternehmenseinrichtung anzupassen.

Verfügbare optionale Attribute

Attribut	Beschreibung	Akzeptierte Werte	Standardwert
role	Rolle des Benutzers innerhalb des B2B-Unternehmens	admin, senior_buyer, junior_buyer	junior_buyer
phone	Telefonnummer des Unternehmens	Gültige Telefonnummernzeichenfolge	1234567890
country	Hauptgeschäftssitz des Unternehmens	Vollständiger Ländername oder zweistelliger Ländercode (z. B. „Vereinigte Staaten“, „US“, „Kanada“, „CA“)	United States




So fügen Sie optionale Attribute hinzu

• Im Attribut Tab, klicken Sie auf Attributzuordnung hinzufügen.
• Geben Sie den Attributnamen genau wie oben gezeigt ein (Groß-/Kleinschreibung beachten).
• Ordnen Sie es dem entsprechenden Feld Ihres Identitätsanbieters zu oder geben Sie einen statischen Wert ein.
• Klicken Sie auf Gespeichert.




Wichtige Hinweise zu optionalen Attributen

• Ausnahme für den ersten Benutzer: Der erste für ein Unternehmen erstellte Benutzer erhält automatisch die Administratorrolle, unabhängig von der Rollenattributzuordnung. Dadurch wird sichergestellt, dass jedes Unternehmen mindestens einen Administrator hat.
• Telefonformat: Jedes Telefonnummernformat wird akzeptiert.
• Ländernamen: Verwenden Sie die vollständigen Ländernamen, wie sie in BigCommerce angezeigt werden (z. B. „Vereinigte Staaten“, nicht „US“ oder „USA“).
• Angewandte Standardeinstellungen: Wenn optionale Attribute nicht konfiguriert sind, verwendet das System die oben aufgeführten Standardwerte. Die Integration funktioniert auch ohne diese Werte normal.

Schritt 3: Zugriffsrichtlinie konfigurieren

3.1 Zugriffsrichtlinie erstellen

• Navigieren Sie zu der Politik Tab.
• Klicken Sie auf Richtlinie hinzufügen.
• Konfigurieren Sie die Richtlinie, indem Sie die folgenden Werte eingeben:

Feld	Wert	Beschreibung
Gruppenname	Default	Benutzergruppe, für die diese Richtlinie gilt
Versicherungsname	Wählen Sie einen beschreibenden Namen	Beispiel: „BigCommerce SSO-Richtlinie“
Erster Faktor	Password or Password-less	Primäre Authentifizierungsmethode




• Klicken Sie auf Absenden , um die Richtlinienkonfiguration zu speichern.

Schritt 4: SSO-Konfiguration testen

4.1 Wählen Sie Ihre Testmethode

Die Testmethode hängt von der Einrichtung Ihres Identitätsanbieters ab:

Option A: miniOrange als Identitätsanbieter (IdP)

• Navigieren Sie in der miniOrange-Administrationskonsole zu Ihrer BigCommerceB2B-Anwendung
• Kopieren Sie die SSO-URL zur Authentifizierung von miniOrange
• Öffnen Sie diese URL in einem Inkognito-/privaten Browserfenster
• Melden Sie sich mit gültigen miniOrange-Anmeldeinformationen an
• Nach erfolgreicher Überprüfung wird der Benutzer zu Ihrem Bigcommerce-Shop weitergeleitet

Option B: Externer Identitätsanbieter

• Navigieren Sie in der miniOrange-Administrationskonsole zu Ihrer BigCommerceB2B-Anwendung
• Kopieren Sie die SSO-URL zur Authentifizierung über einen externen IDP
• Öffnen Sie diese URL in einem Inkognito-/privaten Browserfenster
• Vollständige Authentifizierung mit Ihrem externen IdP
• Nach erfolgreicher Überprüfung wird der Benutzer zu Ihrem Bigcommerce-Shop weitergeleitet

Externe Referenzen

• Einmaliges Anmelden (SSO)
• Was ist Single Sign-On (SSO) und wie funktioniert SSO?
• Erfahren Sie mehr über ADP Workforce Now (Mitarbeiter) SSO
• Erhalten Sie Einblicke in SAML-basiertes Single Sign-On