Use Actions to extend Auth0:
- To learn more about Actions, read Understand How Auth0 Actions Work.
- To migrate, read Migrate from Hooks to Actions.
Prérequis
Avant de commencer ce tutoriel, vous devez :- Enregistrer votre API auprès d’Auth0
-
Enregistrer l’application M2M auprès d’Auth0.
- Sélectionnez un Type d’application de Applications machine à machine.
- Choisissez votre API enregistrée précédemment.
- Autorisez l’application M2M à appeler votre API.
Étapes
- Créer un Hook: Créez un hook pour personnaliser votre jeton.
- 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
Client Credentials Exchange, puis ajoutez le code suivant dans l’éditeur :
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êtePOST 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"