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

Le connecteur officiel Logto pour Tencent Short Message Service.

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

Tencent Cloud est un fournisseur de services cloud majeur en Asie, offrant divers services, y compris le SMS (service de messages courts).

Le connecteur Tencent Short Message Service est une intégration officielle de Logto qui aide les utilisateurs finaux à s'inscrire ou à se connecter en utilisant des codes de vérification par SMS.

Configurer un service de messages courts dans Tencent Cloud

Créer un compte Tencent Cloud

Allez sur le site Web de Tencent Cloud et enregistrez votre compte si vous n'en avez pas.

Activer et configurer Tencent Cloud SMS

1. Connectez-vous avec votre compte sur le site Web de Tencent Cloud et allez à la page de la console de service SMS.
2. Cliquez sur le bouton “Free Trial” (免费试用) sur la page du service SMS et suivez les étapes de configuration.
3. Acceptez les “Terms of SMS Service Activation” (短信开通服务条款) et cliquez sur “Activate Service” (开通服务) pour continuer.
4. Sur la “SMS Console Overview” (短信服务控制台概览), choisissez “Domestic Messages”(国内消息) ou “International/Hong Kong, Macao, Taiwan Messages”(国际/港澳台消息) dans la barre latérale en fonction de vos besoins.
5. Ajoutez une signature et un modèle pour les messages SMS. Notez :
   • Lors de l'ajout d'une “Signature” (签名), sélectionnez “Verification Code” (验证码) sous le champ "Applicable Scenarios" (模版类型).
   • Lors de l'ajout d'un modèle, choisissez “Verification Code” comme type de modèle.
   • Incluez un espace réservé {1} dans le contenu du modèle, qui sera remplacé par un code généré aléatoirement.
   • Les modèles avec plusieurs espaces réservés ne sont pas pris en charge. Utilisez ou créez un modèle à espace réservé unique.
6. Soumettez la signature et le modèle pour approbation. Après soumission :
   • Attendez qu'ils prennent effet.
   • Un test SMS peut être envoyé depuis la “SMS Console Overview” (短信服务控制台概览). Les signatures et modèles approuvés peuvent être utilisés directement pour les tests, ou utilisez les modèles de test fournis s'ils sont encore en cours de révision.
   • Assurez-vous que votre compte a un solde suffisant pour les tests et préenregistrez le numéro de téléphone de test pour recevoir les SMS avec succès.

Pour des conseils détaillés, cliquez sur l'onglet “Getting Started Guide” (新手配置指引) dans la SMS Console Overview.

Composer le JSON du connecteur

1. Allez à la “SMS Console Overview” et survolez votre avatar dans le coin supérieur droit. Naviguez vers “Access Management > Access Keys > API Keys” pour générer votre AccessKey ID et AccessKey Secret après avoir terminé la vérification de sécurité. Veuillez les conserver correctement.
2. Depuis l'onglet “Domestic Messages” (国内消息) ou “International/Hong Kong, Macao, Taiwan Messages” (国际/港澳台消息), récupérez le “Signature Name” (签名名称) et le “Template Code” (模版 CODCE).
   • Pour les modèles de test, consultez l'onglet “Getting Started” (快速开始) sous "Test-Exclusive Templates" (测试专用签名模版).

• Configurez le connecteur Tencent Cloud SMS avec les champs suivants :
  • accessKeyId et accessKeySecret : Utilisez les identifiants de l'étape 1.
  • signName : Le nom de la signature obtenu à l'étape 2. Cela s'applique à tous les modèles.
  • Ajoutez plusieurs modèles pour différents scénarios si nécessaire. Exemple pour un modèle unique :
    • templateCode : Récupéré à partir du “Template Code” à l'étape 2.
    • usageType : Spécifiez l'un des Register, SignIn, ForgotPassword, ou Generic pour différents scénarios (propriété spécifique à Logto).
    • Assurez-vous que les modèles sont configurés pour les quatre scénarios pour compléter le flux.
  • sdkAppId : Trouvé dans “Application Management” (应用管理).
  • region : Spécifiez la région prise en charge à partir de la “Sending Documentation” (发送文档).

Tester le connecteur Tencent Cloud SMS

Vous pouvez entrer un numéro de téléphone et cliquer sur "Envoyer" pour voir si les paramètres fonctionnent avant de "Sauvegarder et Terminer".

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
region	string
sdkAppId	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

• Comment implémenter la fonction de code de vérification par SMS ?