# Configura SSO per un microsito impact.com tramite JWT

Il microsito del tuo programma Advocate richiede in genere che i tuoi customer advocate si registrino con un nome utente e una password prima di poter accedere ai loro link di condivisione e ai dettagli dei premi. Tuttavia, come alternativa avanzata, puoi invece autenticare gli utenti generando un [JSON Web Token (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) lato server e passandolo al microsito tramite un parametro URL.

Utilizzando questo metodo, i partecipanti non avranno credenziali di accesso per il microsito. Invece, vi accedono 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

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

Dovresti usare questo metodo solo se si applicano tutti i seguenti casi:

* Vuoi simulare un'esperienza di single sign-on (SSO) facendo accedere automaticamente i partecipanti al microsito del tuo programma.
* Puoi generare JWT lato server.
* Non puoi o non vuoi installare il [Universal Tracking Tag (UTT)](/brand/it/che-cosa-vorresti-imparare/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt.md) nel tuo sito.

{% stepper %}
{% step %}

#### Passaggio 1: crea un microsito senza identità gestita

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

<details>

<summary>Crea il microsito</summary>

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

1. Dal menu di navigazione a sinistra, seleziona ![](/files/720917583733ac0ce3601b5d636fd8a9595e7692) **\[Engage]** **→ Contenuto**.
2. Nella *Microsito* scheda, seleziona **Modifica impostazioni**.
3. Verrai quindi reindirizzato alla nuova *Impostazioni del microsito* .
4. All’interno del *sezione* Accesso, ![](/files/941b00a9fa459b1c6f0b7079a81a58a3edbc74a7) **\[Disattiva]** **Accesso partecipante**.
5. Seleziona **Salva impostazioni**.

</details>

<details>

<summary>Configura la pagina Dashboard</summary>

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. Modifica le impostazioni della *Dashboard* pagina del tuo sito.
   * Dal menu di navigazione a sinistra, seleziona ![](/files/720917583733ac0ce3601b5d636fd8a9595e7692) **\[Engage]** **→ Contenuto** → **Contenuto di configurazione** o **Modifica contenuto**.
   * Dalla *Microsito* scheda, seleziona **Dashboard** nel riquadro *Layout con accesso effettuato* .
   * Seleziona ![](/files/87bcd157e6813fe8c64f560d940c9e7ef39fe057) **\[Menu] → Impostazioni**.
   * Dalla *Utenti consentiti* nell'elenco a discesa, seleziona **Non verificati**.
2. Aggiungi l'ID del tuo programma ai componenti sulla *Dashboard*.
   * Statistiche utente — Devi aggiungere l'ID a ogni singola statistica utente che scegli di visualizzare.
   * Link di condivisione
   * Codice referral
   * Pulsanti dei social media — Devi aggiungere l'ID a ogni singolo pulsante di condivisione sui social media che scegli di includere.
3. Nell'angolo in alto a destra, seleziona **Salva**.

   <div data-with-frame="true"><figure><img src="/files/256300c23538db6b4840ab502fff3529335df7ac" alt="" width="563"><figcaption></figcaption></figure></div>

Per assistenza sull'uso dell'editor per trovare e modificare le impostazioni della tua pagina e dei componenti, fai riferimento a [Spiegazione dell’Editor del Microsito](/brand/it/che-cosa-vorresti-imparare/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsite-editor-explained.md) e [Personalizza layout e pagine del microsito](/brand/it/che-cosa-vorresti-imparare/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).

</details>

<details>

<summary>Rimuovi le pagine non necessarie</summary>

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

1. Passa il cursore sopra la pagina o il layout.
2. Seleziona ![](/files/6a36670a9e3518128f7130049c54b7a9613f756b) **\[Altro]** **→ Elimina**.
3. Rimuovi il *Layout con accesso effettuato*.
4. Rimuovi le seguenti pagine:
   * Modifica profilo
   * Verifica email
   * Password dimenticata
   * sezione
   * Disconnetti
   * Registrazione
   * Reimposta password
   * Verifica email

</details>
{% endstep %}

{% step %}

#### 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 fidato—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 %}

#### Passaggio 3: aggiungi il JWT all'URL del microsito

Una volta che l'utente ha effettuato l'accesso alla 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 incorporarlo nella tua app usando un iframe. Se decidi di incorporare il microsito, assicurati di gestire correttamente [la 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.
* Si tratta di un approccio non standard — testalo accuratamente nel tuo ambiente di staging prima di rilasciare il programma.
* Se hai bisogno di [supporto](mailto:saasquatch-support@impact.com), includi l'URL del microsito, i dettagli dell'implementazione e un esempio di payload JWT nella tua richiesta di supporto.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.impact.com/brand/it/che-cosa-vorresti-imparare/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-sso-for-an-impactcom-microsite-via-jwt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
