Configurer la vérification par SMS avec Aliyun Short Message Service

Le connecteur officiel Logto pour le service de messages courts Aliyun.

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 le SMS (service de messages courts). Le connecteur SMS Aliyun est un plugin fourni par l'équipe Logto pour appeler le service SMS Aliyun, grâce auquel les utilisateurs finaux de Logto peuvent s'inscrire et se connecter à leur compte Logto via un code de vérification par SMS.

Configurer un service de messages courts dans la console SMS Aliyun

Créer un compte Aliyun

Allez sur le site web d'Aliyun et enregistrez votre compte Aliyun si vous n'en avez pas.

Activer et configurer le service de messages courts Aliyun

1. Connectez-vous avec votre compte Aliyun sur le site web d'Aliyun et allez sur la page de la console du service SMS.
2. Cliquez sur le bouton "Open for free" (免费开通) en haut à gauche de la page du service SMS et commencez le processus de configuration.
3. Lisez et acceptez l'"Accord d'activation du service SMS" (短信服务开通条款) et cliquez sur "Subscribe to a service" (开通服务) pour continuer.
4. Vous êtes maintenant sur la page de la console du service SMS, allez soit sur le bouton "Mainland China" (国内消息) soit "Outside Mainland China" (国际/港澳台消息) dans la barre latérale selon votre cas d'utilisation.
5. Ajoutez une signature et un modèle en suivant les directives, et fournissez les documents ou informations requis pour la révision.
   • N'oubliez pas de sélectionner "Verification Code Message" (验证码) comme "Scenario" (适用场景) lors de la saisie de la demande de signature et également "Verification Code Message" (验证码) pour "Type" (模板类型) lors de la demande de révision du modèle car nous utilisons ces signatures et modèles pour envoyer le code de vérification. Actuellement, nous ne prenons pas en charge l'envoi de messages SMS autres que ceux liés aux codes de vérification.
   • Utilisez également {{code}} comme espace réservé là où vous souhaitez placer votre code de vérification numérique dans le contenu du modèle.
6. Après avoir soumis votre demande de signature et de modèle SMS, vous devez attendre qu'elle prenne effet. À ce stade, nous pouvons revenir à la page de la console du service SMS et envoyer un SMS de test. Si vos signatures et modèles sont prêts à être utilisés, vous pouvez les essayer directement ; s'ils ne sont pas encore effectifs, Aliyun fournit également des modèles de test.
   • Vous devrez peut-être recharger un petit montant d'argent avant d'envoyer des messages de test.
   • Il peut également vous être demandé de lier un numéro de téléphone de test avant d'envoyer des messages de test. Pour plus de détails, allez à l'onglet "Quick Start" (快速学习) dans la barre latérale de la page de la console du service SMS.

Composer le JSON du connecteur

1. Depuis la page de la console du service SMS, 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 "Mainland China" (国内消息) ou "Outside Mainland China" (国际/港澳台消息) que vous venez de visiter, vous pouvez facilement trouver "Signature" (签名名称) et "Template Code" (模板 CODE).
   • Si vous souhaitez utiliser la signature et le modèle uniquement pour les tests, allez plutôt à l'onglet "Quick Start" (快速学习), et vous les trouverez sous "Signature & Templates (For Test Only)".
3. Remplissez les paramètres du connecteur SMS Aliyun :
   • 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 signName avec "Signature" (签名名称) mentionnée à l'étape 2. Tous les modèles partageront ce nom de signature.
   • Vous pouvez ajouter plusieurs modèles de connecteur SMS pour différents cas. Voici un exemple d'ajout d'un seul modèle :
     • Remplissez le champ templateCode, qui est la façon dont vous pouvez contrôler le contexte SMS, avec "Template Code" (模板 CODE) de l'étape 2.
     • 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 tous les flux utilisateur, les modèles avec usageType Register, SignIn, ForgotPassword et Generic sont requis.

Tester le connecteur SMS Aliyun

Vous pouvez taper un numéro de téléphone et cliquer sur "Send" pour voir si les paramètres fonctionnent avant de "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
signName	string
templates	Template[]

Propriétés du modèle	Type	Valeurs énumérées
templateCode	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Références

• Aliyun SMS - Quick Start