Configurer le SSO pour un microsite impact.com via JWT

Le microsite de votre programme Advocate nécessite généralement que vos défenseurs 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 des récompenses. Cependant, en alternative avancée, vous pouvez authentifier les utilisateurs en générant un JSON Web Token (JWT) côté serveur et en le passant au microsite via un paramètre d'URL.

Avec cette méthode, les participants n'auront pas de identifiants de connexion pour le microsite. À la place, ils accèdent au microsite 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 : Ceci est une implémentation avancée qui contourne le service d'identité géré standard pour le microsite et nécessite le soutien de votre équipe de développement pour la mise en place.

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

• Vous souhaitez simuler une expérience de connexion 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 Tag de Suivi Universel (UTT) sur votre site.

1

Étape 1 : Créez 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 ». Le Tableau de bord la 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 des participants option.

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 le Connexion section, [Désactiver] Connexion des participants.

5. Sélectionner Enregistrer les paramètres.

Configurer la page du tableau de bord

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

1. Ajustez le Tableau de bord paramètres de la page.

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

   • Depuis le Microsite onglet, sélectionnez Tableau de bord dans le Disposition connecté(e) section.

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

   • Depuis le Utilisateurs autorisés liste déroulante, sélectionnez Non vérifié.

2. Ajoutez votre ID de programme aux composants sur le 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 que vous choisissez d'inclure.

3. En haut à droite, 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, référez-vous à Explication de l'éditeur de microsite et Personnaliser les mises en page et 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électionner [Plus] → Supprimer.

3. Supprimer le Disposition connecté(e).

4. Supprimez les pages suivantes :

   • Modifier le profil

   • Vérification de l'e-mail

   • Mot de passe oublié

   • Connexion

   • Se déconnecter

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

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

Remarques

• 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 soigneusement dans votre environnement de préproduction avant de déployer votre programme.

• Si vous avez besoin d'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.