Configura l'SSO per un microsito impact.com tramite JWT

Il microsito del tuo programma Advocate di solito richiede ai tuoi customer advocate di registrarsi con un nome utente e una password prima di poter accedere ai propri link di condivisione e ai dettagli delle ricompense. Tuttavia, come alternativa avanzata, puoi invece autenticare gli utenti generando un JSON Web Token (JWT) lato server e trasmettendolo al microsito tramite un parametro URL.

Usando questo metodo, i partecipanti non avranno credenziali di accesso per il microsito. Invece, ottengono l'accesso effettuando l'accesso al tuo portale clienti esistente, che poi li reindirizza al microsito usando il JWT per identificarli e mostrare i loro contenuti personalizzati.

Prima di iniziare

Importante: Si tratta di un'implementazione avanzata che aggira il Managed Identity Service standard per il microsito e richiede il supporto del tuo team di sviluppo per la configurazione.

Dovresti usare questo metodo solo se si applicano tutte le condizioni seguenti:

• Vuoi simulare un'esperienza di single sign-on (SSO) effettuando automaticamente l'accesso dei partecipanti al microsito del tuo programma.
• Puoi generare i JWT lato server.
• Non puoi o non vuoi installare il Universal Tracking Tag (UTT) nel tuo sito.

1

Passaggio 1: crea un microsito senza identità gestita

Quando crei il tuo microsito, dovrai disattivare il Managed Identity Service, quindi impostare tutte le tue pagine in modo che siano accessibili agli utenti "non verificati". La Dashboard pagina utilizzerà il JWT per autenticare l'utente e caricare il microsito.

Crea il microsito

Per prima cosa, modifica le impostazioni per disattivare l' Accesso partecipanti opzione.

1. Dal menu di navigazione a sinistra, seleziona [Engage] → Contenuti.
2. Nella Microsito scheda, seleziona Modifica impostazioni.
3. Verrai quindi reindirizzato al tuo nuovo Impostazioni microsito pagina.
4. All'interno del Accesso sezione, [Disattiva] Accesso partecipanti.
5. Seleziona Salva impostazioni.

Configura la pagina Dashboard

Successivamente, configura la Dashboard pagina del tuo microsito in modo che sia visibile agli utenti non verificati. Quindi, collega i componenti della pagina al tuo programma di referral in modo che vengano visualizzate le informazioni corrette.

1. Regola le impostazioni della Dashboard pagina del tuo sito.

   • Dal menu di navigazione a sinistra, seleziona [Engage] → Contenuti → Contenuto di configurazione o Modifica contenuto.
   • Dal Microsito scheda, seleziona Dashboard nel Layout per utenti connessi sezione.
   • Seleziona [Menu] → Impostazioni.
   • Dal Utenti consentiti elenco a discesa, seleziona Non verificato.
2. Aggiungi l'ID del tuo programma ai componenti della Dashboard.

   • Statistiche utente — Devi aggiungere l'ID a ciascuna statistica utente individuale che scegli di visualizzare.
   • Link di condivisione
   • Codice di referral
   • Pulsanti dei social media — Devi aggiungere l'ID a ciascun pulsante di condivisione sui social media individuale che scegli di includere.
3. Nell'angolo in alto a destra, seleziona Salva.

   

Per assistenza sull'uso dell'editor per trovare e modificare le impostazioni della pagina e dei componenti, fai riferimento a Spiegazione dell'editor del microsito e Personalizza layout e pagine del microsito.

Rimuovi le pagine non necessarie

Rimuovi il layout e le pagine che il tuo microsito non utilizzerà.

1. Passa il cursore sopra la pagina o il layout.
2. Seleziona [Altro] → Elimina.
3. Rimuovi il Layout per utenti connessi.
4. Rimuovi le seguenti pagine:

   • Modifica profilo
   • Verifica email
   • Password dimenticata
   • Accesso
   • Esci
   • Registrazione
   • Reimposta password
   • Verifica email

2

Passaggio 2: genera il JWT

La struttura del JWT segue i requisiti standard di Advocate per l'autenticazione degli utenti. Se hai già integrato Advocate in passato, probabilmente stai già generando token simili per UTT.

Devi generare il JWT in modo sicuro sul tuo server o su qualsiasi sistema backend affidabile—mai nel browser.

Scopri come generare un JWT e i requisiti del payload.

3

Passaggio 3: aggiungi il JWT all'URL del microsito

Una volta che l'utente ha effettuato l'accesso alla tua piattaforma, reindirizzalo al microsito includendo il JWT nella stringa di query dell'URL.

Esempio: https://your-microsite.squatch.app/?jwt=<YOUR_GENERATED_JWT>

Puoi aprire il microsito in una nuova scheda del browser oppure incorporarlo nella tua app usando un iframe. Se decidi di incorporare il microsito, assicurati di gestire la condivisione delle risorse tra origini diverse (CORS) e le restrizioni del browser in modo appropriato.

Note

• Se usi questo metodo di autenticazione, gli utenti non avranno credenziali di accesso per il microsito.
• L'accesso basato su JWT deve essere strettamente controllato. Non esporlo né manipolarlo in JavaScript lato client.
• Si tratta di un approccio non standard: testalo approfonditamente nel tuo ambiente di staging prima di distribuire il tuo programma.
• Se hai bisogno di supporto, includi l'URL del tuo microsito, i dettagli dell'implementazione e un esempio di payload JWT nella tua richiesta di assistenza.