SMS-Verifizierung mit Aliyun Short Message Service einrichten

Der offizielle Logto Connector für den Aliyun 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

Aliyun ist ein führender Cloud-Service-Anbieter in Asien und bietet viele Cloud-Dienste an, darunter SMS (Short Message Service). Der Aliyun SMS Connector ist ein Plugin, das vom Logto-Team bereitgestellt wird, um den Aliyun SMS-Dienst anzusprechen. Damit können Logto-Endbenutzer sich per SMS-Verifizierungscode registrieren und bei ihrem Logto-Konto anmelden.

Short Message Service in der Aliyun SMS-Konsole einrichten

Aliyun-Konto erstellen

Gehe auf die Aliyun-Website und registriere dein Aliyun-Konto, falls du noch keines hast.

Aliyun Short Message Service aktivieren und konfigurieren

1. Melde dich mit deinem Aliyun-Konto auf der Aliyun-Website an und gehe zur SMS-Service-Konsole.
2. Klicke auf die Schaltfläche „Kostenlos öffnen“ (免费开通) oben links auf der SMS-Service-Seite und beginne mit der Konfiguration.
3. Lies und akzeptiere die „SMS-Service-Aktivierungsvereinbarung“ (短信服务开通条款) und klicke auf „Dienst abonnieren“ (开通服务), um fortzufahren.
4. Du befindest dich nun auf der SMS-Service-Konsole. Gehe je nach Anwendungsfall entweder auf „Festlandchina“ (国内消息) oder „Außerhalb Festlandchina“ (国际/港澳台消息) in der Seitenleiste.
5. Füge Signatur und Vorlage gemäß den Richtlinien hinzu und reiche die erforderlichen Materialien oder Informationen zur Überprüfung ein.
   • Denke daran, beim Ausfüllen des Signaturantrags „Verifizierungscode-Nachricht“ (验证码) als „Szenario“ (适用场景) auszuwählen und auch „Verifizierungscode-Nachricht“ (验证码) als „Typ“ (模板类型) bei der Beantragung der Vorlagenüberprüfung, da wir diese Signaturen und Vorlagen zum Versenden von Verifizierungscodes verwenden. Derzeit unterstützen wir das Versenden von SMS-Nachrichten, die nicht mit Verifizierungscodes zusammenhängen, nicht.
   • Verwende außerdem {{code}} als Platzhalter an der Stelle, an der du deinen digitalen Verifizierungscode im Vorlagentext einfügen möchtest.
6. Nachdem du deine SMS-Signatur und Vorlagenanträge eingereicht hast, musst du warten, bis sie wirksam werden. An diesem Punkt kannst du zur SMS-Service-Konsole zurückkehren und eine Test-SMS senden. Wenn deine Signaturen und Vorlagen einsatzbereit sind, kannst du sie direkt ausprobieren; falls sie noch nicht wirksam sind, stellt Aliyun auch Testvorlagen zur Verfügung.
   • Möglicherweise musst du vor dem Versenden von Testnachrichten einen kleinen Betrag aufladen.
   • Es kann auch sein, dass du vor dem Versenden von Testnachrichten eine Test-Telefonnummer binden musst. Weitere Details findest du im Tab „Schnellstart“ (快速学习) in der Seitenleiste der SMS-Service-Konsole.

Connector-JSON zusammenstellen

1. Gehe von der SMS-Service-Konsole aus mit der Maus auf dein Avatar oben rechts und gehe zu „AccessKey-Verwaltung“ (AccessKey 管理) und klicke auf „AccessKey erstellen“ (创建 AccessKey). Nach Abschluss der Sicherheitsüberprüfung erhältst du ein „AccessKey ID“ und „AccessKey Secret“-Paar. Bitte bewahre diese sicher auf.
2. Gehe zu dem Tab „Festlandchina“ (国内消息) oder „Außerhalb Festlandchina“ (国际/港澳台消息), den du gerade besucht hast. Dort findest du „Signatur“ (签名名称) und „Vorlagen-Code“ (模板 CODE) leicht.
   • Wenn du die nur für Tests vorgesehenen Signaturen und Vorlagen verwenden möchtest, gehe stattdessen zum Tab „Schnellstart“ (快速学习). Dort findest du sie unter „Signatur & Vorlagen (nur für Tests)“.
3. Fülle die Einstellungen für den Aliyun SMS Connector aus:
   • Trage in die Felder accessKeyId und accessKeySecret die Access-Key-Paare aus Schritt 1 ein.
   • Trage in das Feld signName die „Signatur“ (签名名称) aus Schritt 2 ein. Alle Vorlagen teilen sich diesen Signaturnamen.
   • Du kannst mehrere SMS-Connector-Vorlagen für verschiedene Fälle hinzufügen. Hier ein Beispiel für das Hinzufügen einer einzelnen Vorlage:
     • Fülle das Feld templateCode, mit dem du den SMS-Kontext steuerst, mit dem „Vorlagen-Code“ (模板 CODE) aus Schritt 2 aus.
     • Fülle das Feld usageType mit entweder Register, SignIn, ForgotPassword oder Generic für verschiedene Anwendungsfälle aus. (usageType ist eine Logto-Eigenschaft zur Identifizierung des passenden Anwendungsfalls.) Um vollständige Benutzerflüsse zu ermöglichen, sind Vorlagen mit den usageTypes Register, SignIn, ForgotPassword und Generic erforderlich.
4. „Strikte Überprüfung der Telefon-Regionnummer“ einrichten:
   • Aktiviere diese Option, wenn du SMS an ausländische Telefonnummern (Regionen außerhalb Festlandchina wie USA, HK usw.) senden musst. Wenn aktiviert, geht der Connector davon aus, dass alle Telefonnummern gültige Regionscodes enthalten (z. B. +1, +852), um zu bestimmen, ob sie zu Festlandchina gehören.
   • Achtung: Wenn deine bestehenden Benutzer Telefonnummern ohne Regionscodes haben, kann das Aktivieren dieser Option deren Anmeldeprozess beeinträchtigen. Nur aktivieren, wenn für den Versand von SMS ins Ausland erforderlich.

Aliyun 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 Anmeldung und Registrierung zu aktivieren.

Konfigurationstypen

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

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

Referenzen

Aliyun SMS – Schnellstart