Créer des secrets de hook d’appel

Découvrez comment créer des secrets de hooks à l’aide du Tableau de bord et de Management API. Les secrets de hooks peuvent également être importés et exportés à l’aide de l’outil Auth0 Deploy CLI.

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 créer plusieurs Secrets d’appel pour n’importe quel Hook à l’aide de Dashboard ou de Management API.

Les secrets de hooks peuvent également être importés et exportés à l’aide de l’outil Deploy CLI.

Vous pouvez créer jusqu’à 20 secrets pour chaque hook.

​

Créer des Secrets de hook d’appel à l’aide du tableau de bord

1. Accédez à la page Crochets dans Tableau de bord Auth0 et cliquez sur l’icône en forme de crayon à côté de l’appel que vous souhaitez modifier.
2. Dans l’éditeur de hooks, cliquez sur l’icône de clé à molette, puis cliquez sur Secrets.
3. Cliquez sur Ajouter un secret.
4. Saisissez un nom et une valeur descriptifs pour votre secret, puis cliquez sur Enregistrer.

​

Créer des Secrets de hook à l’aide de Management API

Faites une requête POST au point de terminaison Ajouter des Secrets d’appel. Assurez-vous de remplacer les valeurs des paramètres fictifs MGMT_API_ACCESS_TOKEN, HOOK_ID, HOOK_SECRET_KEY et HOOK_SECRET_VALUE avec votre jeton d’accès de Management  API, votre identifiant de hookID d’appel et les paires clé-valeur de hook d’appel respectivement.

cURL

curl --request POST \
  --url 'https://{yourDomain}/api/v2/hooks/HOOK_ID/secrets' \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN' \
  --header 'cache-control: no-cache' \
  --header 'content-type: application/json' \
  --data '{ [ "HOOK_SECRET_KEY", "HOOK_SECRET_VALUE" ], [ "HOOK_SECRET_KEY", "HOOK_SECRET_VALUE" ] }'

Valeur	Description
MGMT_API_ACCESS_TOKEN	[Jeton d’accès à Management API] (/api/management/v2/tokens) avec la permission create:hooks.
HOOK_ID	ID du crochet pour lequel vous souhaitez ajouter des secrets.
HOOK_SECRET_KEY	Nom du secret que vous souhaitez ajouter pour le crochet spécifié. Ce point de terminaison accepte un objet de paires clé-valeur.
HOOK_SECRET_VALUE	Valeur du secret que vous souhaitez ajouter au crochet spécifié. Ce point de terminaison accepte un objet de paires clé-valeur.