E-Mail-Verifizierung mit Aliyun Direct Mail einrichten

Der offizielle Logto Connector für den Aliyun Connector für den Direct Mail 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 DM (Direct Mail). Der Aliyun DM Connector ist ein Plugin, das vom Logto-Team bereitgestellt wird, um die Aliyun DM Service-APIs aufzurufen. Damit können Logto-Endbenutzer sich per E-Mail-Verifizierungscode (oder anders gesagt, Verifizierungscode) für ihr Logto-Konto registrieren und anmelden.

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

Aliyun-Konto erstellen

Gehe zu Aliyun und erstelle ein 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 Service, indem du oben links auf der Seite auf die Schaltfläche „Apply to enable“ (申请开通) klickst und beginne mit der Konfiguration.

Von der DM-Admin-Konsole aus solltest du:

1. Gehe im Seitenmenü zu „Email Domains“ (发信域名) und füge eine „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 unten auf der Seite den „Operation Guide“ (操作引导) und klicke auf „Send Emails“ (发送邮件). Dort findest du alle verschiedenen Testmethoden.
• Folge dem Pfad „Send Emails“ (发送邮件) -> „Email Tasks“ (发送邮件) im Seitenmenü, um eine Testaufgabe zu erstellen.

Connector-JSON zusammenstellen

1. Gehe von der DM-Admin-Konsole aus mit der Maus auf dein Avatar oben rechts und gehe zu „AccessKey Management“ (AccessKey 管理) und klicke auf „Create AccessKey“ (创建 AccessKey). Nach Abschluss der Sicherheitsüberprüfung erhältst du ein „AccessKey ID“ und „AccessKey Secret“-Paar. Bitte bewahre diese sicher auf.
2. Gehe zum Tab „Sender Addresses“ (发信地址) oder „Email Tags“ (邮件标签), den du gerade in der DM-Admin-Konsole besucht hast. Dort findest du leicht die Sender Address oder Email Tag.
3. Fülle die Einstellungen für den Aliyun DM Connector aus:
   • Trage in die Felder accessKeyId und accessKeySecret das Access Key-Paar aus Schritt 1 ein.
   • Trage in die Felder accountName und fromAlias die „Sender Address“ und „Email Tag“ aus Schritt 2 ein. Alle Vorlagen teilen sich diesen Signaturnamen. (fromAlias kann leer bleiben, da es OPTIONAL ist.)
   • Du kannst mehrere DM-Connector-Vorlagen für verschiedene Fälle hinzufügen. Hier ein Beispiel für das Hinzufügen einer einzelnen Vorlage:
     • Fülle das Feld subject aus, das als Betreff der versendeten E-Mail dient.
     • Fülle das Feld content mit beliebigem Textinhalt 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 zur Identifizierung des passenden Anwendungsfalls.) Um vollständige Benutzerflüsse zu ermöglichen, sind Vorlagen mit den usageTypes Register, SignIn, ForgotPassword und Generic erforderlich.

Aliyun DM Connector testen

Du kannst eine E-Mail-Adresse 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
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'