> 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/fr/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).

# Configurer le SSO pour un microsite impact.com via JWT

Le microsite de votre programme Advocate nécessite généralement que vos advocates clients s’inscrivent avec un nom d’utilisateur et un mot de passe avant de pouvoir accéder à leurs liens de partage et aux détails de leurs récompenses. Cependant, comme alternative avancée, vous pouvez à la place authentifier les utilisateurs en générant un [Jeton Web JSON (JWT)](https://en.wikipedia.org/wiki/JSON_Web_Token) côté serveur et en le transmettant au microsite via un paramètre d’URL.

Avec cette méthode, les participants n’auront pas d’identifiants de connexion pour le microsite. Ils y accèdent à la place en se connectant à votre portail client existant, qui les redirige ensuite vers le microsite en utilisant le JWT pour les identifier et afficher leur contenu personnalisé.

#### Avant de commencer

{% hint style="warning" %}
**Important :** Il s’agit d’une implémentation avancée qui contourne le Service d’identité gérée standard pour le microsite et qui nécessite l’aide de votre équipe de développement pour être mise en place.
{% endhint %}

Vous ne devez utiliser cette méthode que si toutes les conditions suivantes s’appliquent :

* Vous souhaitez simuler une expérience d’authentification unique (SSO) en connectant automatiquement les participants au microsite de votre programme.
* Vous pouvez générer des JWT côté serveur.
* Vous ne pouvez pas ou ne souhaitez pas installer le [Balise de suivi universelle (UTT)](/brand/fr/what-would-you-like-to-learn-about/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt.md) sur votre site.

{% stepper %}
{% step %}

#### Étape 1 : Créer un microsite sans identité gérée

Lorsque vous créez votre microsite, vous devrez désactiver le Service d’identité gérée, puis définir toutes vos pages comme accessibles aux utilisateurs « non vérifiés ». La *Tableau de bord* page utilisera le JWT pour authentifier l’utilisateur et charger le microsite.

<details>

<summary>Créer le microsite</summary>

Commencez par modifier les paramètres pour désactiver le *Connexion des participants* option.

1. Dans le menu de navigation de gauche, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FGgFZ4TpepHNOLrRI2yRk%2Fimage.png?alt=media\&token=5b166f3c-f805-4aaf-b2c4-0f7e11697ec0) **\[Engage]** **→ Contenu**.
2. Dans la *Microsite* carte, sélectionnez **Modifier les paramètres**.
3. Vous serez alors redirigé vers vos nouveaux *Paramètres du microsite* page.
4. Dans le *Connexion* section, ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FACIoqj1Ayhx8QzL9aqYB%2Ftoggle-off-solid%20\(1\).svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Désactiver]** **Connexion des participants**.
5. Sélectionnez **Enregistrer les paramètres**.

</details>

<details>

<summary>Configurer la page du tableau de bord</summary>

Ensuite, configurez la *Tableau de bord* page de votre microsite pour qu’elle soit visible aux utilisateurs non vérifiés. Puis, connectez les composants de la page à votre programme de parrainage afin que les bonnes informations s’affichent.

1. Ajustez les paramètres de la *Tableau de bord* page de votre site.
   * Dans le menu de navigation de gauche, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FGgFZ4TpepHNOLrRI2yRk%2Fimage.png?alt=media\&token=5b166f3c-f805-4aaf-b2c4-0f7e11697ec0) **\[Engage]** **→ Contenu** → **Contenu de configuration** ou **Modifier le contenu**.
   * Dans la *Microsite* onglet, sélectionnez **Tableau de bord** dans le *Mise en page connectée* section.
   * Sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNVJihd9nYKCiCEg5tI6i%2F2a92939e8e78dd7e0c0416b1a250d5ef1d7ab0dec966fb5ed320ca62acfc06c5.svg?alt=media\&token=7cab8ce5-a26b-4057-a822-0746130d9117) **\[Menu] → Paramètres**.
   * Dans la *Utilisateurs autorisés* liste déroulante, sélectionnez **Non vérifié**.
2. Ajoutez l’ID de votre programme aux composants de la *Tableau de bord*.
   * Statistiques utilisateur — Vous devez ajouter l’ID à chaque statistique utilisateur individuelle que vous choisissez d’afficher.
   * Lien de partage
   * Code de parrainage
   * Boutons de réseaux sociaux — Vous devez ajouter l’ID à chaque bouton de partage sur les réseaux sociaux individuel que vous choisissez d’inclure.
3. Dans le coin supérieur droit, sélectionnez **Enregistrer**.

   <div data-with-frame="true"><figure><img src="https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FILGfObvnj8KJZ7tCnv1N%2FScreenshot%202026-05-18%20at%2008.35.52.png?alt=media&amp;token=e25b48a9-0ec3-4410-9dc0-feb609d46d34" alt="" width="563"><figcaption></figcaption></figure></div>

Pour obtenir de l’aide sur l’utilisation de l’éditeur afin de trouver et d’ajuster les paramètres de votre page et de vos composants, consultez [Explication de l’éditeur de microsite](/brand/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsite-editor-explained.md) et [Personnaliser les mises en page et les pages du microsite](/brand/fr/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).

</details>

<details>

<summary>Supprimer les pages inutiles</summary>

Supprimez la mise en page et les pages que votre microsite n’utilisera pas.

1. Placez le curseur sur la page ou la mise en page.
2. Sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Plus]** **→ Supprimer**.
3. Supprimez le *Mise en page connectée*.
4. Supprimez les pages suivantes :
   * Modifier le profil
   * Vérification de l’e-mail
   * Mot de passe oublié
   * Connexion
   * Déconnexion
   * Inscription
   * Réinitialiser le mot de passe
   * Vérifier l’e-mail

</details>
{% endstep %}

{% step %}

#### Étape 2 : Générer le JWT

La structure du JWT suit les exigences standard d’Advocate pour l’authentification des utilisateurs. Si vous avez déjà intégré Advocate auparavant, il est probable que vous génériez déjà des jetons similaires pour UTT.

Vous devez générer le JWT de manière sécurisée sur votre serveur ou sur tout système backend de confiance — jamais dans le navigateur.

Découvrez comment [générer un JWT et les exigences de charge utile](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/json-web-tokens-jwts).
{% endstep %}

{% step %}

#### Étape 3 : Ajouter le JWT à l’URL du microsite

Une fois que l’utilisateur est connecté à votre plateforme, redirigez-le vers le microsite en incluant le JWT dans la chaîne de requête de l’URL.

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

Vous pouvez soit ouvrir le microsite dans un nouvel onglet de navigateur, soit l’intégrer dans votre application à l’aide d’un iframe. Si vous décidez d’intégrer le microsite, assurez-vous de gérer [le partage des ressources entre origines croisées (CORS)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) et les restrictions du navigateur de manière appropriée.
{% endstep %}
{% endstepper %}

#### Notes

* Si vous utilisez cette méthode d’authentification, les utilisateurs n’auront pas d’identifiants de connexion pour le microsite.
* L’accès basé sur le JWT doit être strictement contrôlé. Ne l’exposez pas et ne le manipulez pas dans du JavaScript côté client.
* Il s’agit d’une approche non standard — testez-la minutieusement dans votre environnement de préproduction avant de déployer votre programme.
* Si vous avez besoin [l’assistance](mailto:saasquatch-support@impact.com), incluez l’URL de votre microsite, les détails de l’implémentation et un exemple de charge utile JWT dans votre demande d’assistance.


---

# 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/fr/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=<question>&goal=<user_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.
