E-Mail-Verifizierung mit Aliyun Direct Mail einrichten

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

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

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

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 beginne mit dem Konfigurationsprozess.

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" (邮件标签) entsprechend 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" (发送邮件). Dort findest du alle verschiedenen Testmethoden.
• Folge dem Pfad "Send Emails" (发送邮件) -> "Email Tasks" (发送邮件) in der Seitenleiste, um eine Testaufgabe zu erstellen.

Den Connector-JSON erstellen

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 sicher auf.
2. Gehe zu den Tabs "Sender Addresses" (发信地址) oder "Email Tags" (邮件标签), die du gerade von der DM-Admin-Konsole besucht hast, dort findest du Sender Address oder Email Tag leicht.
3. Fülle die Aliyun DM 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 die Felder accountName und fromAlias mit "Sender Address" und "Email Tag" aus, die in Schritt 2 gefunden wurden. Alle Vorlagen teilen diesen Signaturnamen. (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 fungiert.
     • 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'