Créer et publier une intégration Actions
La création d’une intégration Actions nécessite une planification, du développement et des tests. Avant de la rendre accessible aux clients dans l’Auth0 Marketplace, Auth0 évalue l’intégration Actions. Pour en savoir plus sur l’Auth0 Marketplace, consultez Partenaires du Marketplace.Étape 1. Déterminez votre cas d’utilisation
Identifiez le cas d’utilisation auquel votre intégration Actions répondra. Quel problème résoudra-t-elle pour les clients ? Comment y répondra-t-elle ? Pour en savoir plus, consultez Définir un cas d’utilisation pour une intégration.Étape 2. Choisir un flux
Les intégrations Actions se composent d’une seule Action. Ce qu’une Action peut faire dépend de l’endroit où elle est exécutée dans l’environnement d’exécution d’Auth0, c’est-à-dire de son flux. Les flux d’Action offerts sont :- Flux de connexion s’exécute de façon synchrone après qu’un utilisateur s’est inscrit ou s’est connecté avec succès. Les événements de connexion comprennent les flux interactifs (comme la connexion par nom d’utilisateur et mot de passe ou la connexion fédérée) et les flux non interactifs (comme les vérifications de session et les échanges de ). Pour en savoir plus sur ce flux, consultez Flux de connexion.
- Flux machine à machine s’exécute de façon synchrone lorsqu’une application demande un au moyen de l’octroi des informations d’identification du client. Pour en savoir plus sur ce flux, consultez Flux machine à machine.
- Flux de pré-inscription de l’utilisateur s’exécute de façon synchrone avant qu’Auth0 ajoute un utilisateur à une connexion de base de données ou . Ce flux ne s’exécute pas pour les connexions fédérées, comme les connexions d’entreprise ou sociales. Pour en savoir plus sur ce flux, consultez Flux de pré-inscription de l’utilisateur.
- Flux de post-inscription de l’utilisateur s’exécute de façon asynchrone après qu’Auth0 a ajouté un utilisateur à une connexion de base de données ou sans mot de passe. Ce flux ne s’exécute pas pour les connexions fédérées, comme les connexions d’entreprise ou sociales. Pour en savoir plus sur ce flux, consultez Flux de post-inscription de l’utilisateur.
- Flux après le changement de mot de passe s’exécute de façon asynchrone après qu’un client a changé le mot de passe d’un utilisateur associé à une connexion de base de données. Ce flux ne s’exécute pas pour les changements de mot de passe sur d’autres types de connexions. Pour en savoir plus sur ce flux, consultez Flux après le changement de mot de passe.
- Send Phone Message flux envoie un message vocal ou SMS dans le cadre d’un fournisseur personnalisé. Pour en savoir plus sur les fournisseurs MFA personnalisés, consultez Personnaliser les messages SMS et vocaux pour l’authentification multifacteur. Pour en savoir plus sur ce flux, consultez Flux Send Phone Message.
Étape 3. Créez une intégration Actions
Une fois que vous avez déterminé quel flux convient au cas d’utilisation de votre intégration Actions, créez votre Action dans un tenant de test. Pour obtenir des instructions, consultez Write Your First Action. Cette Action servira de base au code de votre intégration Actions. De plus, pour vous aider à créer votre intégration, vous pouvez utiliser nos modèles d’intégration Action :- Post Login Action Integration Template
- Machine-to-Machine Action Integration Template
- Pre User Registration Action Integration Template
- Post User Registration Action Integration Template
- Post Change Password Action Integration Template
- Send Phone Message Action Integration Template
- Lorsque vous créez votre Action dans un tenant de test, utilisez des secrets pour toutes les valeurs qu’un client doit fournir (comme des identifiants, des noms de tenant et des seuils). Lorsque vous soumettez votre intégration Actions, Auth0 vous demande quels champs doivent être chiffrés au repos (et rester des secrets) et lesquels peuvent être modifiables sous forme de champs de texte.
- Utilisez un indicateur de configuration pour le mode débogage/test afin d’activer la journalisation utile à la configuration ou au dépannage. Les intégrations Actions devraient rarement produire des logs pour toutes les exécutions.
- Écrivez les noms des secrets en
ALL_CAPS_SNAKE_CASEpour en faciliter la révision. - Les intégrations Actions sont à code source fermé; les clients ne peuvent ni voir ni modifier le code. Toute donnée propre au client requise pour contrôler l’intégration Actions doit provenir des secrets ou de la configuration.
Étape 4. Testez vos intégrations Actions
Comme les réviseurs d’Auth0 n’ont pas accès à votre service, vous devez tester votre Action avant de la soumettre pour examen. Testez manuellement à la fois les exécutions réussies et les cas limites. Incluez les vérifications suivantes :- Est-ce que l’Action échoue sans avertissement ou bloque la suite de l’exécution ?
- Comment l’Action se comporte-t-elle si une requête HTTP échoue ?
- Quels messages d’erreur, le cas échéant, sont affichés aux utilisateurs ?
- Quelles informations sont consignées dans les journaux ?
- Est-il possible de contourner l’Action ou de l’usurper ?