Passer au contenu principal
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).
Comme nous prévoyons de supprimer les fonctions Règles et Hooks en 2026, vous devez créer de nouvelles Règles ou de nouveaux Hooks uniquement dans votre environnement de développement et uniquement pour tester la migration vers les Actions.Pour apprendre à migrer vos Règles vers des Actions, consultez Migrer des règles vers les actions. Pour apprendre à migrer vos Hooks vers des Actions, consultez la section Migrer des Hooks vers les actions.
Vous pouvez mettre à jour les hooks en utilisant Dashboard ou . Vous pouvez également importer et exporter des hooks à l’aide de l’outil Deploy CLI.
En option, vous pouvez ajouter des secrets (tels que des clés Twilio ou des chaînes de connexion à la base de données) aux hooks.

​
Renommer les hooks en utilisant Dashboard

  1. Allez à Dashboard Auth0 > Pipeline auth > Hooks et cliquez sur l’icône de roue dentée à côté du hook que vous souhaitez renommer.
  2. Cliquez sur Renommer.
  3. Saisissez un nouveau nom pour le hook et cliquez sur Renommer.
    Auth0 Rename Hooks

​
Mettre à jour les scripts d’appels en utilisant Dashboard

  1. Allez à Dashboard Auth0 > Pipeline Auth > Hooks et cliquez sur l’icône de crayon à côté du hook que vous souhaitez mettre à jour.
    Auth0 Hooks select a Hook
  2. Mettez à jour le crochet en utilisant l’Éditeur de crochet et cliquez sur l’icône de disque pour enregistrer votre changement.
    Auth0 Hook Editor

​
Mettre à jour les hooks en utilisant Management API

Effectuez une requête PATCH au point de terminaison Mise à jour d’un hook. Assurez-vous de remplacer les valeurs des paramètres fictifs HOOK_ID et MGMT_API_ACCESS_TOKEN avec l’ID de votre appel et votre jeton d’accès de Management API, respectivement. 
curl --request PATCH \
  --url 'https://{yourDomain}/api/v2/hooks/HOOK_ID' \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN' \
  --header 'cache-control: no-cache' \
  --header 'content-type: application/json' \
  --data '{ "name": "HOOK_NAME", "script": "HOOK_SCRIPT", "enabled": "true" }'
ValeurDescription
HOOK_IDID du Hook à mettre à jour.
HOOK_NAMENom de l’appel à créer.
HOOK_SCRIPTScript qui contient le code pour l’appel. Il doit correspondre à ce que vous entreriez en créant un nouvel appel en utilisant Dashboard.
La propriété enabled représente la règle activée (true) ou désactivée (false).

Gérer les limitations de taux lors d’une requête API depuis un Hook

Si vous faites une requête API Auth0 à partir d’un script de Hook, vous devrez gérer les limitations de taux. Pour ce faire, vérifiez l’en-tête X-RateLimit-Remaining et gérez la situation de manière adéquate lorsque le numéro retourné s’approche de 0.De plus, ajoutez le code nécessaire pour gérer les cas dans lesquels vous dépassez les limites de taux et recevez un code de statut HTTP 429(Too Many Requests). Dans ce cas, si une nouvelle requête est nécessaire, il est recommandé de prévoir un délai d’attente pour éviter de se retrouver dans une boucle infinie de tentatives.
⌘I