• Casa
• Integrazioni di app
• BigCommerce Multi Store-Front Single Sign-On

miniOrange fornisce una soluzione completa per BigCommerce Multi-Storefront SSO (Single Sign-On). Grazie all'integrazione della soluzione SSO di miniOrange, i clienti BigCommerce hanno la possibilità di effettuare il login una volta sola e di accedere a tutti i negozi BigCommerce affiliati. Ciò elimina la necessità di credenziali di accesso separate e semplifica l'esperienza utente, con conseguente riduzione dell'attrito.

Con le funzionalità SSO Multi Store-front di BigCommerce puoi:

• Gestione semplificata: Gestisci centralmente i dati e le autorizzazioni dei clienti su più vetrine, riducendo le spese amministrative.
• Scalabilità: La soluzione miniOrange SSO è adatta alle aziende in crescita con più vetrine, offrendo una soluzione scalabile per la gestione dell'autenticazione degli utenti.
• Maggiore soddisfazione del cliente: L'esperienza di accesso fluida garantisce ai clienti un'esperienza di acquisto comoda, con conseguente aumento della soddisfazione e della fedeltà.

Partner tecnologico verificato di BigCommerce

Supporto SSO + MFA per qualsiasi piano BigCommerce (Standard, Plus, Pro, Enterprise)

Prerequisiti

A. Branding e personalizzazione

• Accedi a miniOrange Console di amministrazione.
• Fare clic su Personalizzazione nel menu a sinistra della dashboard.
• In Impostazioni di base, imposta il dominio della tua azienda in Nome organizzazione campo di testo.
• Clicchi SalvaUna volta impostato, l'URL di accesso con marchio sarà nel formato https://<company_domain>.xecurify.com/moas/login

B. Crea l'API BigCommerce

• Accedere Pannello di amministrazione BigCommerce.
• Vai su Impostazioni >> API >> Account API a livello di negozio.



• Fai clic su Crea account API e scegli il tipo di token come Token API V2/V3.
• Aggiungi un nome adatto per il tuo account API.

Nota: in BigCommerce , il percorso API è l'URL di base che la tua applicazione o integrazione utilizza per connettersi ai dati del tuo negozio tramite le API di BigCommerce. L' hash del negozio è un identificatore univoco generato automaticamente da BigCommerce per ogni negozio. Appare nel percorso API.



• Copiare l'hash dello store evidenziato dal percorso API.



• Attivare la Clienti opzione come modificare and Accesso clienti opzione come accessoLascia invariate le altre impostazioni.
• Fare clic su SalvaScarica il file delle credenziali API. Contiene il token di accesso, l'ID client e il segreto client.




C. Recupera gli ID dei canali

• Per eseguire l'SSO in diverse vetrine/canali avremo bisogno dei channel_id di tutte le vetrine.
• Per ottenere tutti i channel_ID e l'URL della vetrina (redirect_url) del tuo negozio BigCommerce, hai 2 modi:

• Interfaccia utente di amministrazione
• Cliente API

• Accedi al pannello di amministrazione del tuo negozio BigCommerce.
• Clicca sul Channel Manager opzione nel menu a sinistra.




Qui vedrai un elenco di tutti i canali con ID e URL delle vetrine attualmente connessi al tuo negozio BigCommerce.

• Effettua una richiesta GET al seguente endpoint API:
• Puoi visitare Qui. ed effettua una chiamata API per recuperare i tuoi channel_ids.



• Se la richiesta ha esito positivo, riceverai una risposta JSON contenente un array di tutti i canali collegati al tuo negozio.
• Ciascun oggetto canale conterrà informazioni quali il tipo di canale, l'ID del canale e il nome del canale.
• Ecco fatto! Ora dovresti essere in grado di recuperare tutti i canali connessi al tuo negozio BigCommerce tramite l'API.

Segui la guida dettagliata fornita di seguito per l'accesso Single Sign-On (SSO) di BigCommerce

1. Configurare BigCommerce in miniOrange

Per le configurazioni con più punti vendita, è possibile scegliere uno dei seguenti approcci in base alle proprie esigenze:

