Skip to main content
Des partenaires comme vous utilisent les Intégrations Actions pour créer des solutions sans code qui relient leurs produits aux flux de travail d’Auth0. Les Intégrations Actions permettent aux clients d’Auth0 de mettre en place des solutions comme la vérification d’identité ou la gestion du consentement sans écrire de code. Vous créez l’Intégration Actions; les clients la glissent-déposent dans leur flux de travail. Les Intégrations Actions sont des fonctions autonomes qui s’exécutent à des points précis de la plateforme Auth0. Écrites en JavaScript, elles sont à code source fermé; les clients ne peuvent pas en modifier le code.

​
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.
Pour en savoir plus sur les flux d’Action, consultez Explorer les flux et les déclencheurs. Si vous devez rediriger les utilisateurs vers un point de terminaison pendant la connexion, consultez Actions de redirection pour les partenaires.

​
É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 : Pour savoir comment rendre votre intégration Actions sécurisée et stable, consultez Actions Coding Guidelines. Suivez également ces directives propres aux intégrations Actions :
  • 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_CASE pour 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 ?
Pendant le processus de soumission, Auth0 demande une couverture de tests unitaires pour le scénario de réussite. Auth0 fournit tous les outils et exemples nécessaires pour simplifier ce processus autant que possible.

​
Étape 5. Soumettez votre intégration Actions

Une fois que vous avez créé et testé minutieusement votre intégration Actions, soumettez-la à Auth0 pour examen : présentez une demande de service Auth0 Marketplace. Après une première évaluation concluante, l’intégration fait l’objet d’un examen de conformité en matière de sécurité.

​
Étape 6. Publiez votre intégration Actions

Une fois qu’Auth0 aura terminé l’évaluation de votre intégration Actions, nous vous aviserons si l’intégration a réussi l’évaluation et nous vous communiquerons les échéanciers de publication.