> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-sso-for-an-impactcom-microsite-via-jwt.md).
# Configura l'SSO per un microsito impact.com tramite JWT
Il microsito del tuo programma Advocate richiede in genere che i customer advocate si registrino con nome utente e 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)](https://en.wikipedia.org/wiki/JSON_Web_Token) lato 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 l’accesso al 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:** Si tratta di un’implementazione avanzata che bypassa il Managed Identity Service standard per il microsito e richiede il supporto del tuo team di sviluppo per essere configurata.
{% endhint %}
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 JWT lato server.
* Non puoi o non vuoi installare il [Universal Tracking Tag (UTT)](/brand/it/what-would-you-like-to-learn-about/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt.md) Servizio di identità gestita
{% stepper %}
{% step %}
#### Passaggio 1: crea un microsito senza identità gestita
Quando crei il tuo microsito, dovrai disattivare il Managed Identity Service, quindi impostare tutte le pagine in modo che siano accessibili agli utenti "non verificati". La *Dashboard* pagina userà il JWT per autenticare l’utente e caricare il microsito.
Crea il microsito
Per prima cosa, modifica le impostazioni per disattivare il *Accesso partecipante* .
1. Dal menu di navigazione a sinistra, seleziona  **\[Engage]** **→ Contenuto**.
2. Nella *Microsito* scheda, seleziona **Modifica impostazioni**.
3. Verrai quindi reindirizzato al tuo nuovo *Impostazioni del microsito* pagina.
4. All'interno del *Accesso* sezione, .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Disattiva]** **Accesso partecipante**.
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. Poi, collega i componenti della pagina al tuo programma 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]** **→ Contenuto** → **Contenuti di configurazione** o **Modifica contenuto**.
* Dalla *Microsito* scheda, seleziona **Dashboard** nel *layout con accesso effettuato* sezione.
* Seleziona  **\[Menu] → Impostazioni**.
* Dalla *Utenti autorizzati* 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 referral
* Pulsanti social media — Devi aggiungere l’ID a ciascun pulsante di condivisione 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](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsite-editor-explained.md) e [Personalizzare layout e pagine del microsito](/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).
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 *layout con accesso effettuato*.
4. Rimuovi le seguenti pagine:
* Modifica profilo
* Verifica email
* Password dimenticata
* Accesso
* Disconnetti
* Registrazione
* Reimposta password
* Verifica email
{% 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, è probabile che tu stia 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.
Scoprite come [generare un JWT e i requisiti del payload](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/json-web-tokens-jwts).
{% 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 includendo il JWT nella stringa di query dell’URL.
{% hint style="info" %}
**Esempio:** `https://your-microsite.squatch.app/?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 [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 utilizzi 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 a fondo nel tuo ambiente di staging prima di lanciare il programma.
* Se hai bisogno [supporto](mailto:saasquatch-support@impact.com), includi l’URL del tuo microsito, i dettagli di implementazione e un esempio di payload JWT nella tua richiesta di supporto.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-sso-for-an-impactcom-microsite-via-jwt.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