• Configura un'applicazione separata per ogni negozio, in modo da gestirli in modo indipendente.
• Configura una singola applicazione e aggiungi più URL di reindirizzamento nella scheda Configurazione di base per supportare più negozi all'interno di un'unica configurazione.

• Applicazioni individuali
• Applicazione centralizzata

• Accedi a miniOrange Console di amministrazione.
• Vai su Apps Fare clic su Aggiungi applicazione pulsante.



• Nel Scegli l'applicazione sezione, aprire l'elenco a discesa di Tutte le applicazioni e seleziona J.W.T..



• Nel passaggio successivo, cerca BigCommerce applicazione dall'elenco e cliccarci sopra.



• Inserire i seguenti valori nei rispettivi campi.



• Inserire il ID client, segreto client and Token di accesso che abbiamo scaricato da passaggio 1 durante la creazione dell'API nella console di BigCommerce.

  Nome visualizzato [obbligatorio]	BigCommerce (a tua scelta)
  URL di reindirizzamento [obbligatorio]	Fare riferimento a Note: Di seguito è possibile visualizzare l'URL di reindirizzamento.
  ID cliente	Copia dal file scaricato in Fase 1
  Client Secret	Copia dal file scaricato in Fase 1
  Token di accesso	Copia dal file scaricato in Fase 1
  Descrizione	Secondo la tua scelta

  Nota: L'URL di reindirizzamento dovrebbe essere: /accesso/token/
  Ad esempio: https://xyz.bigcommerce.com/login/token/
  

  Per trovare l'URL del tuo negozio: vai su Canali >> Negozi . Copia l'URL visualizzato per il tuo negozio.

  
  
  
• Ora la prossima mossa è Filtri scheda.




Oggetto	Indirizzo e-mail.
Algoritmo della firma	HS256
URL di disconnessione	Copia l'URL del negozio come indicato sopra e aggiungi /login.php?action=logout

• Clicchi Avanti per andare al Opzioni Login scheda.




Forza autenticazione	Abilita questa opzione se desideri che l'utente si autentichi anche se ha una sessione attiva.
IDP primario	L'origine dell'identità rispetto alla quale l'utente verrà autenticato.
Mappatura utente	Abilita questa opzione se stai inviando l'utente connesso da questa app nella risposta.

• Per eseguire Mappatura degli attributi e aggiungere nuovi attributi, Navigare a Attributi scheda e fai clic su +Aggiungi attributo.
• I primi tre attributi saranno valori codificati.

nome attributo	Tipo di attributo	Valore attributo
hash_archivio	Valore attributo personalizzato	Copia dal Percorso API come descritto in Crea API per BigCommerce (Prerequisiti).
reindirizza_a	Valore attributo personalizzato	Endpoint a cui si desidera reindirizzare l'utente dopo SSO. [Homepage o pagina dell'account, ad esempio /account.php]
operazione	Attributo del profilo personalizzato	accesso cliente
nome	Attributo IDP esterno	nome
cognome	Attributo IDP esterno	cognome
email	Attributo IDP esterno	email




• Fare clic su Salva Pulsante.
• Accedere a Politiche scheda.
• Fare clic su Assegna gruppo pulsante.



• Nella sezione Assegna gruppo.
• Scegliere il PREDEFINITO gruppo.
• Clicca sul Avanti pulsante.



• Assegna le policy al gruppo. Qui puoi scegliere il metodo di autenticazione principale per gli utenti. Dal menu a discesa sotto Primo fattore, selezionare Password.

Primo fattore

Password

• Fare clic su Salva.

• Accedere al Console di amministrazione miniOrange e vai a Apps.
• Apri l'applicazione configurata per un negozio e vai alla Basic scheda.
• Fare clic su Aggiungi URL di reindirizzamento.
• Inserisci l'URL di reindirizzamento richiesto per il negozio aggiuntivo e fai clic Salva.



• Quindi, vai al file endpoint scheda.
• Poiché una singola applicazione è configurata per più negozi, vedrai più URL SSO per l'autenticazione da miniOrange, uno per ogni negozio.

