Tester les actions

Selon l’état d’avancement de votre implémentation, vous disposez de plusieurs options différentes pour tester et déboguer Auth0 Actions.

Nous vous recommandons de tester les différentes actions du Auth0 Dashboard au fur et à mesure de leur mise en œuvre. Une fois que vous êtes prêt, vous devez vérifier que le flux de bout en bout fonctionne comme prévu en utilisant les journaux des locataires dans l’Auth0 Dashboard.

Vous pouvez tester des actions individuelles à l’aide de l’éditeur de code d’actions. La capacité de test de l’éditeur simule une requête à l’action à l’aide d’un échantillon de données utiles basé sur le flux auquel l’action est associée. Pour tester une action individuelle :

1. Naviguez vers Auth0 Dashboard > Actions, et choisissez le Flux et l’Action que vous souhaitez modifier.

2. Repérez l’Éditeur de code d’Actions et sélectionnez Test (l’icône de lecture) dans la barre latérale. Modifiez les données utiles dans la barre latérale Test pour analyser le résultat de différentes données utiles.

3. Sélectionnez Exécuter.

Les résultats du test indiquent les étapes suivies par l’action, la sortie de la console, les erreurs qui se sont produites et des statistiques utiles sur l’exécution de l’action.

Maintenant que vous avez testé votre Action, il est temps de la déployer et d’observer son exécution. En supposant que vous ayez déployé votre Action et que vous l’ayez ajoutée à un flux (pour savoir comment attacher des Actions à des Flux, lisez la section « Attach the Action to a flow » (Attacher l’Action à un Flux) dans Programmer votre première Action). Vous pouvez déboguer votre Action en direct en quelques étapes.

Pour une Action post-login, vous pouvez vérifier le flux de bout en bout en exécutant une tentative de connexion pour votre locataire :

1. Naviguez vers Auth0 Dashboard > Authentication (Authentification) > Authentication Profile (Profil d’authentification), et sélectionnez Try (Essayer). Une fenêtre contenant un exemple de connexion s’ouvre.

2. Procédez à travers le flux de connexion. 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 énumère les attributs du profil utilisateur que vos applications recevront ou qui affiche un message d’erreur expliquant ce qui n’a pas fonctionné.

Chaque fois qu’un déclencheur s’exécute et qu’une Action associée est liée à son Flux, vos journaux de locataire incluront les détails de l’exécution de l’Action.

Dans la liste des journaux des locataires, vous pouvez voir les journaux associés aux Actions et choisir de les consulter. Dans l’exemple ci-dessous, le type de journal Connexion réussie est associé à une Action sur le déclencheur post-login de ce locataire.

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

Pour afficher les informations détaillées sur l’exécution de l’Action, sélectionnez le journal associé à l’exécution d’une Action, puis sélectionnez la vue Action Details (Détails de l’Action). Dans les détails de l’Action, vous pouvez consulter les statistiques d’exécution, la sortie de la console et les éventuelles erreurs qui se sont produites.

Vous pouvez tester vos Auth0 Actions à l’unité en simulant l’événement et l’API passés dans votre fonction d’Action. Vos Actions peuvent se trouver dans le contrôle de version ou dans un répertoire local, et vous pouvez utiliser un outil comme Jest pour tester automatiquement vos Actions. Dans l’exemple suivant, nous utilisons le déclencheur Connexion/Post-connexion et Jest pour simuler et tester.

Code d’Action :

// 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 :

// 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"
  );
});

Lorsque vous construisez des Actions dans Auth0, nous vous recommandons de créer un locataire Auth0 dédié par environnement. Cela vous permet d’isoler votre base d’utilisateurs de production de vos autres environnements, ainsi que de configurer différents administrateurs par environnement (par exemple, les ingénieurs peuvent ne pas avoir accès à la configuration de production).