Tester les actions

Apprenez à tester et à déboguer Auth0 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.

​

Tester les actions individuelles

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.

Vous pouvez également tester une Action à l’aide du point de terminaison Tester une action de Management API et fournir une charge utile correspondant au flux auquel l’Action est associée. Pour obtenir un exemple de charge utile, testez l’Action à l’aide de la fonction Test de l’éditeur de code d’actions.

​

Déboguer les actions déployées

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.

​

Vérifier le Flux de connexion de bout en bout

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é.

​

Analyser les journaux des locataires

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 :

Nom	Déclencheur(s)
Connexion réussie	post-connexion
Connexion ratée	post-connexion
Échange réussi	post-login
Échange échoué	post-login
Changement de mot de passe réussi	post-change-password
Changement de mot de mot de passe échoué	post-change-password
Enregistrement réussi	pre-user-registration
Enregistrement échoué	pre-user-registration
Échange réussi	credentials-exchange
Échange échoué	credentials-exchange

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.

​

Test unitaire des Actions

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

​

Meilleures pratiques

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

Si vous souhaitez gérer, tester et déployer entièrement vos Actions via une interface de ligne de commande ou un pipeline CI/CD, vous pouvez utiliser l’outil Deploy CLI.