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

> Apprenez à tester et à déboguer les Actions Auth0

# Tester les Actions

Selon l’état d’avancement de votre implémentation, plusieurs options s’offrent à vous pour tester et déboguer les Actions Auth0.

Nous vous recommandons de tester les Actions individuellement à partir du <Tooltip tip="Auth0 Dashboard : le principal produit d’Auth0 pour configurer vos services." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=Auth0+Dashboard">Auth0 Dashboard</Tooltip> au fur et à mesure que vous les implémentez. Une fois que vous êtes prêt, vérifiez que le flux de bout en bout fonctionne comme prévu en utilisant les journaux du locataire dans Auth0 Dashboard.

<div id="test-individual-actions">
  ## Tester des Actions individuelles
</div>

Vous pouvez tester des Actions individuelles à l’aide de l’éditeur de code des Actions. La fonctionnalité de test de l’éditeur simule un appel à l’Action à l’aide d’une charge utile d’exemple, selon le flux auquel l’Action est associée. Pour tester une Action individuelle :

1. Accédez à [Auth0 Dashboard > Actions](https://manage.auth0.com/#/actions), puis choisissez le flux et l’Action que vous souhaitez modifier.
2. Repérez l’éditeur de code des Actions, puis sélectionnez **Test** (l’icône de lecture) dans sa barre latérale. Modifiez la charge utile dans la barre latérale **Test** pour analyser le résultat de différentes charges utiles.
3. Sélectionnez **Run**.

Les résultats du test montrent les étapes exécutées par l’Action, la sortie de la console, les erreurs survenues et des statistiques utiles sur l’exécution de l’Action.

<Frame>
  <img src="https://mintcdn.com/translations/c0RQ9V0YAcT0-8l5/docs/images/cdy7uua7fh8z/7I4CRM8SmRFiibjuk55L86/794042f525cddd55a8005cc646b3c9c2/test-action-code-editor.png?fit=max&auto=format&n=c0RQ9V0YAcT0-8l5&q=85&s=4127ea180888640c25044fc5c03f83c1" alt="Capture d’écran du module de test dans l’éditeur de code des Actions" width="894" height="473" data-path="docs/images/cdy7uua7fh8z/7I4CRM8SmRFiibjuk55L86/794042f525cddd55a8005cc646b3c9c2/test-action-code-editor.png" />
</Frame>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Vous pouvez aussi tester une Action à l’aide du point de terminaison [**Test an Action**](https://auth0.com/docs/api/management/v2#!/Actions/post_test_action) de la Management API, en fournissant une charge utile correspondant au flux auquel l’Action est associée. Pour obtenir une charge utile d’exemple, testez l’Action à l’aide de la fonctionnalité **Test** de l’éditeur de code des Actions.
</Callout>

<div id="debug-deployed-actions">
  ## Déboguer les Actions déployées
</div>

Maintenant que vous avez testé votre Action, il est temps de la déployer et d’en observer l’exécution. Si vous avez déjà déployé votre Action et l’avez ajoutée à un flux (pour savoir comment associer des Actions à des flux, consultez la section « Associer l’Action à un flux » dans [Écrire votre première Action](/fr-CA/docs/customize/actions/write-your-first-action)), vous pouvez déboguer votre Action en production en quelques étapes.

<div id="verify-end-to-end-login-flow">
  ### Vérifier le flux de connexion de bout en bout
</div>

Pour une Action `post-login`, vous pouvez vérifier le flux de connexion de bout en bout en effectuant une tentative de connexion dans votre locataire :

1. Accédez à [Auth0 Dashboard > Authentication > Authentication Profile](https://manage.auth0.com/#/authentication-profiles), puis sélectionnez **Try**. Une fenêtre contenant un exemple de connexion s’ouvrira.
2. Suivez le flux de connexion jusqu’au bout. Le flux de connexion exécutera toutes les Actions configurées.

Une fois l’opération terminée, vous serez redirigé vers une page qui affiche soit les attributs du profil utilisateur que vos applications recevront, soit un message d’erreur expliquant ce qui s’est produit.

<div id="analyze-tenant-logs">
  ### Analyser les journaux du locataire
</div>

Chaque fois qu’un déclencheur s’exécute et qu’une Action est associée à son flux, vos [journaux du locataire](/fr-CA/docs/deploy-monitor/logs/view-log-events) comprennent des détails sur l’exécution de l’Action.

Dans la liste des journaux du locataire, vous pouvez voir les journaux associés aux Actions et choisir de les afficher. Dans l’exemple ci-dessous, le type de journal `Success Login` est associé à une Action sur le déclencheur `post-login` de ce locataire.

<Frame>
  <img src="https://mintcdn.com/translations/pvjQqAy3EB2TK6NP/docs/images/cdy7uua7fh8z/4hIo2YJ8fr2tfMEWhaLyn4/7935eec2f5a59c0191cbf24eaccf044d/2025-01-31_14-30-57.png?fit=max&auto=format&n=pvjQqAy3EB2TK6NP&q=85&s=4d9043d4c0c4bf373ca0941cbca3197f" alt="Capture d’écran de la liste des journaux du locataire dans Auth0 Dashboard, montrant des journaux associés à l’exécution d’Actions." width="1529" height="758" data-path="docs/images/cdy7uua7fh8z/4hIo2YJ8fr2tfMEWhaLyn4/7935eec2f5a59c0191cbf24eaccf044d/2025-01-31_14-30-57.png" />
</Frame>

Voici quelques exemples de types de journaux associés aux Actions :

| Nom                     | Déclencheur(s)                                                                                                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Success Login           | [post-login](/fr-CA/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger)                            |
| Failed Login            | [post-login](/fr-CA/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger)                            |
| Success Exchange        | [post-login](/fr-CA/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger)                            |
| Failed Exchange         | [post-login](/fr-CA/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger)                            |
| Success Change Password | [post-change-password](/fr-CA/docs/customize/actions/explore-triggers/password-reset-triggers/post-change-password-trigger)     |
| Failed Change Password  | [post-change-password](/fr-CA/docs/customize/actions/explore-triggers/password-reset-triggers/post-change-password-trigger)     |
| Successful Signup       | [pre-user-registration](/fr-CA/docs/customize/actions/explore-triggers/signup-and-login-triggers/pre-user-registration-trigger) |
| Failed Signup           | [pre-user-registration](/fr-CA/docs/customize/actions/explore-triggers/signup-and-login-triggers/pre-user-registration-trigger) |
| Success Exchange        | [credentials-exchange](/fr-CA/docs/customize/actions/explore-triggers/machine-to-machine-trigger)                               |
| Failed Exchange         | [credentials-exchange](/fr-CA/docs/customize/actions/explore-triggers/machine-to-machine-trigger)                               |

Pour afficher des renseignements détaillés sur l’exécution d’une Action, sélectionnez le journal associé à une exécution d’Action, puis la vue **Action Details**. Dans **Action Details**, vous pouvez consulter les statistiques d’exécution, la sortie de la console et toute erreur qui a pu se produire.

<Frame>
  <img src="https://mintcdn.com/translations/eVsQcTnbClN-oB7d/docs/images/cdy7uua7fh8z/1WrsQvjZxI2WRMrtltandy/0bc92038a5bc7b6344a95ef271eff299/actions-log-detail.png?fit=max&auto=format&n=eVsQcTnbClN-oB7d&q=85&s=f5f466125ec65157dd222594d8ce53b0" alt="Capture d’écran d’un journal individuel associé à des tests d’Actions." width="1042" height="794" data-path="docs/images/cdy7uua7fh8z/1WrsQvjZxI2WRMrtltandy/0bc92038a5bc7b6344a95ef271eff299/actions-log-detail.png" />
</Frame>

<div id="unit-test-actions">
  ## Tester les Actions avec des tests unitaires
</div>

​Vous pouvez tester vos Actions Auth0 de façon unitaire en simulant les objets event et api transmis à votre fonction Action. Vos Actions peuvent être stockées dans un système de contrôle de version ou dans un répertoire local, et vous pouvez utiliser un outil comme Jest pour les tester automatiquement. Dans l’exemple suivant, nous utilisons le déclencheur [Login / Post Login](/fr-CA/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger) et [Jest](https://jestjs.io/) pour effectuer la simulation et les tests.

**Code de l’Action :**

```javascript lines theme={null}
// action.js

exports.onExecutePostLogin = async (event, api) => {
  const namespace = "https://my-app.example.com";
  if (event.authorization) {
    api.idToken.setCustomClaim(`${namespace}/favorite_color`, "pink");
  }
};
```

**Code du fichier de test :**

```javascript lines theme={null}
// action.spec.js

const { onExecutePostLogin } = require("./action.js");
test("sets favorite_color ID token claim to pink", async () => {
  const namespace = "https://my-app.example.com";
  const mockFunction = jest.fn();
  const mockApi = { idToken: { setCustomClaim: mockFunction } };
  const mockEvent = {authorization: {}};

  await onExecutePostLogin(mockEvent, mockApi);
  expect(mockFunction).toBeCalledWith(
    `${namespace}/favorite_color`,
    "pink"
  );
});
```

<div id="best-practices">
  ## Bonnes pratiques
</div>

Lorsque vous créez des Actions dans Auth0, [nous vous recommandons de créer un locataire Auth0 distinct pour chaque environnement](/fr-CA/docs/get-started/auth0-overview/create-tenants/set-up-multiple-environments). Vous pourrez ainsi isoler votre base d’utilisateurs de production de vos autres environnements et configurer des administrateurs différents pour chacun d’eux (par exemple, les ingénieurs pourraient ne pas avoir accès à la configuration de production).

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Si vous souhaitez gérer, tester et déployer entièrement vos Actions au moyen d’une CLI ou d’un pipeline CI/CD, vous pouvez utiliser le [Deploy CLI Tool](/fr-CA/docs/deploy-monitor/deploy-cli-tool).
</Callout>
