Configurer le SSO pour un microsite impact.com via JWT

Le microsite de votre programme Advocate nécessite généralement que vos ambassadeurs 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 plutôt authentifier les utilisateurs en générant un jeton Web JSON (JWT) 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. À la place, ils accèdent 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

Important : Il s’agit d’une implémentation avancée qui contourne le service standard d’identité gérée pour le microsite et nécessite l’aide de votre équipe de développement pour être configurée.

Vous ne devriez utiliser cette méthode que si toutes les conditions suivantes sont remplies :

• Vous souhaitez simuler une expérience d’authentification unique (SSO) en connectant automatiquement les participants à votre microsite de programme.

• Vous pouvez générer des JWT côté serveur.

• Vous ne pouvez pas ou ne souhaitez pas installer le Universal Tracking Tag (UTT) sur votre site.

1

É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.

Créer le microsite

Tout d’abord, ajustez les paramètres pour désactiver le Connexion participant .

1. Dans le menu de navigation de gauche, sélectionnez [Engage] → Contenu.

2. Dans la Microsite , sélectionnez Modifier les paramètres.

3. Vous serez ensuite redirigé vers vos nouveaux Paramètres du microsite .

4. Dans le Connexion section, [Désactiver] Connexion participant.

5. Sélectionnez Enregistrer les paramètres.

Configurer la page du tableau de bord

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

1. Ajustez les paramètres de votre Tableau de bord page.

   • Dans le menu de navigation de gauche, sélectionnez [Engage] → Contenu → Contenu de la configuration ou Modifier le contenu.

   • Depuis le Microsite sélectionnez Tableau de bord dans le mise en page Connecté section.

   • Sélectionnez [Menu] → Paramètres.

   • Depuis le 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 individuel de partage sur les réseaux sociaux que vous choisissez d’inclure.

3. Dans le coin supérieur droit, sélectionnez Enregistrer.

   

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 et Personnaliser les mises en page et les pages du microsite.

Supprimer les pages inutiles

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

1. Passez le curseur de votre souris sur la page ou la mise en page.

2. Sélectionnez [Plus] → Supprimer.

3. Supprimer le mise en page Connecté.

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

2

É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, 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 tout système backend de confiance — jamais dans le navigateur.

Découvrez comment générer un JWT et les exigences de la charge utile.

3

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

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

Exemple : https://your-microsite.squatch.app/?jwt=<YOUR_GENERATED_JWT>

Vous pouvez soit ouvrir le microsite dans un nouvel onglet du 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 de ressources entre origines (CORS) et les restrictions du navigateur de manière appropriée.

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 de l’assistance, 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.