• Casa
• Integrazioni di app
• Accesso singolo (SSO) B2B di Bigcommerce

Accesso singolo (SSO) B2B di Bigcommerce

---

Questa guida fornisce istruzioni dettagliate per la configurazione del Single Sign-On (SSO) tra miniOrange e BigCommerce B2B Edition. Questa integrazione consente un'autenticazione fluida, consentendo agli utenti di accedere al tuo negozio BigCommerce B2B utilizzando le proprie credenziali miniOrange, senza dover utilizzare credenziali di accesso separate.

Panoramica della soluzione:

• Abilita l'SSO per gli utenti del negozio B2B di BigCommerce.
• Fornisce automaticamente gli account dei clienti in BigCommerce.
• Sincronizza gli attributi utente tra BigCommerce e miniOrange o qualsiasi Identity Provider (IdP) esterno.
• Crea e gestisce aziende B2B e ruoli utente.

Prerequisiti per Bigcommerce SSO

Prima di iniziare questa configurazione, assicurati di avere:

• Negozio BigCommerce: Un negozio BigCommerce attivo con B2B Edition abilitata.
• Accesso amministratore: Autorizzazioni di proprietario o amministratore del negozio in BigCommerce.
• Conto miniOrange: Conto miniOrange attivo.

Segui la guida passo passo fornita di seguito per l'accesso singolo (SSO) b2b di Bigcommerce

Passaggio 1: creare le credenziali API di BigCommerce

1.1 Impostazioni dell'account API di accesso

• Accedere al Pannello di amministrazione di BigCommerce.
• Accedere a Impostazioni profilo dal menu principale.
• Scorri verso il basso e seleziona Account API.




1.2 Crea un nuovo account API

• Fare clic su Crea un account API.
• Seleziona Crea token API V2/V3 Dal menu a discesa.
• Inserisci un nome descrittivo per il tuo account API.

1.3 Configurare le autorizzazioni API

• Trova il tuo Hash del negozio nel campo percorso API, che appare come:

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




• Nota: Salva questo store_hash valore - ti servirà più tardi
• Configurare le seguenti autorizzazioni:
• Clienti: Impostato per modificare
• Accesso clienti: Imposta per accedere



• Scorri verso il basso e imposta Edizione B2B ambito a modificare. Fare clic su Salva.




1.4 ID cliente e segreto cliente

• Dopo aver salvato, BigCommerce visualizzerà le tue credenziali sullo schermo e scaricherà un txt file contenente le tue credenziali. Salva i valori di ID cliente, Client Secret and Token di accesso.

Passaggio 2: configurare l'applicazione BigCommerce in miniOrange

2.1 Aggiungi nuova applicazione

• Accedere al Console di amministrazione miniOrange.
• Vai su Apps e cliccare su Aggiungi applicazione pulsante.



• In Scegli applicazione, seleziona J.W.T. come tipo di app.



• Nel passaggio successivo, cerca l'applicazione BigCommerceB2B dall'elenco e cliccaci sopra.




2.2 Configurare le impostazioni di base

• Nella scheda Base, immettere i seguenti valori:

  Settore	Valore	Descrizione
  Display Nome	BigCommerce	Nome personalizzato per questa integrazione
  URL di reindirizzamento	https://{my-store}.mybigcommerce.com/login/token/	sostituire {my-store} con l'URL effettivo del tuo negozio
  ID cliente	[From Step 1.4]	Copia dalle credenziali dell'API BigCommerce
  Client Secret	[From Step 1.4]	Copia dalle credenziali dell'API BigCommerce
  Token di accesso (B2B)	[From Step 1.4]	Copia dalle credenziali dell'API BigCommerce
  Descrizione	Opzionale	Breve descrizione di questa integrazione

2.3 Configurare le impostazioni avanzate

• Passare alla scheda Avanzate e configurare:

  Configurazione	Valore	Descrizione
  Algoritmo della firma	HS256	Richiesto per l'autenticazione JWT di BigCommerce
  URL di disconnessione	https://{my-store}.mybigcommerce.com/login.php?action=logout	sostituire {my-store} con l'URL del tuo negozio





2.3 Configurare la mappatura degli attributi richiesti

