> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-docs-event-stream-action-templates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Règles de débogage

> Apprenez comment déboguer vos règles d'Auth0.

<Warning>
  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](/docs/fr-ca/customize/actions/actions-overview).

  Pour vous aider dans votre migration, nous proposons des guides qui vous aideront à [migrer des Règles vers les Actions](/docs/fr-ca/customize/actions/migrate/migrate-from-rules-to-actions) et à [migrer des Hooks vers les Actions](/docs/fr-ca/customize/actions/migrate/migrate-from-hooks-to-actions). Nous avons également une page dédiée à la [Migration vers les Actions](https://auth0.com/extensibility/movetoactions) qui met en évidence les comparaisons de fonctionnalités, [une démo des Actions](https://www.youtube.com/watch?v=UesFSY1klrI)  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)](https://auth0.com/blog/preparing-for-rules-and-hooks-end-of-life/).
</Warning>

<Warning>
  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.](https://www.npmjs.com/package/ipaddr.js/v/1.9.0).
</Warning>

Pour déboguer toute [règle Auth0](/docs/fr-ca/rules) 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](#real-time-logs-extension), ou pour les clients hérités, en utilisant [l’interface de ligne de commande de déboguage de règle](#debug-rule-cli).

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/XIL2NucFdH91gJS_/docs/images/fr-ca/cdy7uua7fh8z/5CoC6cnazv2uT1iSq6OGsm/6cb30d9479971be771313da80acc4802/Dashboard_-_Auth_Pipeline_-_Rules_-_Edit_Rule.png?fit=max&auto=format&n=XIL2NucFdH91gJS_&q=85&s=fda19e55963eef0e0d665b9fdf437bec" alt="Dashboard - Auth Pipeline - Rules - Edit Rule" width="1103" height="1018" data-path="docs/images/fr-ca/cdy7uua7fh8z/5CoC6cnazv2uT1iSq6OGsm/6cb30d9479971be771313da80acc4802/Dashboard_-_Auth_Pipeline_-_Rules_-_Edit_Rule.png" />
</Frame>

## Essayer cette règle

Dans l’ [Éditeur de règles](https://manage.auth0.com/#/rules/create) , 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.

<Frame>
  <img src="https://mintcdn.com/docs-dev-docs-event-stream-action-templates/XIL2NucFdH91gJS_/docs/images/fr-ca/cdy7uua7fh8z/4scLIFzI1isvJZ9UI6mHfR/eceb674d3a53ecbab1bd9835a5194012/Auth_Pipeline_-_Rules_-_Try.png?fit=max&auto=format&n=XIL2NucFdH91gJS_&q=85&s=28fbe2353e260bb8bd53f5f61c392ad5" alt="Auth0 Pipeline - Rules - Try this rule" width="629" height="1016" data-path="docs/images/fr-ca/cdy7uua7fh8z/4scLIFzI1isvJZ9UI6mHfR/eceb674d3a53ecbab1bd9835a5194012/Auth_Pipeline_-_Rules_-_Try.png" />
</Frame>

## 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](/docs/fr-ca/customize/extensions/realtime-webtask-logs).

## L'interface de ligne de commande de débogage de règle

<Warning>
  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](https://auth0.com/get-started?place=documentation%20post\&type=link\&text=auth0%20contact%20form) et seront évaluées au cas par cas.
</Warning>

Dans l’[Éditeur de règles](https://manage.auth0.com/#/rules/create), l’option **Sauvegarder et déboguer** affiche les instructions pour installer, configurer et exécuter [l’interface de ligne de commande webtask](https://github.com/auth0/wt-cli) 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 :

```bash lines theme={null}
~  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! ----
```

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.
