SMS-Verifizierung mit Aliyun Short Message Service einrichten

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

Aliyun ist ein führender Cloud-Service-Anbieter in Asien und bietet viele Cloud-Dienste an, einschließlich SMS (Short Message Service). Der Aliyun SMS Connector ist ein von Logto bereitgestelltes Plugin, um den Aliyun SMS-Dienst zu nutzen, mit dessen Hilfe sich Logto-Endbenutzer über einen SMS-Verifizierungscode bei ihrem Logto-Konto registrieren und anmelden können.

Kurznachrichtendienst in der Aliyun SMS-Konsole einrichten

💡 Tipp

Du kannst einige Abschnitte überspringen, wenn du sie bereits abgeschlossen hast.

Ein Aliyun-Konto erstellen

Gehe zur 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-Dienstkonsole.
2. Klicke auf die Schaltfläche "Kostenlos öffnen" (免费开通) oben links auf der SMS-Dienstseite und beginne mit dem Konfigurationsprozess.
3. Lies und stimme der "SMS-Dienstaktivierungsvereinbarung" (短信服务开通条款) zu und klicke auf "Dienst abonnieren" (开通服务), um fortzufahren.
4. Du befindest dich nun auf der SMS-Dienstkonsole, gehe je nach Anwendungsfall zur Schaltfläche "Festlandchina" (国内消息) oder "Außerhalb Festlandchina" (国际/港澳台消息) in der Seitenleiste.
5. Füge Signatur und Vorlage gemäß den Richtlinien hinzu und stelle die erforderlichen Materialien oder Informationen zur Überprüfung bereit.
   • Denke daran, "Verifizierungscode-Nachricht" (验证码) als "Szenario" (适用场景) auszuwählen, wenn du den Signaturantrag ausfüllst, und auch "Verifizierungscode-Nachricht" (验证码) für "Typ" (模板类型), wenn du einen Vorlagenantrag stellst, da wir diese Signaturen und Vorlagen verwenden, um Verifizierungscodes zu senden. Derzeit unterstützen wir das Senden von SMS-Nachrichten, die nicht mit Verifizierungscodes zusammenhängen, nicht.
   • Verwende {{code}} als Platzhalter, wo du deinen digitalen Verifizierungscode in den Vorlageninhalten platzieren möchtest.
6. Nachdem du deinen SMS-Signatur- und Vorlagenantrag eingereicht hast, musst du warten, bis er wirksam wird. An diesem Punkt können wir zur SMS-Dienstkonsole zurückkehren und eine Test-SMS senden. Wenn deine Signaturen und Vorlagen einsatzbereit sind, kannst du sie direkt ausprobieren; wenn sie noch nicht wirksam sind, bietet Aliyun auch Testvorlagen an.
   • Möglicherweise musst du einen kleinen Betrag aufladen, bevor du Testnachrichten senden kannst.
   • Möglicherweise wirst du auch aufgefordert, eine Testtelefonnummer zu binden, bevor du Testnachrichten senden kannst. Für weitere Details gehe zur Registerkarte "Schnellstart" (快速学习) in der Seitenleiste der SMS-Dienstkonsole.

Den Connector-JSON zusammenstellen

1. Von der SMS-Dienstkonsole aus, bewege den Mauszeiger über dein Avatar in der oberen rechten Ecke und gehe zu "AccessKey-Verwaltung" (AccessKey 管理) und klicke auf "AccessKey erstellen" (创建 AccessKey). Du erhältst ein "AccessKey ID" und "AccessKey Secret"-Paar nach Abschluss der Sicherheitsüberprüfung. Bitte bewahre sie ordnungsgemäß auf.
2. Gehe zur Registerkarte "Festlandchina" (国内消息) oder "Außerhalb Festlandchina" (国际/港澳台消息), die du gerade besucht hast, du kannst "Signatur" (签名名称) und "Vorlagen-Code" (模板 CODE) leicht finden.
   • Wenn du die nur für Tests vorgesehene Signatur und Vorlage verwenden möchtest, gehe stattdessen zur Registerkarte "Schnellstart" (快速学习), und du findest sie unter "Signatur & Vorlagen (Nur für Tests)".
3. Fülle die Aliyun SMS Connector-Einstellungen aus:
   • Fülle die Felder accessKeyId und accessKeySecret mit den Access-Key-Paaren aus, die du in Schritt 1 erhalten hast.
   • Fülle das Feld signName mit "Signatur" (签名名称) aus, die in Schritt 2 erwähnt wird. Alle Vorlagen werden diesen Signaturnamen teilen.
   • Du kannst mehrere SMS-Connector-Vorlagen für verschiedene Fälle hinzufügen. Hier ist ein Beispiel für das Hinzufügen einer einzelnen Vorlage:
     • Fülle das Feld templateCode aus, mit dem du den SMS-Kontext steuern kannst, mit "Vorlagen-Code" (模板 CODE) aus Schritt 2.
     • Fülle das Feld usageType mit entweder Register, SignIn, ForgotPassword oder Generic für verschiedene Anwendungsfälle aus. (usageType ist eine Logto-Eigenschaft, um den richtigen Anwendungsfall zu identifizieren.) Um vollständige Benutzerflüsse zu ermöglichen, sind Vorlagen mit usageType Register, SignIn, ForgotPassword und Generic erforderlich.

Aliyun SMS Connector testen

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

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

Konfigurationstypen

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

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

Referenzen

• Aliyun SMS - Schnellstart