2. Configura la tua directory utente (facoltativo)

miniOrange offre l'autenticazione degli utenti da varie fonti esterne, tra cui directory (come ADFS, Microsoft Active Directory, Microsoft Entra ID, OpenLDAP, Google, AWS Cognito ecc.), provider di identità (come Okta, Shibboleth, Ping, OneLogin, KeyCloak), database (come MySQL, MariaDB, PostgreSQL) e molti altri . È possibile configurare la directory/archivio utenti esistente o aggiungere utenti in miniOrange.

• Imposta miniOrange come IDP
• Imposta IDP esterno

• Per aggiungere i tuoi utenti in miniOrange ci sono 2 modi:
• Crea utente in miniOrange
• Caricamento in blocco degli utenti

1. Crea utente in miniOrange

• Fare clic su Utenti >> Elenco utenti >> Aggiungi utente.



• Qui, compila i dettagli dell'utente senza la password e poi clicca su Crea utente pulsante.



• Dopo la creazione corretta dell'utente, verrà visualizzato un messaggio di notifica "Un utente finale è stato aggiunto correttamente" verrà visualizzato nella parte superiore della dashboard.



• Fare clic su Scheda Stato di onboardingControlla l'e-mail con l'ID e-mail registrato e seleziona l'azione Invia e-mail di attivazione con collegamento per la reimpostazione della password da Seleziona azione elenco a discesa e quindi fare clic su APPLICA pulsante.



• Ora, apri il tuo ID e-mail. Apri la posta che ricevi da miniOrange e poi clicca su link per impostare la password del tuo account.
• Nella schermata successiva, inserisci la password e conferma la password, quindi fai clic su Reimposta password Single Sign-On (SSO) pulsante.



• Ora puoi accedere all'account miniOrange inserendo le tue credenziali.

2. Caricamento in blocco degli utenti in miniOrange tramite caricamento di file CSV.

• Accedere a Utenti >> Elenco utenti. Fare clic su Aggiungi utente pulsante.



• Registrazione in blocco degli utenti Scarica il formato csv di esempio dalla nostra console e modifichiamo questo file csv seguendo le istruzioni.



• Per caricare in blocco gli utenti, seleziona il file e assicurati che sia in formato file .csv separato da virgole quindi fare clic su Carica.



• Dopo aver caricato correttamente il file csv, vedrai un messaggio di successo con un link.
• Cliccando su quel link vedrai l'elenco degli utenti a cui inviare la mail di attivazione. Seleziona gli utenti a cui inviare la mail di attivazione e clicca su Invia mail di attivazione. Una mail di attivazione verrà inviata agli utenti selezionati.

miniOrange si integra con varie fonti utente esterne, come directory, provider di identità, ecc.

• Okta
• ADFS
• Ping
• AWS Cognito
• Molti altri

Non riesci a trovare il tuo IdP o hai bisogno di aiuto per configurarlo?

Contattaci o inviaci un'e-mail all'indirizzo idpsupport@xecurify.com e ti aiuteremo a configurarlo in pochissimo tempo.

3. Sincronizzazione dei campi indirizzo, modulo e attributi personalizzati con BigCommerce (facoltativo)

Per sincronizzare l'indirizzo, gli attributi personalizzati e i campi del modulo dall'Identity Provider (IDP) a BigCommerce, è necessario configurare i seguenti dettagli:

Campi indirizzo

Per sincronizzare correttamente le informazioni sull'indirizzo del cliente, sono richiesti i seguenti attributi:

• nome
• cognome
• address1
• città
• prefisso internazionale

• miniOrange come IDP
• Fornitore di identità esterno

Nel diagramma sottostante utilizziamo miniOrange come IDP.

• Prima di sincronizzare questi campi con BigCommerce, crea prima gli attributi corrispondenti nel profilo utente di miniOrange. Per fare ciò, fai clic su Aggiungi campi profilo personalizzati pulsante situato nell'angolo in alto a destra. Una volta creati, questi attributi possono essere mappati e sincronizzati con BigCommerce.



