Configurer une Action de fournisseur de courriel à l’aide de l’Auth0 Dashboard
Pour utiliser l’Auth0 Dashboard afin de configurer votre tenant avec une Action de fournisseur de courriel personnalisée :- Accédez à Auth0 Dashboard > Branding > Email Provider.
- Activez la bascule Use my own email provider.
- Dans la section Email Provider, sélectionnez Custom Provider.
- Dans le champ From, saisissez l’adresse courriel par défaut à partir de laquelle les courriels seront envoyés.
- Dans l’éditeur de code, écrivez le code de votre Action pour envoyer des messages à votre fournisseur de courriel. Consultez la documentation de votre fournisseur pour connaître les détails de son API ou de sa connexion SMTP. Dans le menu de gauche de l’éditeur de code, vous pouvez cliquer sur l’icône de clé pour ajouter des secrets (par exemple, pour vous authentifier auprès d’une API) et sur l’icône de boîte pour ajouter des dépendances.
- Lorsque vous avez terminé d’écrire l’Action, cliquez sur Save pour la déployer.
Configurer une Action de fournisseur de courriel à l’aide de Terraform
Le Terraform Auth0 provider utilise l’Auth0 Management API pour effectuer des opérations sur la plateforme Auth0. Vous pouvez utiliser le Terraform Auth0 provider pour créer une Action de fournisseur de courriel personnalisé et configurer votre tenant pour l’utiliser.
- Dissocier ou supprimer les Actions en conflit
Vous pouvez avoir au maximum une Action associée au déclencheur custom-email-provider.
Si votre tenant est déjà configuré avec une Action de fournisseur de courriel personnalisé, réinitialisez cette Action avant de créer une nouvelle Action de fournisseur de courriel avec Terraform :
- Accédez à Auth0 Dashboard > Branding > Fournisseur de courriel.
- Dans la section Fournisseur de courriel, cliquez sur Custom Provider.
- Sous l’éditeur de code Actions, cliquez sur Réinitialiser.
custom-email-provider à l’aide de la Management API :
- Listez vos Actions pour repérer toute Action en double.
- Mettez à jour les liaisons de leur déclencheur ou supprimez les Actions.
- Créer une nouvelle Action de fournisseur de courriel
Utilisez la ressource Terraform auth0_action pour créer une Action qui prend en charge le déclencheur custom-email-provider. Définissez deploy = true pour créer immédiatement une nouvelle version de l’Action.
- Associer l’Action au déclencheur du fournisseur de courriel
Utilisez la ressource Terraform auth0_trigger_action pour associer l’Action au déclencheur custom-email-provider :
- Configurez le fournisseur de courriel de votre tenant avec l’Action
Utilisez la ressource Terraform auth0_email_provider pour configurer votre tenant afin d’utiliser l’Action du fournisseur de courriel :
custom-email-provider. Pour résoudre ce problème, suivez la première étape de cet article pour dissocier ou supprimer les Actions en conflit.
Exemple d’Action de fournisseur de courriel
Voici un exemple d’Action pour le déclencheurcustom-email-provider.
Dans cet exemple de code, la fonction onExecuteCustomEmailProvider prend en paramètre deux arguments de l’objet d’événement custom-email-provider : event, qui contient des renseignements sur l’utilisateur et le contexte de la notification, et de l’objet API custom-email-provider : api, qui fournit des méthodes utilitaires permettant de personnaliser l’envoi des notifications.