Comprendre le fonctionnement des Actions Auth0

Décrit le fonctionnement des Actions Auth0 et ce que vous pouvez accomplir avec elles.

Les Actions sont des fonctions sécurisées, propres à chaque locataire, versionnées et écrites en Node.js, qui s’exécutent à certains points de la plateforme Auth0. Les Actions servent à personnaliser et à étendre les capacités d’Auth0 à l’aide d’une logique personnalisée.

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

Les processus qui peuvent être étendus de cette façon sont appelés des déclencheurs. Les groupes 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é ajoutée. Certains déclencheurs s’exécutent de manière synchrone et bloquent le flux auquel ils participent, tandis que d’autres s’exécutent de manière asynchrone, comme indiqué dans le tableau ci-dessous.

Les Actions sont un élément central de l’offre d’extensibilité d’Auth0. Elles vous permettent d’ajouter la logique personnalisée essentielle à vos flux de connexion et d’identité selon vos besoins. Elles vous permettent aussi de connecter des intégrations externes qui enrichissent votre expérience globale d’extensibilité. Par exemple, vous pouvez ajouter une Action à votre déclencheur de connexion pour vérifier des pièces justificatives comme un permis de conduire ou un passeport à l’aide d’un partenaire 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 Passwordless.

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 de 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 nécessaires à l’inscription 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 à 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 le renvoi d’un jeton d’accès.

​

Principaux avantages d’Actions

​

Expérience développeur améliorée

• Lorsque vous modifiez une Action dans le Auth0 Dashboard, vous avez accès à des informations de typage détaillées et à une documentation intégrée sur les possibilités offertes par chaque déclencheur, ce qui vous permet de repérer facilement les fonctionnalités prises en charge par chacun.
• Une Action peut être modifiée et testée sans affecter la version qui gère actuellement le trafic de production.
• Si un problème est détecté 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 d’une Action à l’autre à l’aide des modules d’Actions.

​

Accès aux packages npm

• Vous pouvez utiliser presque tous les packages npm publics dans Actions.

​

Observabilité

• Lorsque Auth0 exécute des Actions, il consigne 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 prendre en charge plusieurs Actions indépendantes.

​

Pour commencer

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

​

En savoir plus

• Créer votre première Action
• Découvrir les déclencheurs
• limitation des Actions
• Gérer les versions
• Migrer d’Actions bêta vers la version finale