Passer au contenu principal

Avant de commencer

  1. Créez une application machine-machine avec les permissions suivantes activées :
  • read:users
  • update:users
  • create:users
  • read:users_app_metadata
  • update:users_app_metadata
  • create:users_app_metadata
  1. Ajoutez une Connexion au coffre-fort en utilisant les informations d’identification de l’application machine-machine (M-M).
Les formulaires pour Actions vous permettent de créer des flux de politiques de confidentialité personnalisés et de stocker le consentement avec l’objet app_metadata .
Dashboard > Actions > Forms > Privacy policy use case
Les sections ci-dessous décrivent comment créer un formulaire de politique de mise à jour en utilisant des nœuds et des flux, ainsi que les étapes pour ajouter votre formulaire à une action post-connexion.

​
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 (tableau de bord Auth0) > Actions > Forms (formulaires).
  2. Sélectionnez Créer un formulaire > Commencer à partir de zéro.
Par défaut, un nouveau formulaire contient un nœud Début, un nœud Étape et un nœud Éran fin.
Dashboard > Forms > Use Cases > Form

​
Configurer le nœud d’étape

Le nœud d’étape est l’interface graphique visible par les utilisateurs. Ajoutez des champs au nœud d’étape pour recueillir la nouvelle valeur d’acceptation de l’accord en suivant ces étapes :
  1. Faites glisser un champ Rich text (Texte enrichi) depuis le Components menu (Menu composants) dans le nœud d’étape.
    • Rich text (Texte enrichi): Saisissez une description des mises à jour de vos politiques de confidentialité.
    • Sélectionnez Save (Enregistrer).
  2. Faites glisser un champ Legal (Légal) dans le nœud d’étape .
    • Identification : Saisissez privacy_policies.
    • Obligatoire : Cochez la case.
    • Légal : Saisissez J’accepte la politique de confidentialité.
    • Sélectionnez Save (Enregistrer).
  3. Sélectionnez Publish (Publier) pour enregistrer.
Dashboard > Actions > Forms > Use case privacy policy step node

​
Configurez le nœud Flow

Ajoutez un node Flow après le nœud d’étape pour mettre à jour les app_metadata et reprendre le flux d’authentification en suivant ces étapes :
  1. Sélectionnez Flow (Flux) en bas de Form Editor (Éditeur de formulaire).
  2. Supprimez le lien existant entre les nœuds Step (Étape) et Ending Screen (Écran de fin).
  3. Sélectionnez le nouveau Flow (Flux) > Click to add a flow (Cliquer pour ajouter un flux) > Create a new flow (Créer un nouveau flux).
    • Entrez Update app_metadata (Mettre à jour app_metadata) dans le champ Name (Nom).
    • Sélectionnez Create (Créer).
    • Sélectionnez Save (Enregistrer).
  4. Liez le nœud Flow (Flux) aux nœuds Step (Étape) et Ending Screen (Écran de fin) comme illustré ci-dessous.
  5. Sélectionnez Publish (Publier) pour enregistrer.
Dashboard > Actions > Forms > Form
Ajoutez une action de mise à jour d’utilisateur Auth0 au flux en suivant ces étapes :
  1. Sélectionnez le fluxUpdate app_metadata (Mise à jour de app_metadata) > Edit flow (Modifier le flux) pour ouvrir l’éditeur de flux dans un nouvel onglet.
  2. Sous l’Action Start (Démarrage), sélectionnez l’icône + pour ajouter une Action Update user (Mise à jour de l’utilisateur) . Remplissez les champs ci-dessous, puis sélectionnez Save (Enregistrer) pour continuer.
    • Connection : dans la liste déroulante, sélectionnez la connexion au coffre-fort de votre application de communication entre machines.
    • User ID (ID utilisateur) : Saisissez {{context.user.user_id}}.
    • Corps : Copiez et collez le code suivant pour mettre à jour les 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 (Enregistrer).
  3. Sélectionnez Publish (Publier) pour enregistrer.
Dashboard > Actions > Forms > User case privacy policy code
Le flux Update app_metadata ajoute une valeur privacy_policies true à l’objet app_metadata et génère également un horodatage à l’aide d’une fonction d’assistance

​
Récupérer le code de rendu du formulaire

Récupérez votre code de rendu du formulaire pour afficher visuellement le formulaire avec une Action post-connexion personnalisée en suivant ces étapes :
  • Dans l’éditeur de formulaire, sélectionnez <> Render (Rendre).
  • Sélectionnez Copy (Copier).
Dashboard > Actions > Forms > Form > Embed

​
Créer une action post-connexion

Créez une action post-connexion pour afficher votre formulaire en suivant ces étapes :
  1. Naviguez vers Auth0 Dashboard > Actions > Flows (Flux) > Login (Connexion).
  2. Sélectionnez l’icône + et choisissez Build from scratch (Construire à partir de zéro):
    • Name (Nom) : Saisissez Render Update Policy Form (Formulaire de politique de mise à jour du rendu).
    • Déclencheur : Sélectionnez Login / Post Login (Connexion / Post-connexion).
    • Runtime (Temps d’exécution) : Sélectionnez la version recommandée.
  3. Sélectionnez Create (Créer).
Pour configurer l’action post-connexion.
  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 d’affichage du formulaire. 
    /**
* @param {Event} event - Details about the user and the context in which they are logging in.
* @param {PostLoginAPI} api - Interface whose methods can be used to change the behavior of the login.
*/
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 affiche le formulaire lorsque la propriété privacy_policies ne se trouve pas dans les métadonnées de l’application.
  4. Sélectionnez Deploy (Déployer).
  5. Glissez et déposez l’Action Render Update Policy Form (Formulaire de mise à jour de la politique de rendu) dans le flux de Login (Connexion) .
    Dashboard > Forms > Use Case > Render update policy form login action
  6. Sélectionnez Apply (Appliquer).

​
Test de mise en œuvre

Testez la mise en œuvre en suivant les étapes ci-dessous :
  1. Se connecter avec un utilisateur existant dont l’attribut privacy_policies de app_metadata n’a pas de valeur.
  2. L’action post-connexion dans le flux de connexion rendra le formulaire et demandera l’approbation.
  3. Sélectionnez Auth0 Dashboard > User Management (Gestion des utilisateurs) > Users (Utilisateurs), localisez l’utilisateur et vérifiez que l’attribut app_metadata``privacy_policies contient une valeur true et un horodatage.