# Impostare SSO per un microsite 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 loro link di condivisione e ai dettagli delle ricompense. Tuttavia, come alternativa avanzata, puoi invece autenticare gli utenti generando un [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) sul server e passandolo al microsito tramite un parametro URL.

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

#### Prima di iniziare

{% hint style="warning" %}
**Importante:** Questa è un'implementazione avanzata che bypassa il servizio di Managed Identity standard per il microsito e richiede il supporto del tuo team di sviluppatori per essere configurata.
{% endhint %}

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

* Vuoi simulare un'esperienza di single sign-on (SSO) effettuando automaticamente il login dei partecipanti nel microsito del tuo programma.
* Puoi generare JWT sul server.
* Non puoi o non vuoi installare il [Universal Tracking Tag (UTT)](https://help.impact.com/brand/it/di-cosa-vorresti-imparare/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt) sul tuo sito.

{% stepper %}
{% step %}

### Passo 1: Crea un microsito senza managed identity

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 userà il JWT per autenticare l'utente e caricare il microsito.

<details>

<summary>Crea il microsito</summary>

Per prima cosa, regola le impostazioni per disattivare l'opzione *Participant Login* .

1. Dal menu di navigazione a sinistra, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fh35M3mMIl7XP42pqh7Ls%2Fimage.png?alt=media\&token=bf6b6ba2-295c-4cdb-8c77-f171416c13e1) **\[Engage]** **→ Contenuto**.
2. Sulla *card Microsite* , seleziona **Modifica impostazioni**.
3. Verrai quindi reindirizzato alla tua nuova *pagina Impostazioni Microsito* .
4. All'interno della *sezione Login* , ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-2c3a3c392d640f7b79d44c16f21c2c4f0ec3dcca%2F80381ca112cfb2757e97b8669cc0b5c98c8ce8d60ed9e3048b4a86a52e76719f.svg?alt=media) **\[Disattiva]** **Participant Login**.
5. Seleziona **Salva impostazioni**.

</details>

<details>

<summary>Configura la pagina Dashboard</summary>

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

1. Regola le impostazioni della pagina *Dashboard* del tuo sito.
   * Dal menu di navigazione a sinistra, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F8AYI7cAhXQWYRoQlKHte%2Fimage.png?alt=media\&token=d2b5a01e-c7b4-4a71-a6a0-0cea5a4b7ac4) **\[Engage]** **→ Contenuto** → **Imposta contenuti** o **Modifica contenuti**.
   * Dalla *card Microsite* scheda, seleziona **Dashboard** nel *Layout con accesso effettuato* sezione.
   * Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c746d936c908b9090325464502f7c10acda0e993%2F2a92939e8e78dd7e0c0416b1a250d5ef1d7ab0dec966fb5ed320ca62acfc06c5.svg?alt=media) **\[Menu] → Impostazioni**.
   * Dalla *Utenti consentiti* nel menu a discesa, seleziona **Non verificato**.
2. Aggiungi l'ID del tuo programma ai componenti su *Dashboard*.
   * Statistiche utente — Devi aggiungere l'ID a ogni singola statistica utente che scegli di mostrare.
   * Link di condivisione
   * Codice referral
   * Pulsanti social media — Devi aggiungere l'ID a ogni singolo pulsante di condivisione sui social media che decidi di includere.
3. In alto a destra, seleziona **Salva**.

   <div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-7314ab2d13689a218d7b2ab0ff0ae784aecc169d%2Fe489a23c2242c41439531bebcaa74a7caac8de79b22b4e423c11194933156962.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>

Per assistenza nell'uso dell'editor per trovare e regolare le impostazioni della pagina e dei componenti, consulta [Spiegazione dell'editor del microsito](https://help.impact.com/brand/it/di-cosa-vorresti-imparare/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsite-editor-explained) e [Personalizza layout e pagine del microsito](https://help.impact.com/brand/it/di-cosa-vorresti-imparare/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages).

</details>

<details>

<summary>Rimuovi pagine non necessarie</summary>

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

1. Passa il cursore sul nome della pagina o del layout.
2. Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Altro]** **→ Elimina**.
3. Rimuovi il *Layout con accesso effettuato*.
4. Rimuovi le seguenti pagine:
   * Modifica profilo
   * Verifica email
   * Password dimenticata
   * sezione Login
   * Logout
   * Registrati
   * Reimposta password
   * Verifica email

</details>
{% endstep %}

{% step %}

### Passo 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 precedenza, probabilmente stai già generando token simili per l'UTT.

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

Scopri come [generare un JWT e i requisiti del payload](https://integrations.impact.com/impact-brand/docs/json-web-tokens).
{% endstep %}

{% step %}

### Passo 3: Aggiungi il JWT all'URL del microsito

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

{% hint style="info" %}
**Esempio:** `https://your-microsite.squatch.app/?jwt=<YOUR_GENERATED_JWT>`
{% endhint %}

Puoi aprire il microsito in una nuova scheda del browser oppure incorporare il microsito nella tua app usando un iframe. Se decidi di incorporare il microsito, assicurati di gestire correttamente [condivisione delle risorse tra origini diverse (CORS)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) e le restrizioni del browser.
{% endstep %}
{% endstepper %}

#### 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.
* Questo è un approccio non standard — testalo approfonditamente nel tuo ambiente di staging prima di distribuire il tuo programma.
* Se hai bisogno di [supporto](mailto:saasquatch-support@impact.com), includi l'URL del tuo microsito, i dettagli dell'implementazione e un esempio del payload JWT nella tua richiesta di supporto.
