> ## Documentation Index
> Fetch the complete documentation index at: https://auth0-fix-docs-5525.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cas d’utilisation : configurer des étapes d’inscription supplémentaire à l’aide de formulaires

> Apprenez à configurer des étapes d’inscription supplémentaires à l’aide des formulaires d’action.

<Card title="Avant de commencer">
  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).
</Card>

Les formulaires d’actions vous permettent de créer des étapes d’inscription supplémentaires pour vos flux d’inscription et de connexion et les rendre obligatoires pour l’accès des utilisateurs à votre application.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-fix-docs-5525/docs/images/fr-ca/cdy7uua7fh8z/ZOQNi6SrEC9OREcBbdiJ3/d79f84fb61acd5473bdf932527e26d58/custom-signup-form.png" alt="Dashboard > Actions > Forms > Use Case Custom Signup Form" />
</Frame>

Les sections suivantes expliquent comment créer des formulaires d’étapes d’inscription supplémentaires en utilisant les nœuds et les 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.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-fix-docs-5525/docs/images/fr-ca/cdy7uua7fh8z/2TZ9jSjgEcARFpULI6hz4R/a4319a1bd482f2ee5cc23100fdb2f42c/New-form-Forms-for-action-use-case.png" alt="Dashboard > Forms > Use Cases > Form" />
</Frame>

### Configurer le nœud d’étape

Le nœud d’étape est l’interface graphique présentée aux utilisateurs. Ajoutez des [champs](/docs/fr-ca/customize/forms/nodes-and-components) au nœud d’étape pour collecter le nom complet de l’utilisateur et les valeurs d’intitulé de son poste en procédant comme suit :

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 un message personnalisé.
   * Sélectionnez **Save (Enregistrer)**.
2. Faites glisser un champ **Text (Texte)** dans le nœud **Step (Étape)**.

   * **ID** : saisissez `full_name`.
   * **Label (Étiquette)** : saisissez `Full name`.
   * **Label (Étiquette)** : activez la case à cocher.
   * **Required (Requis)** : activez la case à cocher.
   * Sélectionnez **Save (Enregistrer)**.
3. Faites glisser un champ **Text (Texte)** dans le nœud **Step (Étape)**.

   * **ID** : saisissez `job_title`.
   * **Label (Étiquette)** : saisissez `Job title`.
   * **Label (Étiquette)** : activez la case à cocher.
   * **Required (Requis)** : activez la case à cocher.
   * Sélectionnez **Save (Enregistrer)**.
4. Sélectionnez **Publish (Publier)** pour enregistrer.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-fix-docs-5525/docs/images/fr-ca/cdy7uua7fh8z/6Kcn0ai9fsVsqHwZpTGByG/37cbf4ffee63a7010926b15f06dd20ac/custom-signup-step-node.png" alt="Dashboard > Actions > Forms > Use Case Custom Signup Steps Step node" />
</Frame>

### Configurer le nœud Flow (Flux)

Ajoutez un nœud **Flow (Flux)** après le nœud **Step (Étape)** pour mettre à jour les `user_metadata` et reprenez le flux d’authentification en procédant comme suit :

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).**

   * Saisissez `Update user_metadata (Mettre à jour user_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.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-fix-docs-5525/docs/images/fr-ca/cdy7uua7fh8z/4nTdYdA2Hu5vK65smkdvJg/db3294ebc25a7c2636be96362a3ea56e/custom-signup-step-flow.png" alt="Dashboard > Actions > Forms > Use Case Custom Signup Step Update User metadata flow" />
</Frame>

Ajoutez une action de mise à jour d’utilisateur Auth0 au flux en suivant ces étapes :

1. Sélectionnez le **fluxUpdate user\_metadata (Mise à jour user\_metadata)** > **flux Edit (Modifier)** 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 (Mettre à jour 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}}`.

   * **Body (Corps)** : copiez et collez le code suivant pour mettre à jour les métadonnées utilisateur avec les propriétés `full_name` et `job_title`.

     ```
     {
       "user_metadata": {
         "full_name": "{{fields.full_name}}",
         "job_title": "{{fields.job_title}}"
       }
     }
     ```

   * Sélectionnez **Save (Enregistrer)**.
3. Sélectionnez Publish (Publier) pour enregistrer.

## Récupérer votre code de rendu

Récupérez votre code de rendu pour afficher visuellement le formulaire avec une action de post-connexion personnalisée en suivant ces étapes :

* Dans l’éditeur de formulaires, sélectionnez **\<> Render (Rendre)**.
* Sélectionnez **Copy (Copier)**.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-fix-docs-5525/docs/images/fr-ca/cdy7uua7fh8z/2EIUzc539sq9lwoTKbjoJv/496a864c0fc44a782c9cadca119dbfb0/embed.png" alt="Dashboard > Actions > Forms > Form > Embed" />
</Frame>

## 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 **+**, puis **Build from scratch (Créer de A à Z)** :

   * **Name (Nom)** : saisissez `Render Additional Signup Form`.
   * **Trigger (Déclencheur)** : sélectionnez `Login / Post Login`.
   * **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.user_metadata.full_name &&
       !event.user.user_metadata.job_title
     ) {
       api.prompt.render(FORM_ID);
     }
   }

   exports.onContinuePostLogin = async (event, api) => { }
   ```

   <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
     L’exemple de code ci-dessus affiche le formulaire lorsque les propriétés full\_name et job\_title des métadonnées de l’utilisateur sont manquantes.
   </Callout>

4. Sélectionnez **Deploy (Déployer)**.

5. Glissez-déposez l’action **Render Additional Signup Form (Rendre le formulaire d’inscription supplémentaire)** dans le flux **Login (Connexion)**.

   <Frame>
     <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-fix-docs-5525/docs/images/fr-ca/cdy7uua7fh8z/1WBOicIOcH98hKj6Lq9HF2/4951e30a0cc08c7c5daa0116eaa17e11/Screenshot_2024-03-01_at_15.48.00.png" alt="Dashboard > Forms > Use Cases Custom Signup Steps Login Flow" />
   </Frame>

6. Sélectionnez **Apply (Appliquer)**.

### Tester la mise en œuvre

Testez la mise en œuvre en procédant comme suit :

* Inscrivez-vous à une application en tant que nouvel utilisateur.
* L’action post-connexion dans le flux de connexion affichera le formulaire et demandera des informations.
* Sélectionnez **Auth0 Dashboard > User Management (Gestion des utilisateurs)> Users (Utilisateurs)**, localisez le nouvel utilisateur et vérifiez que ses attributs `full_name` et `job_title` contiennent les informations de l’étape d’inscription supplémentaire.
