Passer au contenu principal

Concepts

Fonctionnement d’Auth0 Actions

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

À propos des modèles d’Actions

La galerie de modèles d’Actions propose à nos clients une grande variété de modèles de départ pour les aider à créer une Action

À propos d’Actions Modules

Créez du code réutilisable hébergé par Auth0, doté de ses propres secrets et dépendances NPM, afin de partager des fonctions entre plusieurs Actions liées à différents déclencheurs.

À propos du paquet NPM officiel d’Actions

Le paquet NPM d’Actions (@auth0/actions) permet de développer en TypeScript dans des projets externes, ce qui aide les développeurs à suivre les pratiques exemplaires et à améliorer leurs tests unitaires à l’aide des définitions TypeScript.

Directives de codage pour les Actions

Rédigez un code d’Actions clair, concis et sécurisé grâce à nos directives de codage.

À propos de la gestion des permissions dans les Actions

Modifiez les permissions des jetons avec les Actions Post Login et Credentials Exchange tout en respectant les politiques d’autorisation.

Limites des Actions

Consultez les contraintes qui s’appliquent à Auth0 Actions et à Auth0 Modules afin de concevoir du code personnalisé qui respecte les limites imposées.

Procédures

Créez Votre Première Action

Apprenez à écrire une Action, ce qui comprend le choix d’un flux, la création et la configuration de l’Action, ainsi que sa liaison au flux.

Comment écrire des Actions à l’aide de votre éditeur de code

Installez le paquet NPM officiel @auth0/actions comme dépendance de développement pour bénéficier des définitions de types TypeScript, d’IntelliSense et de la vérification des erreurs lorsque vous écrivez des Auth0 Actions et effectuez leurs tests unitaires par déclencheur et par version dans des éditeurs externes.

Comment écrire votre premier Module d’action

Créez votre premier Module d’action Auth0 dans Auth0 Dashboard : créez le module, ajoutez des secrets et des dépendances NPM, publiez une version, puis utilisez-la pour envoyer des journaux à un service externe.

Comment partager des données entre les Actions à l’aide des Métadonnées de transaction des Actions

Transmettez des métadonnées d’utilisateur ou d’application entre les Actions de connexion et post-login à l’aide des Métadonnées de transaction des Actions.

Comment rediriger les utilisateurs pendant l’authentification avec les Actions

Utilisez des Actions post-login pour rediriger les utilisateurs avant la fin d’une transaction d’authentification.

Comment gérer les dépendances de paquets NPM dans les Actions

Ajoutez des paquets du registre npm comme dépendances aux Auth0 Actions à l’aide de l’éditeur de code des Actions dans Auth0 Dashboard ou de Management API, et prenez connaissance des recommandations de sécurité ainsi que des limites des modules natifs et privés.

Comment gérer les versions des Actions

Comparez les versions brouillons et déployées des Actions ou revenez à des versions antérieures grâce à l’historique des versions des Actions.

Comment tester les Actions

Testez et déboguez les Auth0 Actions en exécutant des exemples de charges utiles dans l’éditeur de code des Actions ou dans Management API, en vérifiant les flux de bout en bout à l’aide des journaux du locataire et en réalisant des tests unitaires du code de votre gestionnaire avec des objets event et API simulés.

Comment consulter les journaux en temps réel des Actions dans Auth0 Dashboard

Utilisez le panneau Journaux en temps réel des Actions dans Auth0 Dashboard pour afficher en continu la sortie de console et les exceptions provenant des Actions, des scripts de base de données personnalisée et des connexions sociales personnalisées, afin de déboguer votre code personnalisé pendant son exécution.

Écrire des tests unitaires

Tester unitairement une Action

Tests unitaires pour une Action Post Login qui ajoute les rôles d’un utilisateur au jeton d’ID sous forme de demande personnalisée et refuse l’accès si aucun rôle n’est présent, avec Jest, Mocha et Node.js Test Runner, en JavaScript et en TypeScript.

Tester unitairement une Action qui utilise un module

Tests unitaires pour une Action Post Login qui récupère les rôles de l’utilisateur auprès d’un service externe au moyen d’un module personnalisé, les ajoute au jeton d’accès sous forme de demande personnalisée et refuse l’accès en cas d’échec, avec Jest, Mocha et Node.js Test Runner, en JavaScript et en TypeScript.

Tester unitairement les dépendances d’une Action

Tests unitaires pour une Action Pre User Registration qui bloque un domaine de courriel interdit et valide le nom complet soumis avant de l’enregistrer, avec un identifiant généré, dans les métadonnées de l’utilisateur et de l’application, avec Jest, Mocha et Node.js Test Runner, en JavaScript et en TypeScript.

Tester unitairement une Action qui affiche un formulaire

Tests unitaires pour une Action Post Login qui affiche un Form de consentement marketing, enregistre la réponse soumise et refuse l’accès si aucune réponse n’est soumise, avec Jest, Mocha et Node.js Test Runner, en JavaScript et en TypeScript.

Tester unitairement une Action qui redirige l’utilisateur

Tests unitaires pour une Action Password Reset Post Challenge qui redirige les utilisateurs à risque élevé vers une vérification d’identité et valide le jeton retourné avant de poursuivre, avec Jest, Mocha et Node.js Test Runner, en JavaScript et en TypeScript.

Migrer vers les Actions

Comment migrer des Rules vers les Actions

Migrez le code de vos Rules Auth0 existantes vers des Auth0 Actions.

Comment utiliser l'outil de migration des Rules

Découvrez comment utiliser l’outil de migration des Rules dans l’Auth0 Dashboard

Comment migrer des Hooks vers les Actions

Migrez le code de vos Hooks Auth0 existants vers des Auth0 Actions.

Référence

Déclencheurs disponibles

Les déclencheurs sont des événements qui appellent automatiquement une Action lorsqu’une opération précise, comme la connexion d’un utilisateur, survient pendant l’exécution.

Cas d’utilisation

Cas d'utilisation des Actions

Parcourez un répertoire soigneusement choisi d’exemples d’implémentation d’Auth0 Actions pour lancer rapidement votre propre logique personnalisée.