Configurer la vérification par e-mail avec Aliyun Direct Mail

Le connecteur officiel Logto pour le service de messagerie directe Aliyun.

astuce:

Ce guide suppose que vous avez une compréhension de base des Connecteurs Logto. Pour ceux qui ne sont pas familiers, veuillez vous référer au guide des Connecteurs pour commencer.

Commencer

Aliyun est un fournisseur de services cloud majeur en Asie, offrant de nombreux services cloud, y compris DM (messagerie directe). Le connecteur Aliyun DM est un plugin fourni par l'équipe Logto pour appeler les API du service Aliyun DM, grâce auquel les utilisateurs finaux Logto peuvent s'inscrire et se connecter à leur compte Logto via un code de vérification par e-mail (ou en d'autres termes, un code de vérification).

Configurer un service e-mail dans la console Aliyun DirectMail

Créer un compte Aliyun

Rendez-vous sur Aliyun et créez votre compte Aliyun si vous n'en avez pas encore.

Activer et configurer Aliyun Direct Mail

Allez sur la page de la console du service DM et connectez-vous. Activez le service Direct Mail en cliquant sur le bouton "Appliquer pour activer" (申请开通) en haut à gauche de la page et commencez le processus de configuration.

Depuis la page de la console d'administration DM, vous devez :

1. Aller dans "Domaines e-mail" (发信域名) depuis la barre latérale et ajouter un "Nouveau domaine" (新建域名) en suivant les instructions.
2. Personnaliser les "Adresses d'expéditeur" (发信地址) et les "Tags e-mail" (邮件标签) respectivement.

Après avoir terminé la configuration, il existe deux façons différentes de tester :

• Rendez-vous sur la page d’aperçu DirectMail, trouvez "Guide d'opération" (操作引导) en bas de la page, et cliquez sur "Envoyer des e-mails" (发送邮件). Vous y trouverez tous les différents types de méthodes de test.
• Suivez le chemin "Envoyer des e-mails" (发送邮件) -> "Tâches d'e-mail" (发送邮件) dans la barre latérale pour créer une tâche de test.

Composer le JSON du connecteur

1. Depuis la page de la console d'administration DM, survolez votre avatar en haut à droite et allez dans "Gestion des AccessKey" (AccessKey 管理), puis cliquez sur "Créer AccessKey" (创建 AccessKey). Vous obtiendrez une paire "AccessKey ID" et "AccessKey Secret" après avoir terminé la vérification de sécurité. Veuillez les conserver soigneusement.
2. Rendez-vous dans l'onglet "Adresses d'expéditeur" (发信地址) ou "Tags e-mail" (邮件标签) que vous venez de visiter depuis la page de la console d'administration DM, vous pouvez facilement trouver Adresse d'expéditeur ou Tag e-mail.
3. Remplissez les paramètres du connecteur Aliyun DM :
   • Remplissez les champs accessKeyId et accessKeySecret avec la paire de clés d'accès obtenue à l'étape 1.
   • Remplissez les champs accountName et fromAlias avec "Adresse d'expéditeur" et "Tag e-mail" trouvés à l'étape 2. Tous les modèles partageront ce nom de signature. (Vous pouvez laisser fromAlias vide car il est OPTIONNEL.)
   • Vous pouvez ajouter plusieurs modèles de connecteur DM pour différents cas. Voici un exemple d'ajout d'un seul modèle :
     • Remplissez le champ subject, qui servira de titre à l'e-mail envoyé.
     • Remplissez le champ content avec n'importe quel contenu de type chaîne. N'oubliez pas de laisser le placeholder {{code}} pour le code de vérification aléatoire.
     • Remplissez le champ usageType avec soit Register, SignIn, ForgotPassword ou Generic selon les cas d'utilisation. (usageType est une propriété Logto pour identifier le cas d'utilisation approprié.) Afin d'activer tous les parcours utilisateur, les modèles avec usageType Register, SignIn, ForgotPassword et Generic sont requis.

Tester le connecteur Aliyun DM

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

C'est tout. N'oubliez pas d’activer le connecteur dans l'inscription et la connexion.

Types de configuration

Nom	Type
accessKeyId	string
accessKeySecret	string
accountName	string
fromAlias	string (OPTIONNEL)
templates	Template[]

Propriétés du modèle	Type	Valeurs Enum
subject	string	N/A
content	string	N/A
usageType	enum string	'Register' / 'SignIn' / 'ForgotPassword' / 'Generic'