> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-fix-ss-log-app-metadata-user-metadata-clarification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Cas d’utilisation : Configurer un formulaire de politique de mise à jour à l’aide des formulaires.
> Configurer un formulaire de politique de mise à jour à l’aide des formulaires pour Actions.
1. Créez une [application machine-machine](https://auth0.com/docs/get-started/auth0-overview/create-applications/machine-to-machine-apps) avec les permissions suivantes activées :
* `read:users`
* `update:users`
* `create:users`
* `read:users_app_metadata`
* `update:users_app_metadata`
* `create:users_app_metadata`
2. Ajoutez une [Connexion au coffre-fort](/docs/fr-ca/customize/forms/vault) 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` .
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](/docs/fr-ca/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger).
## 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.
### Configurer le nœud d’étape
Le nœud d’étape est l’interface graphique visible par les utilisateurs. Ajoutez des [champs](/docs/fr-ca/customize/forms/nodes-and-components) 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.
### 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.
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.
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](/docs/fr-ca/customize/forms/variables)
## 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)**.
## 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.
```javascript lines theme={null}
/**
* @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)** .
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.