Passer au contenu principal
Hooks will reach end of life (EOL) on April 30, 2027.
  • As of October 16, 2023, Hooks are no longer available in newly created tenants.
  • As of November 18, 2024, Hooks are read-only. Active Hooks still run, and you can enable or disable them and change their configuration values and secrets. You can’t edit their code in the Dashboard, the Management API, or tools that use it, such as the Auth0 CLI, Deploy CLI, Terraform, and Agent Skills.
  • After April 30, 2027, Hooks stop running and are removed.
Use Actions to extend Auth0:
Vous pouvez modifier les scopes et ajouter des claims personnalisés dans les jetons émis au moyen du Client Credentials Flow en ajoutant des Hooks. Les Hooks vous permettent de personnaliser le comportement d’Auth0 à l’aide de code Node.js. Ce sont des fonctions sécurisées et autonomes associées à des points d’extensibilité précis de la plateforme Auth0 (comme le Client Credentials Flow). Auth0 invoque les Hooks à l’exécution pour appliquer votre logique personnalisée. Vous pouvez gérer les Hooks à l’aide du ou de la .
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 hooks subséquents 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.

Prérequis

Avant de commencer ce tutoriel, vous devez :

Étapes

  1. Créer un Hook: Créez un hook pour personnaliser votre jeton.
  2. Tester le Hook: Testez votre nouveau hook en exécutant un Client Credentials Flow et en décodant le jeton d’accès.

Créer un Hook

Dans cet exemple, vous allez :
  • ajouter une revendication arbitraire (https://foo.com/claim) au jeton d’accès
  • ajouter une permission supplémentaire à l’API que vous avez configurée
Créez un Hook pour personnaliser votre jeton. Lorsqu’on vous demandera de choisir un point d’extensibilité, sélectionnez Client Credentials Exchange, puis ajoutez le code suivant dans l’éditeur :
Auth0 renvoie les informations du profil dans un format structuré de claim, tel que défini par la spécification OpenID Connect (OIDC). Cela signifie que les claims personnalisés ajoutés aux ID tokens ou aux jetons d’accès doivent respecter les directives et les restrictions afin d’éviter d’éventuelles collisions.

Testez votre Hook

Pour tester le hook que vous venez de créer, vous devez lancer un échange Client Credentials, obtenir le , le décoder et en examiner le contenu.

Obtenir un jeton

Pour obtenir un jeton, effectuez une requête POST vers le point de terminaison du Client Credentials Flow. Assurez-vous de remplacer les valeurs de remplacement CLIENT_ID, CLIENT_SECRET et API_IDENTIFIER par le de votre application, le de votre application et l’identifiant de votre API, respectivement. Vous trouverez le Client ID et le Client Secret dans les paramètres de votre Application, et l’identifiant de l’API dans les paramètres de votre API. Une réponse réussie comprendra :
  • un access_token,
  • sa durée de validité en secondes (expires_in),
  • le type de jeton défini comme Bearer (token_type), et
  • une permission extra (scope) (ajoutée par votre Hook)

Décoder le jeton

La façon la plus simple de décoder le jeton d’accès et d’en examiner le contenu est d’utiliser le débogueur JWT.io. Copiez votre jeton d’accès et collez-le dans l’éditeur. Le est décodé automatiquement et son contenu s’affiche. Notez que les deux derniers éléments du Payload ont été définis par votre hook :
  • "scope": "extra"
  • "https://foo.com/claim": "bar"

En savoir plus