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, einschließlich SMS (Short Message Service). Der Aliyun SMS Connector ist ein Plugin, das vom Logto-Team bereitgestellt wird, um den Aliyun SMS-Dienst aufzurufen. Mit dessen Hilfe können sich Logto-Endbenutzer über einen SMS-Verifizierungscode bei ihrem Logto-Konto registrieren und anmelden.

Kurznachrichtendienst in der Aliyun SMS-Konsole einrichten

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 eine Vorlagenüberprüfung beantragst, 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. Zu diesem Zeitpunkt 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 sendest.
   • Möglicherweise wirst du auch aufgefordert, eine Testtelefonnummer zu binden, bevor du Testnachrichten sendest. Für weitere Details gehe zur Registerkarte "Schnellstart" (快速学习) in der Seitenleiste der SMS-Dienstkonsole.

Den Connector-JSON erstellen

1. Von der SMS-Dienstkonsole aus, bewege den Mauszeiger über dein Avatar in der oberen rechten Ecke und gehe zu "AccessKey Management" (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, dort findest du leicht "Signatur" (签名名称) und "Vorlagen-Code" (模板 CODE).
   • 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 Zugangsschlüsselpaaren 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 teilen diesen Signaturnamen.
   • 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, mit dem du den SMS-Kontext steuern kannst, mit "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, 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 "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
templates	Template[]

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

Referenzen

Aliyun SMS - Schnellstart