• Quindi dobbiamo configurare la mappatura degli attributi nell'applicazione.

  nome attributo	Tipo di attributo	Valore
  indirizzi.nome	Nome	-
  indirizzi.cognome	Cognome	-
  indirizzi.indirizzo1	Attributo del profilo personalizzato	address1
  indirizzi.città	Attributo del profilo personalizzato	città
  indirizzi.stato_o_provincia	Attributo del profilo personalizzato	stato / provincia
  indirizzi.codice_paese	Attributo del profilo personalizzato	nazione
  indirizzi.codice_postale	Attributo del profilo personalizzato	codice postale





Nota: Quando si invia il valore del paese, utilizzare sempre il codice paese (ad esempio, US, IN). Se si passa il nome completo del paese, ad esempio "Stati Uniti", il valore non verrà aggiornato: per una mappatura corretta sono supportati solo i codici paese.

Durante la sincronizzazione dei campi dell'indirizzo, assicurati che i valori di città, stato e paese forniti siano opzioni valide supportate da BigCommerce e presenti nei rispettivi elenchi a discesa.



• Ora, dopo aver completato l'SSO, vai alla dashboard di BigCommerce. Dalla barra laterale, clicca su Clienti.
• Vedrai l'elenco di tutti i clienti. Cerca l'utente specifico e clicca sul suo nome.
• Quindi, apri il Rubrica del cliente sezione: qui potrai visualizzare i dettagli dell'indirizzo del cliente.

Per i campi del modulo di registrazione:

• In BigCommerce sono disponibili i seguenti campi del modulo. Dobbiamo configurare i mapping degli attributi corrispondenti nell'applicazione per garantire che questi campi siano correttamente sincronizzati con BigCommerce.



• Quindi dobbiamo configurare la mappatura degli attributi nell'applicazione.

  nome attributo	Tipo di attributo	Valore
  form_fields.name.0	Valore attributo personalizzato	Scuola di legge
  campi_form.value.0	Valore attributo personalizzato	XYZ
  form_fields.name.1	Valore attributo personalizzato	Esame di Stato per l'abilitazione alla professione forense
  campi_form.value.1	Valore attributo personalizzato	Arizona
  form_fields.name.2	Valore attributo personalizzato	Data dell'esame di abilitazione alla professione forense
  campi_form.value.2	Valore attributo personalizzato	31-12-2025
  form_fields.name.3	Valore attributo personalizzato	Mese di laurea stimato
  campi_form.value.3	Valore attributo personalizzato	Gennaio
  form_fields.name.4	Valore attributo personalizzato	Anno di laurea stimato
  campi_form.value.4	Valore attributo personalizzato	2025




• Dopo aver completato SSO, vai al tuo Dashboard di BigCommerce.
• Dalla barra laterale sinistra, fare clic su Clienti.
• Ora vedrai il elenco di tutti i clienti.
• Cerca l'utente specifico e clicca sul loro nome.
• Si aprirà il profilo del cliente: scorri verso il basso fino a Dettagli cliente .
• Qui vedrai il campi del modulo di registrazione, dove puoi visualizzare tutti i dettagli dei campi del modulo inviati dal cliente.

Per i campi attributo

• In BigCommerce sono disponibili i seguenti campi attributo. Dobbiamo configurare le mappature degli attributi corrispondenti nell'applicazione per garantire che questi campi siano correttamente sincronizzati con BigCommerce.



• Quindi dobbiamo configurare la mappatura degli attributi nell'applicazione.

  nome attributo	Tipo di attributo	Valore
  colore	Attributo del profilo personalizzato	blu
  indirizzo_cliente	Attributo del profilo personalizzato	strada MG
  cliente_mobile	Attributo del profilo personalizzato	+911234567890
  DOB	Attributo del profilo personalizzato	2002-01-01
  stringa_attributo 01	Attributo del profilo personalizzato	analisi




