E-Mail-Verifizierung mit Aliyun Direct Mail einrichten

Der offizielle Logto-Connector für den Aliyun-Connector für den Direct-Mail-Dienst.

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 DM (Direct Mail). Der Aliyun DM Connector ist ein Plugin, das vom Logto-Team bereitgestellt wird, um die Aliyun DM Service APIs aufzurufen. Mit dessen Hilfe können sich Logto-Endbenutzer über einen E-Mail-Verifizierungscode (oder anders gesagt, Verifizierungscode) bei ihrem Logto-Konto registrieren und anmelden.

E-Mail-Dienst in der Aliyun DirectMail-Konsole einrichten

💡 Tipp

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

Ein Aliyun-Konto erstellen

Gehe zu Aliyun und erstelle dein Aliyun-Konto, falls du noch keines hast.

Aliyun Direct Mail aktivieren und konfigurieren

Gehe zur DM-Service-Konsole und melde dich an. Aktiviere den Direct Mail-Dienst, indem du auf die Schaltfläche "Apply to enable" (申请开通) oben links auf der Seite klickst und den Konfigurationsprozess beginnst.

Von der DM-Admin-Konsole aus solltest du:

1. Gehe zu "Email Domains" (发信域名) in der Seitenleiste und füge "New Domain" (新建域名) gemäß den Anweisungen hinzu.
2. Passe "Sender Addresses" (发信地址) und "Email Tags" (邮件标签) jeweils an.

Nach Abschluss der Einrichtung gibt es zwei verschiedene Möglichkeiten zum Testen:

• Gehe zur DirectMail-Übersichtsseite, finde "Operation Guide" (操作引导) unten auf der Seite und klicke auf "Send Emails" (发送邮件). Du findest alle verschiedenen Testmethoden.
• Folge dem Pfad "Send Emails" (发送邮件) -> "Email Tasks" (发送邮件) in der Seitenleiste, um eine Testaufgabe zu erstellen.

Den Connector-JSON zusammenstellen

1. Von der DM-Admin-Konsole aus, bewege den Mauszeiger über dein Avatar in der oberen rechten Ecke und gehe zu "AccessKey Management" (AccessKey 管理) und klicke auf "Create AccessKey" (创建 AccessKey). Du erhältst ein "AccessKey ID" und "AccessKey Secret"-Paar nach Abschluss der Sicherheitsüberprüfung. Bitte bewahre sie ordnungsgemäß auf.
2. Gehe zu den Tabs "Sender Addresses" (发信地址) oder "Email Tags" (邮件标签), die du gerade von der DM-Admin-Konsole besucht hast, du kannst Sender Address oder Email Tag leicht finden.
3. Fülle die Aliyun DM Connector-Einstellungen aus:
   • Fülle die Felder accessKeyId und accessKeySecret mit den Zugangsschlüsselpaaren aus, die du in Schritt 1 erhalten hast.
   • Fülle die Felder accountName und fromAlias mit "Sender Address" und "Email Tag" aus, die in Schritt 2 gefunden wurden. Alle Vorlagen werden diesen Signaturnamen teilen. (Du kannst fromAlias leer lassen, da es OPTIONAL ist.)
   • Du kannst mehrere DM-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 subject aus, das als Titel der zu sendenden E-Mail fungieren wird.
     • Fülle das Feld content mit beliebigen Zeichenfolgeninhalten aus. Vergiss nicht, den Platzhalter {{code}} für den zufälligen Verifizierungscode zu lassen.
     • 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 DM Connector testen

Du kannst eine E-Mail-Adresse eingeben und auf "Send" klicken, um zu sehen, ob die Einstellungen funktionieren, bevor du "Save and Done" auswählst.

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

Konfigurationstypen

Name	Typ
accessKeyId	string
accessKeySecret	string
accountName	string
fromAlias	string (OPTIONAL)
templates	Template[]

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