Cas d’utilisation : Configurer un formulaire de mise à jour de politique à l’aide de Forms

Découvrez comment configurer un formulaire de mise à jour de politique à l’aide de Forms for Actions afin que les utilisateurs puissent examiner et accepter de nouvelles conditions d’utilisation ou des mises à jour de consentement.

Avant de commencer

1. Créez une application Machine-to-Machine avec les scopes suivants activés :

• read:users
• update:users
• create:users
• read:users_app_metadata
• update:users_app_metadata
• create:users_app_metadata

2. Ajoutez une connexion Vault à l’aide des identifiants de l’application M2M.

Forms for Actions vous permet de créer des flux personnalisés liés aux politiques de confidentialité et d’enregistrer le consentement dans l’objet app_metadata.

Les sections ci-dessous expliquent comment créer un formulaire de mise à jour de politique à l’aide de nœuds et de flux, ainsi que les étapes pour ajouter votre formulaire à une Action Post Login.

​

Créer un formulaire à partir de zéro

Suivez ces étapes pour créer un formulaire afin de recueillir des informations :

1. Ouvrez l’éditeur de formulaires en sélectionnant Auth0 Dashboard > Actions > Forms.
2. Sélectionnez Create Form > Start from scratch.

Par défaut, un nouveau formulaire contient un nœud Start, un nœud Step et un nœud Ending screen.

​

Configurer le nœud Step

Le nœud Step est l’interface graphique visible par les utilisateurs. Ajoutez des champs au nœud Step pour recueillir la nouvelle valeur d’acceptation en suivant ces étapes :

1. Faites glisser un champ Texte enrichi du menu Composants vers le nœud Step.

   • Texte enrichi : Saisissez une description des mises à jour apportées à votre politique de confidentialité.
   • Sélectionnez Enregistrer.

2. Faites glisser un champ Juridique vers le nœud Step.

   • ID : Saisissez privacy_policies.
   • Obligatoire : Cochez la case.
   • Juridique : Saisissez J’accepte la politique de confidentialité.
   • Sélectionnez Enregistrer.

3. Sélectionnez Publier pour enregistrer.

​

Configurer le nœud Flow

Ajoutez un nœud Flow après le nœud Step pour mettre à jour app_metadata et reprendre le flux d’authentification en suivant les étapes ci-dessous :

1. Sélectionnez Flow au bas de l’éditeur de formulaires.

2. Supprimez le lien existant entre les nœuds Step et Ending Screen.

3. Sélectionnez le nouveau Flow > Click to add a flow > Create a new flow.

   • Entrez Update app_metadata dans le champ Name.
   • Sélectionnez Create.
   • Sélectionnez Save.

4. Reliez le nœud Flow aux nœuds Step et Ending Screen, comme illustré ci-dessous.

5. Sélectionnez Publish pour enregistrer.

Ajoutez une action Auth0 Update user au flux en suivant les étapes ci-dessous :

1. Sélectionnez Flow Update app_metadata > Edit flow pour ouvrir l’éditeur de flux dans un nouvel onglet.

2. Sous le StartAction, sélectionnez l’icône + pour ajouter une action Update user. Remplissez les champs ci-dessous, puis sélectionnez Save pour continuer.

   • Connection : Dans la liste déroulante, sélectionnez la connexion Vault de votre application M2M.

   • User ID : Entrez {{context.user.user_id}}.

   • Body : Copiez-collez le code suivant pour mettre à jour app_metadata avec les propriétés privacy_policies et privacy_policies_timestamp.

     {
       "app_metadata": {
         "privacy_policies": true,
         "privacy_policies_timestamp": "{{ functions.toTimestamp() }}"
       }
     }
     

   • Sélectionnez Save.

3. Sélectionnez Publish pour enregistrer.

Le flux Update app_metadata ajoute la valeur privacy_policies true à l’objet app_metadata et génère aussi un horodatage à l’aide d’une fonction utilitaire.

​

Récupérer le code de rendu du formulaire

Récupérez le code de rendu de votre formulaire afin d’afficher le formulaire au moyen d’une Action Post Login personnalisée en suivant ces étapes :

• Dans l’éditeur de formulaires, sélectionnez <> Render.
• Sélectionnez Copy.

​

Créer une Action Post Login

Créez une action post-login pour afficher votre formulaire en suivant les étapes ci-dessous :

1. Accédez à Auth0 Dashboard > Actions > Flows > Login.

2. Sélectionnez l’icône +, puis Build from scratch :

   • Nom : Entrez Render Update Policy Form.
   • Déclencheur : Sélectionnez Login / Post Login.
   • Runtime : Sélectionnez la version recommandée.

3. Sélectionnez Créer.

Pour configurer l’action post-login :

1. Supprimez le code existant dans l’éditeur de code.

2. Collez le code de rendu du formulaire dans l’éditeur de code.

3. Modifiez le code pour définir la logique conditionnelle qui affichera le formulaire.

   /**
   * @param {Event} event - Détails sur l’utilisateur et le contexte dans lequel il se connecte.
   * @param {PostLoginAPI} api - Interface dont les méthodes peuvent être utilisées pour modifier le comportement de la connexion.
   */
   exports.onExecutePostLogin = async (event, api) => {
     const FORM_ID = 'REPLACE_WITH_YOUR_FORM_ID';
   
     if (event.user.app_metadata.privacy_policies !== true) {
       api.prompt.render(FORM_ID);
     }
   }
   
   exports.onContinuePostLogin = async (event, api) => { }
   
   L’exemple de code ci-dessus affichera le formulaire si la propriété privacy_policies est absente de l’objet app metadata de l’utilisateur.

4. Sélectionnez Déployer.

5. Glissez-déposez l’Action Render Update Policy Form dans le flux de Login.

   

6. Sélectionnez Appliquer.

​

Test de la mise en œuvre

Testez la mise en œuvre en suivant ces étapes :

1. Connectez-vous avec un utilisateur existant dont l’attribut app_metadata privacy_policies n’a aucune valeur.
2. L’Action post-login dans le flux de Login affichera le formulaire et demandera l’acceptation.
3. Sélectionnez Auth0 Dashboard > User Management > Users, repérez l’utilisateur et vérifiez que l’attribut app_metadata privacy_policies contient la valeur true ainsi qu’un horodatage.