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.

Connecteur officiel Logto pour le service SMS de Tencent Cloud Documentation en chinois

Connecteur SMS de Tencent Cloud

Tencent Cloud est un important fournisseur de services cloud en Asie, offrant une large gamme de services, y compris les SMS.

Ce connecteur, fourni officiellement par Logto, permet aux utilisateurs finaux de s'inscrire et de se connecter via des codes de vérification par SMS.

Configurer un service SMS dans la console SMS de Tencent Cloud

💡 Astuce

Vous pouvez ignorer les parties que vous avez déjà complétées.

Créer un compte Tencent Cloud

Allez sur Tencent Cloud et complétez l'enregistrement du compte.

Activer et configurer le service SMS de Tencent Cloud

1. Connectez-vous à Tencent Cloud avec votre compte nouvellement enregistré et accédez à la console du service SMS.
2. Cliquez sur le bouton "Essai gratuit" en haut à gauche de la page du service SMS pour commencer le processus de configuration.
3. Acceptez les "Conditions d'utilisation du service SMS" et activez le service pour continuer.
4. Vous serez maintenant dans la "Vue d'ensemble de la console du service SMS." Selon votre cas d'utilisation, cliquez sur "Messages domestiques" ou "Messages internationaux/Grande Chine" dans la barre latérale.
5. Suivez les instructions pour ajouter une signature et des modèles, en fournissant les documents nécessaires pour approbation :
   • Remarque : Lors de l'ajout d'une signature, sélectionnez "Code de vérification" sous "Scénario d'application." De même, lors de l'ajout d'un modèle, choisissez "Code de vérification" sous "Type de modèle," car le but ici est d'envoyer des codes de vérification. L'envoi d'autres types de messages texte n'est actuellement pas pris en charge.
   • Assurez-vous que le contenu de votre modèle inclut un espace réservé {1}, qui sera remplacé par un code de vérification généré aléatoirement lorsque le SMS sera envoyé.
   • Seuls les modèles avec un seul espace réservé sont pris en charge. Sélectionnez ou créez des modèles avec un seul espace réservé.
6. Après avoir soumis les demandes de signature et de modèle, attendez leur approbation. Pendant ce temps, vous pouvez retourner à la Vue d'ensemble de la console du service SMS pour envoyer des messages de test. Si votre signature et votre modèle sont approuvés, utilisez-les directement pour les tests. Sinon, Tencent fournit des modèles de test.
   • Vous devrez peut-être recharger votre compte avec un petit montant avant d'envoyer des messages de test.
   • Liez à l'avance le numéro de téléphone que vous prévoyez d'utiliser pour les tests pour garantir la réception réussie des messages de test. Cliquez sur l'onglet "Guide du débutant" en haut de la Vue d'ensemble de la console du service SMS pour plus de détails.

Écrire la configuration JSON du connecteur

1. Allez à la Vue d'ensemble de la console du service SMS, survolez votre profil en haut à droite, accédez à "Gestion des accès," et cliquez sur "Clés d'accès" sous "Clé API." Après avoir complété la vérification de sécurité, vous recevrez un "ID de clé d'accès" et un "Secret de clé d'accès." Gardez-les en sécurité.
2. Revenez à l'onglet "Messages domestiques" ou "Messages internationaux/Grande Chine," où vous pouvez facilement trouver le "Nom de la signature" et le "CODE du modèle."
   • Pour utiliser une signature et un modèle spécifiques aux tests, allez à l'onglet "Démarrage rapide" pour les trouver sous "Modèle de signature de test."
3. Complétez la configuration du connecteur SMS de Tencent Cloud :
   • Remplissez accessKeyId et accessKeySecret avec la paire que vous avez obtenue à l'étape 1.
   • Utilisez le "Nom de la signature" de l'étape 2 pour le champ signName. Tous les modèles partageront cette signature.
   • Ajoutez plusieurs modèles SMS pour répondre à différents scénarios utilisateur. Voici un exemple d'ajout d'un seul modèle :
     • Utilisez le "CODE du modèle" de l'étape 2 pour le champ templateCode pour contrôler le contenu du SMS.
     • Le champ usageType doit être l'un de Register, SignIn, ForgotPassword, ou Generic pour correspondre aux scénarios Inscription, Connexion, Mot de passe oublié, ou Général. (L'attribut usageType est spécifique à Logto et détermine le scénario d'utilisation.) Pour une configuration complète, configurez des modèles pour Register, SignIn, ForgotPassword, et Generic.
   • Obtenez l'ID de l'application dans la section Gestion des applications et remplissez-le dans le champ sdkAppId.
   • Référez-vous à la Documentation de l'API SMS pour les régions prises en charge et remplissez le champ region.

Tester le connecteur SMS de Tencent Cloud

Avant de cliquer sur "Enregistrer et terminer," entrez un numéro de téléphone et cliquez sur "Envoyer" pour tester si la configuration fonctionne correctement.

Vous êtes prêt ! Passez à Activer l'inscription ou la connexion par numéro de téléphone.

Schéma de configuration

Nom	Type
accessKeyId	string
accessKeySecret	string
signName	string
region	string
sdkAppId	string
templates	Template[]

Attribut du modèle	Type	Valeurs Enum
templateCode	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Références

• Tencent Cloud : Comment implémenter des codes de vérification par SMS