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 à la place authentifier les utilisateurs en générant un JSON Web Token (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 y accèdent en se connectant à votre portail client existant, qui les redirige ensuite vers le microsite à l’aide du 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 d’identité gérée standard pour le microsite et nécessite l’aide de votre équipe de développement pour la configurer.

Vous ne devriez 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 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, modifiez les paramètres pour désactiver le Connexion des participants .

1. Dans le menu de navigation de gauche, sélectionnez [Engage] → Contenu.
2. Sur le Microsite carte, sélectionnez Modifier les paramètres.
3. Vous serez alors redirigé vers votre nouveau Paramètres du microsite page.
4. Dans l’ Connexion section, [Désactiver] Connexion des participants.
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 la page de votre site. Tableau de bord page.

   • Dans le menu de navigation de gauche, sélectionnez [Engage] → Contenu → Configurer le contenu ou Modifier le contenu.
   • Dans le Microsite onglet, sélectionnez Tableau de bord dans la Mise en page connecté section.
   • Sélectionnez [Menu] → Paramètres.
   • Dans le Utilisateurs autorisés liste déroulante, sélectionnez Non vérifié.
2. Ajoutez l’identifiant de votre programme aux composants sur la Tableau de bord.

   • Statistiques utilisateur — Vous devez ajouter l’identifiant à chaque statistique utilisateur individuelle que vous choisissez d’afficher.
   • Lien de partage
   • Code de parrainage
   • Boutons de réseaux sociaux — Vous devez ajouter l’identifiant à 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 pour trouver et ajuster les paramètres de votre page et de vos composants, consultez Explication de l’éditeur de microsites 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. Placez le curseur sur la page ou la mise en page.
2. Sélectionnez [Plus] → Supprimer.
3. Supprimez 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
   • S’inscrire
   • 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 back-end de confiance — jamais dans le navigateur.

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

3

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

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 croisées (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 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 le support, 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.