Activer et désactiver les hooks

Apprenez à activer et désactiver les hooks en utilisant Dashboard et Management API.

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 activer et désactiver les hooks en utilisant Dashboard ou Management API.

Bien que vous puissiez créer plusieurs hooks pour un point d’extensibilité donné, chaque point d’extensibilité ne peut avoir qu’un seul hook activé à la fois. Tous les appels ultérieurs que vous créez pour ce point d’extensibilité sont automatiquement désactivés. Vous devez donc les activer explicitement. Le hook activé sera exécuté pour toutes les applications et API.

Lorsque vous créez de nouveaux hooks, Auth0 active automatiquement le premier hook que vous créez pour un point d’extensibilité. Tous les hooks ultérieurs que vous créez pour ce point d’extensibilité sont automatiquement désactivés. Vous devez donc les activer explicitement.

​

Utiliser Dashboard

1. Rendez-vous à Tableau de bord Auth0 &gt Pipeline d’auth > Crochets et localisez le point d’extensibilité pour lequel vous voulez activer ou désactiver un hook.

2. Cliquez sur la liste déroulante située juste en dessous du nom et de la description du point d’extensibilité.

   

3. Sélectionnez l’appel que vous souhaitez activer et confirmez. Si vous souhaitez désactiver tous les Hooks, sélectionnez None.

Un point vert s’affichera à côté du nom de tous les Hooks activés.

​

Utiliser 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

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 '{ "enabled": "true" }'

Valeur	Description
HOOK_ID	ID du crochet à mettre à jour.
MGMT_API_ACCESS_TOKEN	Jeton d’accès pour Management API avec la permission create:hooks. Pour en savoir plus, consultez Jetons d’accès à Management API.

La propriété enabled représente la règle activée (true) ou désactivée (false).