Règles de débogage
La date de fin de vie (EOL) des Règles et des Appels sera le 18 novembre 2026. Ils ne sont plus disponibles pour les nouveaux locataires créés à partir du 16 octobre 2023. Les locataires actuels ayant des hooks actifs conserveront l’accès aux produit Hooks jusqu’à la fin de leur durée de vie.
Nous vous conseillons vivement d’utiliser les Actions pour étendre Auth0. Avec les Actions, vous avez accès à des informations de type enrichies, à une documentation intégrée et à des packages npm publics, et vous pouvez connecter des intégrations externes qui optimisent votre expérience d’extensibilité globale. Pour en savoir plus sur ce que les Actions proposent, consultez Comprendre comment fonctionnent Auth0 Actions.
Pour vous aider dans votre migration, nous proposons des guides qui vous aideront à migrer des Règles vers les Actions et à migrer des Hooks vers les Actions. Nous avons également une page dédiée à la Migration vers les Actions qui met en évidence les comparaisons de fonctionnalités, une démo des Actions et d’autres ressources pour vous aider dans votre parcours de migration.
Pour en savoir plus sur l’obsolescence des Règles et des Appels, consultez notre article de blog : Preparing for Rules and Hooks End of Life (Préparation à la fin de vie des règles et des crochets).
Nous exposons les adresses IPv6 dans nos points de terminaison publics (par exemple, travel0.us.auth0.com). Si une demande provient d’une machine qui prend en charge IPv6, la propriété context.request.ip contiendra alors une adresse IPv6. Si vous manipulez manuellement des adresses IP, nous vous suggérons d’utiliser la bibliothèque ipaddr.js@1.9.0..
Pour déboguer toute règle Auth0 que vous avez créée, vous pouvez utiliser console.log à partir de votre code de règle. Vous pouvez voir le résultat de console.log en utilisant Sauvegarder et essayer, en consultant les journaux existants avec l’ extension des journaux des tâches Web en temps réel, ou pour les clients hérités, en utilisant l’interface de ligne de commande de déboguage de règle.
Essayer cette règle
Dans l’ Éditeur de règles , le bouton Save and Try (Sauvegarder et Essayer) vous permet d’exécuter une règle de façon isolée avec un faux utilisateur et des objets contextuels. Cliquer sur TRY (ESSAYER) exécutera la règle avec ces deux objets en entrée et affichera tout résultat console.log.
La fonctionnalité Essayer ce script de règles fonctionne dans un contexte autre que celui propre à un client. Lors de l'utilisation de cette fonction, vous pourriez rencontrer des problèmes si votre règle dépend de données qui seraient normalement fournies lorsqu'elle est appelée à partir d'une application réelle.
Extension de journaux en temps réel
L’extension de journaux de tâches Web en temps réel affiche en temps réel tous les journaux de code personnalisé dans votre compte, y compris toutes les sorties et exceptions console.log. Pour en savoir plus, consultez Journaux de tâches Web en temps réel.
L'interface de ligne de commande de débogage de règle
Seuls les locataires créés avant le 17 juillet 2018 ont accès à Webtask.io et à l’interface de ligne de commande Webtask. Si vous êtes une entreprise cliente avec un nouveau locataire, veuillez communiquer avec votre représentant de compte pour demander l’accès. D’autres demandes peuvent être effectuées par l’entremise du Formulaire de contact Auth0 et seront évaluées au cas par cas.
Dans l’Éditeur de règles, l’option Sauvegarder et déboguer affiche les instructions pour installer, configurer et exécuter l’interface de ligne de commande webtask pour les règles de déboguage. Collez ces commandes dans un terminal pour voir les résultats de console.log et toutes exceptions non pris en charge survenant durant l’exécution de la règle.
Par exemple :
~ npm install -g wt-cli
~ wt init --container "youraccount" --url "https://sandbox.it.auth0.com" --token "eyJhbGci...WMPGI" -p "youraccount-default-logs"
~ wt logs -p "youraccount-default-logs"
[18:45:38.179Z] INFO wt: connected to streaming logs (container=youraccount)
[18:47:37.954Z] INFO wt: webtask container assigned
[18:47:38.167Z] INFO wt: ---- checking email_verified for some-user@mail.com! ----Was this helpful?
Cette méthode de débogage fonctionne pour les règles essayées à partir du Tableau de bord et pour celles qui s'exécutent réellement pendant l'authentification de l'utilisateur.