• Passare alla Attributo scheda e configurare quanto segue obbligatorio attributi:

  nome attributo	Valore/Mappatura	Descrizione
  first_name	Mappa sul campo del nome dell'utente	Nome dell'utente
  last_name	Mappa sul campo del cognome dell'utente	Cognome dell'utente
  email	Mappa sul campo email dell'utente	Indirizzo email dell'utente (identificatore univoco)
  operation	customer_login	Valore statico - richiesto per il funzionamento SSO
  store_hash	[From Step 1.3]	Valore hash del tuo negozio
  redirect_to	/account.php or /	Endpoint di reindirizzamento post-accesso (ad esempio, /account.php per la pagina dell'account, / per la homepage)
  companyName	Mappa sul campo aziendale o sul valore statico	Nome dell'azienda per l'account B2B

Istruzioni per la mappatura degli attributi:

• Clicchi Aggiungi mappatura degli attributi.
• Inserire il nome dell'attributo esattamente come mostrato (rispettando le maiuscole e le minuscole).
• Seleziona il campo utente corrispondente dal tuo provider di identità.
• Per i valori statici, immettere il valore in Valore attributo personalizzato come mostrato nell'immagine.
• Fare clic su Salva.




2.4 Configurare gli attributi facoltativi

• Oltre agli attributi obbligatori, è possibile configurare attributi facoltativi aggiuntivi per personalizzare il provisioning degli utenti e la configurazione aziendale.

Attributi facoltativi disponibili

Attributo	Descrizione	Valori accettati	Valore di default
role	Ruolo dell'utente all'interno dell'azienda B2B	admin, senior_buyer, junior_buyer	junior_buyer
phone	Numero di telefono di contatto dell'azienda	Stringa di numero di telefono valida	1234567890
country	Sede principale dell'azienda	Nome completo del paese o codice paese di due lettere (ad esempio, "Stati Uniti", "US", "Canada", "CA")	United States




Come aggiungere attributi facoltativi

• Nel Attributo scheda, fare clic Aggiungi mappatura degli attributi.
• Inserire il nome dell'attributo esattamente come mostrato sopra (facendo attenzione a maiuscole e minuscole).
• Mappalo sul campo corrispondente del tuo provider di identità oppure inserisci un valore statico.
• Fare clic su Salva.




Note importanti sugli attributi facoltativi

• Eccezione del primo utente: Il primo utente creato per qualsiasi azienda riceverà automaticamente il ruolo di amministratore, indipendentemente dalla mappatura degli attributi del ruolo. Questo garantisce che ogni azienda abbia almeno un amministratore.
• Formato telefono: Sono accettati tutti i formati di numero di telefono.
• Nomi dei paesi: Utilizzare i nomi completi dei paesi così come appaiono in BigCommerce (ad esempio, "Stati Uniti" e non "US" o "USA").
• Valori predefiniti applicati: Se gli attributi opzionali non sono configurati, il sistema utilizzerà i valori predefiniti elencati sopra. L'integrazione funzionerà normalmente anche senza di essi.

Passaggio 3: configurare i criteri di accesso

3.1 Creare una policy di accesso

• Passare alla Politica scheda.
• Clicchi Aggiungi criterio.
• Configurare la policy immettendo i seguenti valori:

Settore	Valore	Descrizione
Nome gruppo	Default	Gruppo di utenti a cui si applica questa politica
Nome della politica	Scegli un nome descrittivo	Ad esempio, "Criterio SSO BigCommerce"
Primo fattore	Password or Password-less	Metodo di autenticazione primario




• Clicchi Invio per salvare la configurazione della policy.

Passaggio 4: testare la configurazione SSO

4.1 Scegli il tuo metodo di test

Il metodo di test dipende dalla configurazione del provider di identità:

Opzione A: miniOrange come fornitore di identità (IdP)

• Nella console di amministrazione miniOrange, accedi alla tua applicazione BigCommerceB2B
• copiare il URL SSO per l'autenticazione da miniOrange
• Apri questo URL in una finestra del browser in incognito/privata
• Accedi con credenziali miniOrange valide
• Dopo la verifica riuscita, l'utente viene reindirizzato al tuo negozio Bigcommerce

Opzione B: Fornitore di identità esterno

• Nella console di amministrazione miniOrange, accedi alla tua applicazione BigCommerceB2B
• copiare il URL SSO per l'autenticazione tramite IDP esterno
• Apri questo URL in una finestra del browser in incognito/privata
• Autenticazione completa con il tuo IdP esterno
• Dopo la verifica riuscita, l'utente viene reindirizzato al tuo negozio Bigcommerce

Riferimenti esterni

• Accesso singolo (SSO)
• Che cos'è il Single Sign-On (SSO) e come funziona?
• Scopri di più su ADP Workforce Now (dipendente) SSO
• Ottieni informazioni su Single Sign-On basato su SAML