SMS-Verifizierung mit Tencent Short Message Service einrichten

Der offizielle Logto Connector für den Tencent Short Message Service.

tipp:

Diese Anleitung setzt voraus, dass du ein grundlegendes Verständnis von Logto Connectors hast. Für diejenigen, die damit nicht vertraut sind, verweisen wir auf die Connectors Anleitung, um loszulegen.

Erste Schritte

Tencent Cloud ist ein führender Cloud-Service-Anbieter in Asien und bietet verschiedene Dienste an, darunter SMS (Short Message Service).

Der Tencent Short Message Service Connector ist eine offizielle Logto-Integration, die Endbenutzern hilft, sich mit SMS-Verifizierungscodes zu registrieren oder anzumelden.

Short Message Service in Tencent Cloud einrichten

Ein Tencent Cloud-Konto erstellen

Gehe auf die Tencent Cloud Website und registriere dein Konto, falls du noch keines hast.

Tencent Cloud SMS aktivieren und konfigurieren

1. Melde dich mit deinem Konto auf der Tencent Cloud Website an und gehe zur SMS-Service-Konsole.
2. Klicke auf der SMS-Service-Seite auf die Schaltfläche „Kostenlose Testversion“ (免费试用) und folge den Einrichtungsschritten.
3. Stimme den „Bedingungen zur Aktivierung des SMS-Dienstes“ (短信开通服务条款) zu und klicke auf „Dienst aktivieren“ (开通服务), um fortzufahren.
4. Wähle in der “SMS Console Overview” (短信服务控制台概览) je nach Bedarf „Inländische Nachrichten“ (国内消息) oder „Internationale / Hongkong, Macao, Taiwan Nachrichten“ (国际/港澳台消息) aus der Seitenleiste.
5. Füge eine Signatur und eine Vorlage für SMS-Nachrichten hinzu. Hinweis:
   • Wähle beim Hinzufügen einer „Signatur“ (签名) unter dem Feld "Anwendbare Szenarien" (模版类型) „Verifizierungscode“ (验证码) aus.
   • Wähle beim Hinzufügen einer Vorlage „Verifizierungscode“ als Vorlagentyp.
   • Füge im Vorlageninhalt einen Platzhalter {1} ein, der durch einen zufällig generierten Code ersetzt wird.
   • Vorlagen mit mehreren Platzhaltern werden nicht unterstützt. Verwende oder erstelle eine Vorlage mit nur einem Platzhalter.
6. Reiche die Signatur und die Vorlage zur Genehmigung ein. Nach der Einreichung:
   • Warte, bis sie wirksam werden.
   • Test-SMS können von der “SMS Console Overview” (短信服务控制台概览) gesendet werden. Genehmigte Signaturen und Vorlagen können direkt zum Testen verwendet werden, oder verwende die bereitgestellten Testvorlagen, falls sie noch geprüft werden.
   • Stelle sicher, dass dein Konto über ausreichend Guthaben für Tests verfügt und registriere die Test-Telefonnummer vorab, um SMS erfolgreich zu empfangen.

Für eine detaillierte Anleitung klicke auf den Tab „Getting Started Guide“ (新手配置指引) in der SMS Console Overview.

Connector-JSON zusammenstellen

1. Gehe zur “SMS Console Overview” und fahre mit der Maus über dein Avatar oben rechts. Navigiere zu „Access Management > Access Keys > API Keys“, um nach Abschluss der Sicherheitsüberprüfung deine AccessKey ID und AccessKey Secret zu generieren. Bitte bewahre sie sicher auf.
2. Rufe im Tab „Inländische Nachrichten“ (国内消息) oder „Internationale / Hongkong, Macao, Taiwan Nachrichten“ (国际/港澳台消息) den „Signaturnamen“ (签名名称) und den „Vorlagencode“ (模版 CODCE) ab.
   • Für Testvorlagen prüfe den Tab „Getting Started“ (快速开始) unter "Test-Exclusive Templates" (测试专用签名模版).

• Konfiguriere den Tencent Cloud SMS Connector mit den folgenden Feldern:
  • accessKeyId und accessKeySecret: Verwende die Zugangsdaten aus Schritt 1.
  • signName: Der in Schritt 2 erhaltene Signaturname. Gilt für alle Vorlagen.
  • Füge bei Bedarf mehrere Vorlagen für verschiedene Szenarien hinzu. Beispiel für eine einzelne Vorlage:
    • templateCode: Aus dem „Vorlagencode“ in Schritt 2 übernommen.
    • usageType: Gib für verschiedene Szenarien eines der folgenden an: Register, SignIn, ForgotPassword oder Generic (Logto-spezifische Eigenschaft).
    • Stelle sicher, dass Vorlagen für alle vier Szenarien konfiguriert sind, um den Ablauf zu vervollständigen.
  • sdkAppId: Zu finden unter “Application Management” (应用管理).
  • region: Gib die unterstützte Region aus der “Sending Documentation” (发送文档) an.

Tencent Cloud SMS Connector testen

Du kannst eine Telefonnummer eingeben und auf "Senden" klicken, um zu prüfen, ob die Einstellungen funktionieren, bevor du auf "Speichern und Fertig" klickst.

Das war's. Vergiss nicht, den Connector für die Anmeldung und Registrierung zu aktivieren.

Konfigurationstypen

Name	Typ
accessKeyId	string
accessKeySecret	string
signName	string
region	string
sdkAppId	string
templates	Template[]

Template-Eigenschaften	Typ	Enum-Werte
templateCode	string	N/A
usageType	enum string	'Register' / 'SignIn' / 'ForgotPassword' / 'Generic'

Referenzen

Wie implementiere ich die SMS-Verifizierungscode-Funktion?