Comprendre le fonctionnement d’Auth0 Actions

Décrit le fonctionnement d’Auth0 Actions et ce que vous pouvez accomplir avec cette fonctionnalité.

Auth0 Actions regroupe des fonctions sécurisées propres à chaque tenant, versionnées, écrites en Node.js, qui s’exécutent à certaines étapes de la plateforme Auth0. Les Actions servent à personnaliser et à étendre les capacités d’Auth0 au moyen d’une logique personnalisée.

Auth0 Actions utilise le modèle de programmation basé sur les promesses de JavaScript moderne, qui constitue la base des fonctions asynchrones dans Actions.

Les processus qui peuvent être étendus de cette façon sont appelés des déclencheurs. Les regroupements de déclencheurs représentent le pipeline logique par lequel l’information circule à une étape donnée du parcours Auth0. Plusieurs Actions peuvent être ajoutées à un déclencheur, et chaque Action s’exécute dans l’ordre où elle a été placée. Certains déclencheurs s’exécutent de façon synchrone et bloquent le flux auquel ils participent, tandis que d’autres s’exécutent de façon asynchrone, comme l’indique le tableau ci-dessous.

Les Actions sont un élément central de notre offre globale d’extensibilité chez Auth0. Avec Actions, vous pouvez ajouter une logique personnalisée essentielle à vos flux de connexion et d’identité, selon vos besoins. Les Actions vous permettent aussi de connecter des intégrations externes qui améliorent votre expérience globale d’extensibilité. Par exemple, vous pouvez ajouter une Action à votre déclencheur de connexion pour vérifier des justificatifs comme un permis de conduire ou un passeport à l’aide d’un partenaire du Marketplace spécialisé dans la vérification d’identité.

​

Que pouvez-vous faire avec Actions ?

Ce qu’une Action peut faire dépend de l’endroit où elle s’exécute dans l’environnement d’exécution d’Auth0.

Inscription et connexion : lorsqu’un utilisateur est ajouté à une connexion de base de données ou sans mot de passe.

Déclencheur	Description
pre-user-registration	Se déclenche avant la création d’un utilisateur. Ne s’exécute pas pour les connexions sociales.
post-user-registration	Se déclenche de façon asynchrone après la création d’un utilisateur. Ne s’exécute pas pour les connexions sociales.
post-login	Se déclenche après l’authentification d’un utilisateur, mais avant l’émission du jeton.

Notifications MFA : lors de l’utilisation du SMS comme facteur pour l’authentification multifacteur (MFA) ou pour configurer un fournisseur personnalisé.

Déclencheur	Description
send-phone-message	Se déclenche lors de l’utilisation d’un fournisseur personnalisé pour envoyer les messages liés à l’enrôlement et au processus de vérification. Ne s’exécute pas pour les connexions sociales.

Réinitialisation du mot de passe : lorsqu’une demande de réinitialisation du mot de passe est lancée.

Déclencheur	Description
post-change-password	Se déclenche après la modification d’un mot de passe. Ne s’exécute pas pour les connexions sociales.
password-reset-post-challenge	Se déclenche une fois la première vérification terminée et avant la réinitialisation du mot de passe.

Machine to Machine : lorsqu’une application, plutôt qu’un utilisateur, est authentifiée et autorisée à utiliser vos API.

Déclencheur	Description
credentials-exchange	Se déclenche avant qu’un jeton d’accès soit renvoyé.

​

Principaux avantages des Actions

​

Expérience développeur améliorée

• Lorsque vous modifiez une Action dans l’Auth0 Dashboard, vous avez accès à des informations de typage détaillées et à une documentation intégrée sur ce qu’il est possible de faire avec chaque déclencheur, ce qui permet de voir facilement quelles fonctionnalités sont prises en charge par chaque déclencheur.
• Une Action peut être modifiée et testée sans affecter la version qui traite actuellement le trafic de production.
• Si un problème est обнаружé dans une Action, il est possible de revenir à une version antérieure.

​

Réutiliser des fonctions personnalisées

• Créez, gérez et partagez des fonctions entre Actions à l’aide d’Actions Modules.

​

Accès aux paquets npm

• Vous pouvez utiliser la quasi-totalité des paquets npm publics dans Actions.

​

Observabilité

• Lorsque Auth0 exécute des Actions, il recueille des métriques clés à leur sujet et les associe aux journaux Auth0.
• Pour le débogage, utilisez la fonctionnalité Journaux en temps réel des Actions.

​

Plusieurs Actions pour chaque déclencheur

• Chaque déclencheur d’Action peut exécuter plusieurs Actions indépendantes.

​

Pour commencer

• écrire votre première Action.
• Consultez les consignes actuelles de codage des Actions.
• Consultez les limitations actuelles des Actions.

​

En savoir plus

• Écrire votre première Action
• Explorer les déclencheurs
• Limitations des Actions
• Gérer les versions
• Migrer de la version bêta d’Actions vers la version finale