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

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

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.

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 de service Aliyun DM, grâce auquel les utilisateurs finaux de Logto peuvent s'inscrire et se connecter à leur compte Logto via un code de vérification par mail (ou en d'autres termes, code de vérification).

Configurer un service de messagerie dans la console Aliyun DirectMail

💡 Astuce

Vous pouvez ignorer certaines sections si vous avez déjà terminé.

Créer un compte Aliyun

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

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 "Apply to enable" (申请开通) en haut à gauche de la page et commencez le processus de configuration.

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

1. Aller à "Email Domains" (发信域名) dans la barre latérale et ajouter "New Domain" (新建域名) en suivant les instructions.
2. Personnaliser "Sender Addresses" (发信地址) et "Email Tags" (邮件标签) respectivement.

Après avoir terminé la configuration, il existe deux manières différentes de tester :

• Allez sur la page d'aperçu de DirectMail, trouvez "Operation Guide" (操作引导) en bas de la page, et cliquez sur "Send Emails" (发送邮件). Vous trouverez tous les différents types de méthodes de test.
• Suivez le chemin "Send Emails" (发送邮件) -> "Email Tasks" (发送邮件) 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 dans le coin supérieur droit et allez à "AccessKey Management" (AccessKey 管理), et cliquez sur "Create AccessKey" (创建 AccessKey). Vous obtiendrez une paire "AccessKey ID" et "AccessKey Secret" après avoir terminé la vérification de sécurité. Veuillez les conserver correctement.
2. Allez à l'onglet "Sender Addresses" (发信地址) ou "Email Tags" (邮件标签) que vous venez de visiter depuis la page de la console d'administration DM, vous pouvez facilement trouver Sender Address ou Email Tag.
3. Remplissez les paramètres du connecteur Aliyun DM :
   • Remplissez les champs accessKeyId et accessKeySecret avec les paires de clés d'accès que vous avez obtenues à l'étape 1.
   • Remplissez le champ accountName et fromAlias avec "Sender Address" et "Email Tag" 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 des contenus de type chaîne arbitraire. N'oubliez pas de laisser l'espace réservé {{code}} pour le code de vérification aléatoire.
     • Remplissez le champ usageType avec soit Register, SignIn, ForgotPassword ou Generic pour différents cas d'utilisation. (usageType est une propriété Logto pour identifier le cas d'utilisation approprié.) Afin d'activer les flux utilisateur complets, les modèles avec usageType Register, SignIn, ForgotPassword et Generic sont requis.

Tester le connecteur Aliyun DM

Vous pouvez taper une adresse e-mail et cliquer sur "Send" pour voir si les paramètres peuvent fonctionner avant "Save and Done".

C'est tout. N'oubliez pas de activer le connecteur dans l'expérience de 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 énumérées
subject	string	N/A
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'