• Dopo aver completato SSO, vai al tuo Dashboard di BigCommerce.
• Dalla barra laterale sinistra, fare clic su Clienti.
• Ora vedrai il elenco di tutti i clienti.
• Cerca l'utente specifico e clicca sul loro nome.
• Si aprirà il profilo del cliente: scorri verso il basso fino a Dettagli cliente .
• Qui vedrai il campi attributo, dove puoi visualizzare tutti i dettagli dei campi del modulo inviati dal cliente.

NOTA: Aggiorna il profilo del cliente durante SSO

• Vai all'applicazione BigCommerce che hai configurato in miniOrange.
• Aprire il Filtri scheda.
• Scorri fino in fondo alla pagina.
• Abilita la casella di controllo Aggiorna il profilo del cliente durante l'SSO.

Per il fornitore di identità esterno

• Prima di sincronizzare questi campi con BigCommerce, è necessario per prima cosa crea gli attributi corrispondenti nel profilo utente miniOrangeQuesti attributi verranno quindi mappati e sincronizzati con BigCommerce.
• Quindi dobbiamo configurare la mappatura degli attributi nell'applicazione.
• Per il campo Indirizzo:

  nome attributo	Tipo di attributo	Valore
  indirizzi.nome	Attributo IDP esterno	nome
  indirizzi.cognome	Attributo IDP esterno	cognome
  indirizzi.indirizzo1	Attributo IDP esterno	street1
  indirizzi.città	Attributo IDP esterno	città
  indirizzi.stato_o_provincia	Attributo IDP esterno	stato
  indirizzi.codice_paese	Attributo IDP esterno	nazione
  indirizzi.codice_postale	Attributo IDP esterno	codice postale





Nota: Quando si invia il valore del paese, utilizzare sempre il codice paese (ad esempio, US, IN). Se si passa il nome completo del paese, ad esempio "Stati Uniti", il valore non verrà aggiornato: per una mappatura corretta sono supportati solo i codici paese.

Durante la sincronizzazione dei campi dell'indirizzo, assicurati che i valori di città, stato e paese forniti siano opzioni valide supportate da BigCommerce e presenti nei rispettivi elenchi a discesa.



• Ora, dopo aver completato l'SSO, vai alla dashboard di BigCommerce. Dalla barra laterale, clicca su Clienti.
• Vedrai l'elenco di tutti i clienti. Cerca l'utente specifico e clicca sul suo nome.
• Quindi, apri il Rubrica del cliente sezione: qui potrai visualizzare i dettagli dell'indirizzo del cliente.




Per i campi del modulo di registrazione:

• In BigCommerce sono disponibili i seguenti campi del modulo. Dobbiamo configurare i mapping degli attributi corrispondenti nell'applicazione per garantire che questi campi siano correttamente sincronizzati con BigCommerce.




nome attributo	Tipo di attributo	Valore
form_fields.name.0	Valore attributo personalizzato	Scuola di legge
campi_form.value.0	Attributo IDP esterno	facoltà di giurisprudenza
form_fields.name.1	Valore attributo personalizzato	Esame di Stato per l'abilitazione alla professione forense
campi_form.value.1	Attributo IDP esterno	stato dell'esame di avvocato
form_fields.name.2	Valore attributo personalizzato	Data dell'esame di abilitazione alla professione forense
campi_form.value.2	Attributo IDP esterno	data_esame_di_avvocatura
form_fields.name.3	Valore attributo personalizzato	Mese di laurea stimato
campi_form.value.3	Attributo IDP esterno	mese
form_fields.name.4	Valore attributo personalizzato	Anno di laurea stimato
campi_form.value.4	Attributo IDP esterno	anno




• Dopo aver completato SSO, vai al tuo Dashboard di BigCommerce.
• Dalla barra laterale sinistra, fare clic su Clienti.
• Ora vedrai il elenco di tutti i clienti.
• Cerca l'utente specifico e clicca sul loro nome.
• Si aprirà il profilo del cliente: scorri verso il basso fino a Dettagli cliente .
• Qui vedrai il campi del modulo di registrazione, dove puoi visualizzare tutti i dettagli dei campi del modulo inviati dal cliente.




Per campi di attributi personalizzati

