Aller au contenu principal

Connecteurs email

Un connecteur email intègre votre service de livraison d’e-mails avec Logto pour permettre une vérification sécurisée des utilisateurs par e-mail. Une fois configuré, vous pouvez envoyer des mots de passe à usage unique (OTP) pour l’inscription des utilisateurs, la connexion, la réinitialisation du mot de passe, le rattachement de compte, les invitations de membres et la validation d’opérations à haut risque.

Choisissez votre connecteur email​

Logto propose trois types d’options de connecteurs email :

Service Email Logto gratuit (Cloud uniquement)​

Cette option de service email intégré est idéale pour démarrer rapidement, aussi bien pour les tests que pour la production. Elle élimine le besoin d’intégrations tierces et offre une livraison d’e-mails fiable et gratuite. Il suffit de personnaliser votre branding de base pour les modèles d’e-mails préconçus.

Le connecteur Logto Email Service propose désormais des capacités de personnalisation de marque, incluant le logo, les informations de l’entreprise et le nom de l’expéditeur.

Cependant, bien que pratique, il existe certaines limitations à connaître — vous ne pouvez pas personnaliser l’adresse e-mail de l’expéditeur, le domaine ou le contenu spécifique de l’e-mail.

Connectez-vous à votre fournisseur de service d’e-mails (ESP) préféré grâce aux guides étape par étape de Logto.

Ces options vous permettent de personnaliser entièrement vos modèles d’e-mails, le nom de l’expéditeur, d’ajouter des variables, etc., pour servir au mieux votre image de marque.

Nous proposons une prise en charge prête à l’emploi pour les fournisseurs de services e-mail suivants :

Personnalisez votre connecteur email​

Si aucune des solutions ci-dessus ne répond à vos besoins, vous pouvez également choisir de vous connecter à votre service e-mail préféré en utilisant le protocole SMTP (Simple Mail Transfer Protocol).

Si vous disposez déjà de votre propre service e-mail et que vous n’êtes pas éligible à une connexion SMTP, nous proposons également un "connecteur email HTTP".

Lorsqu’il doit envoyer un e-mail, il effectue un appel API vers l’endpoint configuré pour compléter le flux d’authentification dépendant de l’e-mail. Notez que, pour éviter les erreurs de flux d’authentification, l’endpoint configuré doit retourner une réponse 200 après avoir reçu le WebHook pour informer Logto qu’il a bien reçu la notification d’envoi de l’e-mail. Dans ce cas, vous devez surveiller votre propre service e-mail pour garantir la bonne livraison.

Si nos connecteurs standards ne répondent pas à vos besoins spécifiques, n’hésitez pas à nous contacter. Pour les utilisateurs OSS, vous pouvez implémenter votre propre connecteur (OSS) si le besoin est urgent. Nous accueillons toujours les contributions ; votre effort pourrait aider d’autres membres de la communauté ayant les mêmes besoins.

Étapes de configuration​

Suivez les étapes ci-dessous pour ajouter un connecteur email :

  1. Accédez à Console > Connecteurs > Connecteurs email et SMS.
  2. Pour ajouter un nouveau connecteur email, cliquez sur le bouton "Configurer" et sélectionnez votre fournisseur d’e-mails souhaité.
  3. Consultez la documentation README et configurez votre fournisseur étape par étape.
  4. Cliquez sur "Enregistrer et terminer" pour finaliser.
remarque:

Pour garantir que les e-mails critiques (comme les codes de vérification) atteignent de manière fiable la boîte de réception des utilisateurs et évitent les filtres anti-spam, concentrez-vous sur deux priorités :

  • Configurer l’authentification des e-mails (SPF, DKIM, DMARC) Les fournisseurs d’e-mails (Gmail, Outlook, etc.) utilisent ces protocoles pour vérifier que vous n’êtes pas un spammeur. L’absence de ces configurations peut envoyer vos e-mails en spam ou les faire rejeter.
    • SPF (Sender Policy Framework) : Liste les serveurs / IP autorisés à envoyer des e-mails pour votre domaine.
    • DKIM (DomainKeys Identified Mail) : Ajoute une signature numérique pour prouver que les e-mails n’ont pas été altérés.
    • DMARC (Domain-based Message Authentication) : Indique aux destinataires comment traiter les e-mails qui échouent SPF / DKIM.
  • Séparer les e-mails d’authentification & marketing Les e-mails marketing déclenchent souvent des plaintes pour spam ou des taux de rebond élevés. Si les e-mails d’authentification partagent le même domaine / IP, leur délivrabilité en pâtit.
    • Utilisez un domaine dédié : Envoyez les e-mails de vérification depuis @auth.votredomaine.com, le marketing depuis @marketing.votredomaine.com.
    • IP dédiée : Demandez une IP unique pour les e-mails d’authentification et réchauffez-la progressivement.
    • Faites correspondre l’adresse "From" : Assurez-vous que le domaine de l’expéditeur correspond aux enregistrements SPF / DKIM / DMARC.

Changer de connecteur email​

Vous remarquerez qu’un seul connecteur email peut être ajouté.

Lorsque vous avez déjà un connecteur email, vous ne pouvez sélectionner que "Changer de connecteur email". Lors de cette opération dans la console, elle prend effet immédiatement une fois enregistrée, veillez donc à bien tester votre configuration avant de sauvegarder.

Pour garantir la stabilité de votre service, les utilisateurs Cloud peuvent créer un tenant de développement pour l’environnement de développement. Après avoir testé la configuration dans l’environnement de développement, "migre" la configuration vers la production, puis enregistrez la configuration.

Activer l’adresse e-mail pour les parcours utilisateur​

Une fois que vous avez ajouté et configuré le connecteur email, vous pouvez activer les parcours d’authentification par e-mail :

attention:

Comme nos configurations prennent effet immédiatement, la suppression du connecteur email existant peut affecter le processus normal de connexion et d’inscription des utilisateurs finaux.

Par exemple, si l’identifiant de connexion inclut la combinaison "e-mail + code de vérification", la suppression du connecteur email existant empêchera les utilisateurs de recevoir les codes de vérification par e-mail et entraînera une erreur dans le flux de connexion.

Veuillez être conscient des risques potentiels lors de la manipulation des connecteurs.

FAQ​

Comment personnaliser le nom de l’expéditeur de l’e-mail ?​

Nous travaillons encore sur d’autres connecteurs. Si vous avez besoin d’options supplémentaires, faites-nous part de vos besoins sur Discord et soumettez une demande de fonctionnalité sur GitHub. Si vous avez besoin d’aide supplémentaire, vous pouvez également nous contacter par e-mail.

Pour les contributeurs, nous proposons une méthode de création de connecteur facile à étendre, vous permettant de personnaliser votre propre connecteur selon vos scénarios spécifiques. Vous êtes toujours invité à soumettre une pull request à Logto, afin que d’autres membres de la communauté puissent également bénéficier de votre travail.

Comment puis-je restreindre les adresses IP pour les requêtes e-mail dans les connecteurs email Logto ?​

Une solution consiste à utiliser le connecteur email HTTP de Logto.

Implémentez un endpoint API sur votre serveur qui appelle le service e-mail concerné, et déclenchez ce endpoint API via le connecteur email HTTP de Logto. De cette façon, vous aurez un contrôle total sur l’adresse IP de votre endpoint API et pourrez ajouter les adresses IP correspondantes à la liste blanche dans la configuration de votre fournisseur de service e-mail.