Aller au contenu principal

Configurer la vérification par e-mail avec le service de messagerie Mailgun

Le connecteur officiel Logto pour le service de messagerie Mailgun.

astuce

Dans ce guide, nous supposons que vous avez des connaissances de base sur les Connecteurs Logto. Si ce n'est pas le cas, consultez le guide Configurer les connecteurs pour commencer.

Prérequis​

Configuration de base​

  • Remplissez le champ endpoint lorsque vous utilisez un autre point de terminaison API Mailgun, par exemple, la région EU devrait être https://api.eu.mailgun.net. La valeur par défaut est https://api.mailgun.net.
  • Remplissez le champ domain avec le domaine que vous avez enregistré dans votre compte Mailgun. Cette valeur peut être trouvée dans la section Domains du tableau de bord Mailgun. Le domaine doit être au format example.com, sans le préfixe https:// ou http://.
  • Remplissez le champ apiKey avec la clé API que vous avez générée dans votre compte Mailgun.
  • Remplissez le champ from avec l'adresse e-mail à partir de laquelle vous souhaitez envoyer des e-mails. Cette adresse e-mail doit être enregistrée dans votre compte Mailgun. L'adresse e-mail doit être au format Sender Name <[email protected]>.

Livraisons​

Objet de configuration​

La section "Livraisons" vous permet de configurer le contenu des e-mails à envoyer dans différents scénarios. Il s'agit d'une carte clé-valeur JSON où la clé est le type d'utilisation et la valeur est un objet contenant la configuration du contenu pour l'e-mail à envoyer.

{
  "<usage-type>": {
    // ...
  }
}

Types d'utilisation​

Les types d'utilisation suivants sont pris en charge :

  • Register : L'e-mail à envoyer lorsqu'un utilisateur s'inscrit.
  • SignIn : L'e-mail à envoyer lorsqu'un utilisateur se connecte.
  • ForgotPassword : L'e-mail à envoyer lorsqu'un utilisateur réinitialise son mot de passe.
  • Generic : L'e-mail à envoyer lorsqu'un utilisateur effectue une action générique, par exemple, tester le connecteur d'e-mail.

Remarque Si le type d'utilisation n'est pas spécifié dans la configuration des livraisons, l'e-mail générique sera envoyé. Si l'e-mail générique n'est pas spécifié, le connecteur renverra une erreur.

Configuration du contenu​

Le connecteur prend en charge à la fois le contenu HTML direct et le modèle Mailgun. Vous pouvez utiliser l'un d'eux pour chaque type d'utilisation.

Dans le sujet et le contenu, vous pouvez utiliser l'espace réservé {{code}} pour insérer le code de vérification.

Pour utiliser le contenu HTML direct, remplissez les champs suivants :

  • subject : Le sujet de l'e-mail à envoyer.
  • replyTo : L'adresse e-mail à utiliser comme adresse de réponse.
  • html : (Requis) Le contenu HTML de l'e-mail à envoyer.
  • text : La version texte brut de l'e-mail à envoyer.

Pour utiliser le modèle Mailgun, remplissez les champs suivants :

  • subject : Le sujet de l'e-mail à envoyer.
  • replyTo : L'adresse e-mail à utiliser comme adresse de réponse.
  • template : (Requis) Le nom du modèle Mailgun à utiliser.
  • variables : Les variables à transmettre au modèle Mailgun. Doit être une carte clé-valeur JSON car elle sera convertie en chaîne avant d'être envoyée à Mailgun. Notez qu'il n'est pas nécessaire d'inclure la variable code car elle sera automatiquement ajoutée par le connecteur.

Exemple​

Voici un exemple de configuration des livraisons :

{
  "Register": {
    "subject": "{{code}} est votre code de vérification",
    "replyTo": "Foo <[email protected]>",
    "html": "<h1>Bienvenue sur Logto</h1><p>Votre code de vérification est {{code}}.</p>",
    "text": "Bienvenue sur Logto. Votre code de vérification est {{code}}."
  },
  "SignIn": {
    "subject": "Bienvenue à nouveau sur Logto",
    "replyTo": "Foo <[email protected]>",
    "template": "logto-sign-in",
    "variables": {
      "bar": "baz"
    }
  }
}

Tester le connecteur d'e-mail Mailgun​

Vous pouvez saisir une adresse e-mail et cliquer sur "Envoyer" pour vérifier si les paramètres fonctionnent avant "Enregistrer et Terminer".

C'est tout. N'oubliez pas de Activer le connecteur dans l'expérience de connexion