• In BigCommerce sono disponibili i seguenti campi attributo. Dobbiamo configurare le mappature degli attributi corrispondenti nell'applicazione per garantire che questi campi siano correttamente sincronizzati con BigCommerce.



• Quindi dobbiamo configurare la mappatura degli attributi nell'applicazione.

  nome attributo	Tipo di attributo	Valore
  colore	Attributo IDP esterno	colore
  indirizzo_cliente	Attributo IDP esterno	indirizzo
  cliente_mobile	Attributo IDP esterno	numero_di_mobile
  DOB	Attributo IDP esterno	Data di nascita
  stringa_attributo 01	Attributo IDP esterno	stringa




• Dopo aver completato SSO, vai al tuo Dashboard di BigCommerce.
• Dalla barra laterale sinistra, fare clic su Clienti.
• Ora vedrai il elenco di tutti i clienti.
• Cerca l'utente specifico e clicca sul loro nome.
• Si aprirà il profilo del cliente: scorri verso il basso fino a Dettagli cliente .
• Qui vedrai il campi attributo, dove puoi visualizzare tutti i dettagli dei campi del modulo inviati dal cliente.




NOTA: Aggiorna il profilo del cliente durante SSO

• Vai all'applicazione BigCommerce che hai configurato in miniOrange.
• Aprire il Filtri scheda.
• Scorri fino in fondo alla pagina.
• Abilita la casella di controllo Aggiorna il profilo del cliente durante l'SSO.

4. Testare la configurazione SSO

• Per testare la configurazione SSO, è necessario l'URL di avvio SSO.
  • Modificare il Applicazione JWT hai appena creato.
  • Vai endpoint scheda e copiare il file URL dell'SSO.



• Apri una finestra del browser in modalità di navigazione in incognito/privata, incolla l'URL SSO e premi Invio.
  • Dovresti essere reindirizzato al tuo Identity Provider (IdP).
  • Dopo aver effettuato l'accesso con successo, verrai reindirizzato al tuo negozio BigCommerce come utente registrato.

  • Nota: se riscontri problemi durante il test delle configurazioni SSO, fai clic qui per la risoluzione dei problemi.

• Una volta ottenuto il successo, il passo successivo è aggiungere il URL dell'SSO ai link di accesso al tuo negozio.
  • Accedi a BigCommerce come Admin.
  • Accedere a Channel Manager >> Modifica impostazioni Storefront >> Temi >> Avanzate >> Modifica file tema.
  • Si aprirà una nuova finestra con i file del tema.
• I passaggi seguenti si applicano a Tema fondamentaleSe si utilizza un tema diverso, apportare le modifiche di conseguenza.
• Per la visualizzazione desktop:
  • Accedere a Modelli >> Componenti >> Comune >> navigation.html.
  • Sostituisci il link di accesso esistente: href="{{urls.auth.login}}" con href=" ".
  • cliccare su Salva e applica file.
• Per la visualizzazione su dispositivi mobili/tablet:
  • Accedere a Modelli >> Componenti >> Comuni >> navigation.html.
  • Sostituisci il link di accesso esistente: href="{{urls.auth.login}}" con href=" ".
  • cliccare su Salva e applica file.
• Infine, vai al tuo URL della vetrina, clicca su Accedie verificare che SSO funzioni come previsto.

5. Configurare SLO in BigCommerce

• Scarica la copione per avviare il Single Logout (SLO) in BigCommerce.
• Nella dashboard di BigCommerce, vai a Canali.
• Sotto il vetrine sezione, trova l'URL del tuo negozio e clicca su Script.



• Clicchi Crea uno script e aggiungi lo script scaricato al testata sezione della pagina.
• Abilitare le impostazioni come mostrato nell'immagine sottostante.





• Verrà aperta una casella di testo in cui potrai aggiungere lo script scaricato.

Riferimenti esterni

• Scopri di più su Single-Sign On (SSO)
• Che cosa è la gestione dell'identità e dell'accesso del cliente (CIAM)?
• Scopri di più su BigCommerce Single-Sign On (SSO)

Domande frequenti