Tester les Actions

Selon l’avancement de votre mise en œuvre, plusieurs options s’offrent à vous pour tester et déboguer les Actions Auth0. Nous vous recommandons de tester les actions individuelles dans le à mesure que vous les implémentez. Une fois prêt, vous devriez vérifier que le flux de bout en bout fonctionne comme prévu à l’aide des journaux du tenant dans l’Auth0 Dashboard.

Tester des Actions individuelles

Vous pouvez tester des Actions individuelles à l’aide de l’Actions Code Editor. La fonctionnalité de test de l’éditeur simule une requête vers l’Action à l’aide d’un payload d’exemple basé sur le flow auquel l’Action est associée. Pour tester une Action individuelle :

Accédez à Auth0 Dashboard > Actions, puis choisissez le Flow et l’Action que vous souhaitez modifier.
Repérez l’Actions Code Editor, puis sélectionnez Test (l’icône de lecture) dans sa barre latérale. Modifiez le payload dans la barre latérale Test pour analyser le résultat de différents payloads.
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.

Capture d’écran du module de test dans l’Actions Code Editor

Vous pouvez également tester une Action à l’aide de l’endpoint Test an Action de la Management API en fournissant un payload correspondant au flow auquel l’Action est associée. Pour obtenir un payload d’exemple, testez l’Action à l’aide de la fonctionnalité Test de l’Actions Code Editor.

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. Si vous avez déployé votre Action et l’avez ajoutée à un flow (pour savoir comment associer des Actions à des Flows, consultez la section « Associer l’Action à un flow » dans Écrire votre première Action), vous pouvez déboguer votre Action en production en quelques étapes. Pour une Action post-login, vous pouvez vérifier le Login Flow de bout en bout en effectuant une tentative de login pour votre tenant :

Accédez à Auth0 Dashboard > Authentication > Authentication Profile, puis sélectionnez Try. Une fenêtre contenant un exemple de login s’ouvrira.
Suivez le Login Flow. Le Login Flow exécutera toutes les Actions configurées.

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

Analyser les journaux du tenant

Chaque fois qu’un déclencheur s’exécute et qu’une Action associée est liée à son flow, vos journaux du tenant incluront les détails d’exécution de l’Action. Dans la liste des journaux du tenant, vous pouvez voir les journaux associés aux Actions et choisir de les consulter. Dans l’exemple ci-dessous, le type de journal Success Login est associé à une Action sur le déclencheur post-login de ce tenant.

Capture d’écran de la liste des journaux du tenant dans l’Auth0 Dashboard, montrant les journaux associés à l’exécution d’une Action.

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

Nom	Déclencheur(s)
Success Login	post-login
Failed Login	post-login
Success Exchange	post-login
Failed Exchange	post-login
Success Change Password	post-change-password
Failed Change Password	post-change-password
Successful Signup	pre-user-registration
Failed Signup	pre-user-registration
Success Exchange	credentials-exchange
Failed Exchange	credentials-exchange

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 voir les statistiques d’exécution, la sortie de la console et toute erreur qui pourrait s’être produite.

Capture d’écran d’un journal individuel associé aux tests d’Actions.

Tests unitaires des Actions

Vous pouvez effectuer des tests unitaires de vos Actions Auth0 en simulant les objets event et api passés à la fonction de votre 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 les tester automatiquement. Dans l’exemple suivant, nous utilisons le déclencheur Login / Post Login et Jest pour simuler et tester. Code de l’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"
  );
});

Bonnes pratiques

Lorsque vous créez des Actions dans Auth0, nous vous recommandons de créer un tenant Auth0 distinct pour chaque environnement. Vous pourrez ainsi isoler votre base d’utilisateurs de production de vos autres environnements et configurer des administrateurs différents pour chaque environnement (par exemple, les ingénieurs pourraient ne pas avoir accès à la configuration de production).

Si vous souhaitez gérer, tester et déployer entièrement vos Actions à l’aide d’une CLI ou d’un pipeline CI/CD, vous pouvez utiliser le Deploy CLI Tool.

Personnalisation de la marque

Personnalisation du code

Personnalisation tierce

Tester des Actions individuelles

Déboguer les Actions déployées

Analyser les journaux du tenant

Tests unitaires des Actions

Bonnes pratiques

​Tester des Actions individuelles

​Déboguer les Actions déployées

​Vérifier le Login Flow de bout en bout

​Analyser les journaux du tenant

​Tests unitaires des Actions

​Bonnes pratiques

Tester des Actions individuelles

Déboguer les Actions déployées

Vérifier le Login Flow de bout en bout

Analyser les journaux du tenant

Tests unitaires des Actions

Bonnes pratiques