> 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 de recommandation demande généralement à vos ambassadeurs clients de s’inscrire 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. Toutefois, comme solution de remplacement avancée, vous pouvez plutôt authentifier les utilisateurs en générant un [JSON Web Token (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éderont plutôt en se connectant à votre portail client existant, qui les redirigera ensuite vers le microsite en utilisant le JWT pour les identifier et afficher leur contenu personnalisé.

#### Avant de commencer

{% hint style="warning" %}
**Important :** Cette mise en œuvre avancée contourne le service Managed Identity standard du microsite et nécessite l’aide de votre équipe de développement pour sa configuration.
{% endhint %}

N’utilisez cette méthode que si toutes les conditions suivantes sont réunies :

* 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 la [balise de suivi universelle (UTT)](https://help.impact.com/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

Lors de la création de votre microsite, vous devrez désactiver le service Managed Identity, puis rendre toutes vos pages accessibles aux utilisateurs « non vérifiés ». La page *Tableau de bord* 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 l’option *Connexion des participants* .

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. Sur la carte *Microsite* , sélectionnez **Modifier les paramètres**.
3. Vous serez ensuite redirigé vers la nouvelle page *Paramètres du microsite* .
4. Dans la section *Connexion* , ![](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 Tableau de bord</summary>

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

1. Modifiez les paramètres de la page *Tableau de bord* 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** → **Configurer le contenu** ou **Modifier le contenu**.
   * Dans l’onglet *Microsite* , sélectionnez **Tableau de bord** dans la section *Mise en page après connexion* .
   * 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] → Settings**.
   * Dans la liste déroulante *Utilisateurs autorisés* , sélectionnez **Non vérifié**.
2. Ajoutez l’ID de votre programme aux composants du *tableau de bord*.
   * Statistiques utilisateur — Vous devez ajouter l’ID à chaque statistique utilisateur 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 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 savoir comment utiliser l’éditeur afin de trouver et de modifier les paramètres de vos pages et composants, consultez [Présentation de l’éditeur Microsite](https://help.impact.com/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 Microsite](https://help.impact.com/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) **\[More]** **→ Delete**.
3. Supprimez la *mise en page après connexion*.
4. Supprimez les pages suivantes :
   * Modifier le profil
   * Vérification de l’adresse e-mail
   * Mot de passe oublié
   * Connexion
   * Déconnexion
   * Inscription
   * Réinitialiser le mot de passe
   * Vérifier l’adresse e-mail

</details>
{% endstep %}

{% step %}

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

La structure du JWT respecte les exigences standard d’Advocate pour l’authentification des utilisateurs. Si vous avez déjà intégré Advocate, vous générez probablement 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 un système backend de confiance — jamais dans le navigateur.

Découvrez comment [générer un JWT et connaître les exigences relatives à sa 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 l’utilisateur 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 ouvrir le microsite dans un nouvel onglet du navigateur ou l’intégrer à votre application à l’aide d’une iframe. Si vous choisissez d’intégrer le microsite, veillez à gérer correctement [le partage des ressources entre origines différentes (CORS)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) et les restrictions du navigateur.
{% endstep %}
{% endstepper %}

#### Remarques

* Avec cette méthode d’authentification, les utilisateurs n’auront pas d’identifiants de connexion pour le microsite.
* L’accès basé sur JWT doit être strictement contrôlé. Ne l’exposez pas et ne le manipulez pas dans du code JavaScript côté client.
* Cette approche n’est pas standard : testez-la rigoureusement dans votre environnement de préproduction avant de déployer votre programme.
* Si vous avez besoin d’ [assistance](mailto:saasquatch-support@impact.com), indiquez 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.
