Zum Hauptinhalt springen

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.

Tencent Cloud SMS Service Logto Offizieller Connector Dokumentation auf Chinesisch

Tencent Cloud SMS Connector

Tencent Cloud ist ein führender Cloud-Service-Anbieter in Asien und bietet eine breite Palette von Diensten an, einschließlich SMS.

Dieser von Logto offiziell bereitgestellte Connector ermöglicht es Endbenutzern, sich über SMS-Verifizierungscodes zu registrieren und anzumelden.

Konfigurieren eines SMS-Dienstes in der Tencent Cloud SMS-Konsole

💡 Tipp

Du kannst Teile überspringen, die du bereits abgeschlossen hast.

Ein Tencent Cloud-Konto erstellen

Gehe zu Tencent Cloud und schließe die Kontoanmeldung ab.

Tencent Cloud SMS-Dienst aktivieren und konfigurieren

  1. Melde dich mit deinem neu registrierten Konto bei Tencent Cloud an und navigiere zur SMS-Dienstkonsole.
  2. Klicke auf die Schaltfläche "Kostenlose Testversion" oben links auf der SMS-Dienstseite, um den Einrichtungsprozess zu starten.
  3. Stimme den "Nutzungsbedingungen für den SMS-Dienst" zu und aktiviere den Dienst, um fortzufahren.
  4. Du befindest dich nun in der "SMS-Dienstkonsole Übersicht." Je nach Anwendungsfall klicke in der Seitenleiste auf "Inlandsnachrichten" oder "Internationale/Großchina-Nachrichten".
  5. Folge den Anweisungen, um eine Signatur und Vorlagen hinzuzufügen und die erforderlichen Materialien zur Genehmigung bereitzustellen:
    • Hinweis: Wähle beim Hinzufügen einer Signatur "Verifizierungscode" unter "Anwendungsszenario". Ähnlich wähle beim Hinzufügen einer Vorlage "Verifizierungscode" unter "Vorlagentyp", da es hier darum geht, Verifizierungscodes zu senden. Das Senden anderer Arten von Textnachrichten wird derzeit nicht unterstützt.
    • Stelle sicher, dass dein Vorlageninhalt einen {1}-Platzhalter enthält, der durch einen zufällig generierten Verifizierungscode ersetzt wird, wenn die SMS gesendet wird.
    • Es werden nur Vorlagen mit einem einzigen Platzhalter unterstützt. Wähle oder erstelle Vorlagen mit nur einem Platzhalter.
  6. Nachdem du die Signatur- und Vorlagenanträge eingereicht hast, warte auf deren Genehmigung. In der Zwischenzeit kannst du zur SMS-Dienstkonsole Übersicht zurückkehren, um Testnachrichten zu senden. Wenn deine Signatur und Vorlage genehmigt sind, verwende sie direkt für Tests. Wenn nicht, stellt Tencent Testvorlagen bereit.
    • Möglicherweise musst du dein Konto mit einem kleinen Betrag aufladen, bevor du Testnachrichten senden kannst.
    • Binde die Telefonnummer, die du für Tests verwenden möchtest, im Voraus, um den erfolgreichen Empfang der Testnachrichten sicherzustellen. Klicke auf die Registerkarte "Anfängerleitfaden" oben in der SMS-Dienstkonsole Übersicht für weitere Details.

Schreibe die JSON-Konfiguration des Connectors

  1. Gehe zur SMS-Dienstkonsole Übersicht, fahre mit der Maus über dein Profil oben rechts, navigiere zu "Zugriffsverwaltung" und klicke auf "Zugriffsschlüssel" unter "API-Schlüssel." Nach Abschluss der Sicherheitsüberprüfung erhältst du eine "AccessKey ID" und ein "AccessKey Secret." Bewahre sie sicher auf.
  2. Navigiere zurück zur Registerkarte "Inlandsnachrichten" oder "Internationale/Großchina-Nachrichten", wo du leicht den "Signaturnamen" und den "Vorlagen-CODE" finden kannst.
    • Um eine testspezifische Signatur und Vorlage zu verwenden, gehe zur Registerkarte "Schnellstart", um sie unter "Testsignaturvorlage" zu finden.
  3. Schließe die Einrichtung des Tencent Cloud SMS Connectors ab:
    • Fülle accessKeyId und accessKeySecret mit dem Paar aus, das du in Schritt 1 erhalten hast.
    • Verwende den "Signaturnamen" aus Schritt 2 für das Feld signName. Alle Vorlagen werden diese Signatur teilen.
    • Füge mehrere SMS-Vorlagen hinzu, um verschiedene Benutzerszenarien abzudecken. Unten ist ein Beispiel für das Hinzufügen einer einzelnen Vorlage:
      • Verwende den "Vorlagen-CODE" aus Schritt 2 für das Feld templateCode, um den Inhalt der SMS zu steuern.
      • Das Feld usageType sollte eines von Register, SignIn, ForgotPassword oder Generic sein, um den Szenarien Registrierung, Anmeldung, Passwort vergessen oder Allgemein zu entsprechen. (Das Attribut usageType ist spezifisch für Logto und bestimmt das Nutzungsszenario.) Für eine vollständige Einrichtung konfiguriere Vorlagen für Register, SignIn, ForgotPassword und Generic.
    • Erhalte die App-ID aus dem Abschnitt Anwendungsverwaltung und fülle sie im Feld sdkAppId aus.
    • Siehe die SMS-API-Dokumentation für unterstützte Regionen und fülle das Feld region aus.

Teste den Tencent Cloud SMS Connector

Bevor du auf "Speichern und Abschließen" klickst, gib eine Telefonnummer ein und klicke auf "Senden", um zu testen, ob die Konfiguration korrekt funktioniert.

Alles ist bereit! Fahre fort mit Telefonnummernregistrierung oder -anmeldung aktivieren.

Konfigurationsschema

NameTyp
accessKeyIdstring
accessKeySecretstring
signNamestring
regionstring
sdkAppIdstring
templatesTemplate[]
VorlagenattributTypEnum-Werte
templateCodestringN/A
usageTypeenum string'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Referenzen