SMS-Verifizierung mit Tencent Short Message Service einrichten

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

tipp:

In diesem Leitfaden gehen wir davon aus, dass du grundlegende Kenntnisse über Logto Connectors hast. Falls nicht, schaue dir den Leitfaden Connectors konfigurieren an, um loszulegen.

Erste Schritte

Tencent Cloud ist ein führender Cloud-Service-Anbieter in Asien und bietet verschiedene Dienste an, einschließlich 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.

Kurznachrichtendienst in Tencent Cloud einrichten

Ein Tencent Cloud-Konto erstellen

Gehe zur 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-Dienstkonsole.
2. Klicke auf der SMS-Dienstseite 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-Konsole Übersicht“ (短信服务控制台概览) basierend auf deinen Bedürfnissen „Inlandsnachrichten“ (国内消息) oder „Internationale/Hongkong, Macao, Taiwan Nachrichten“ (国际/港澳台消息) aus der Seitenleiste.
5. Füge eine Signatur und eine Vorlage für SMS-Nachrichten hinzu. Beachte:
   • Wähle beim Hinzufügen einer „Signatur“ (签名) „Verifizierungscode“ (验证码) unter dem Feld "Anwendbare Szenarien" (模版类型) aus.
   • Wähle beim Hinzufügen einer Vorlage „Verifizierungscode“ als Vorlagentyp.
   • Füge einen Platzhalter {1} in den Vorlageninhalt ein, der durch einen zufällig generierten Code ersetzt wird.
   • Vorlagen mit mehreren Platzhaltern werden nicht unterstützt. Verwende oder erstelle eine Vorlage mit einem einzigen 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-Konsole Übersicht“ (短信服务控制台概览) gesendet werden. Genehmigte Signaturen und Vorlagen können direkt für Tests verwendet werden, oder verwende die bereitgestellten Testvorlagen, wenn sie noch in der Überprüfung sind.
   • Stelle sicher, dass dein Konto über ausreichendes Guthaben für Tests verfügt und registriere die Testtelefonnummer vorab, um SMS erfolgreich zu empfangen.

Für detaillierte Anleitungen klicke auf die Registerkarte „Einsteigerleitfaden“ (新手配置指引) in der SMS-Konsole Übersicht.

Den Connector-JSON zusammenstellen

1. Gehe zur „SMS-Konsole Übersicht“ und fahre mit der Maus über dein Avatar in der oberen rechten Ecke. Navigiere zu „Zugriffsverwaltung > Zugriffsschlüssel > API-Schlüssel“, um deine AccessKey ID und AccessKey Secret nach Abschluss der Sicherheitsüberprüfung zu generieren. Bitte bewahre sie ordnungsgemäß auf.
2. Rufe von der Registerkarte „Inlandsnachrichten“ (国内消息) oder „Internationale/Hongkong, Macao, Taiwan Nachrichten“ (国际/港澳台消息) den „Signaturnamen“ (签名名称) und den „Vorlagencode“ (模版 CODCE) ab.
   • Für Testvorlagen überprüfe die Registerkarte „Schnellstart“ (快速开始) unter "Test-Exklusive Vorlagen" (测试专用签名模版).

• Konfiguriere den Tencent Cloud SMS Connector mit den folgenden Feldern:
  • accessKeyId und accessKeySecret: Verwende die Anmeldedaten aus Schritt 1.
  • signName: Der in Schritt 2 erhaltene Signaturname. Dies gilt für alle Vorlagen.
  • Füge bei Bedarf mehrere Vorlagen für verschiedene Szenarien hinzu. Beispiel für eine einzelne Vorlage:
    • templateCode: Abgerufen aus dem „Vorlagencode“ in Schritt 2.
    • usageType: Gib eine der Optionen Register, SignIn, ForgotPassword oder Generic für verschiedene Szenarien an (Logto-spezifische Eigenschaft).
    • Stelle sicher, dass Vorlagen für alle vier Szenarien konfiguriert sind, um den Ablauf abzuschließen.
  • sdkAppId: Zu finden in der „Anwendungsverwaltung“ (应用管理).
  • region: Gib die unterstützte Region aus der „Versanddokumentation“ (发送文档) an.

Tencent Cloud SMS Connector testen

Du kannst eine Telefonnummer eingeben und auf "Senden" klicken, um zu sehen, ob die Einstellungen funktionieren, bevor du "Speichern und Fertig" auswählst.

Das war's. Vergiss nicht, den Connector in der Anmeldeerfahrung zu aktivieren.

Konfigurationstypen

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

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

Referenzen

• Wie implementiert man die SMS-Verifizierungscode-Funktion?