Zum Hauptinhalt springen

E-Mail-Connectors

Ein E-Mail-Connector integriert deinen E-Mail-Zustelldienst mit Logto, um eine sichere Benutzerverifizierung per E-Mail zu ermöglichen. Nach der Konfiguration kannst du Einmalpasswörter (OTPs) für Benutzer Registrierung, Anmeldung, Passwortzurücksetzung, Kontoverknüpfung, Mitgliedereinladungen und Validierung von Hochrisikooperationen senden.

Wähle deinen E-Mail-Connector​

Logto bietet drei Arten von E-Mail-Connector-Optionen:

Kostenloser Logto E-Mail-Dienst (nur Cloud)​

Diese integrierte E-Mail-Dienstoption ist ideal, um schnell sowohl für Tests als auch für Produktion zu starten. Sie eliminiert die Notwendigkeit für Drittanbieter-Integrationen und bietet eine kostenlose, zuverlässige E-Mail-Zustellung. Passe einfach dein grundlegendes Branding für die vorgefertigten E-Mail-Vorlagen an.

Der Logto E-Mail-Dienst-Connector bietet jetzt Möglichkeiten zur markenspezifischen Anpassung, einschließlich Logo, Unternehmensinformationen und Absendername.

Es gibt jedoch einige Einschränkungen, die zu beachten sind — du kannst die E-Mail-Adresse des Absenders, die Domain oder den spezifischen E-Mail-Inhalt nicht anpassen.

Verbinde dich mit deinem bevorzugten E-Mail-Dienstanbieter (ESP) mithilfe der Schritt-für-Schritt-Anleitungen von Logto.

Diese Optionen ermöglichen es dir, deine E-Mail-Vorlage, den Absendernamen usw. vollständig anzupassen, um dein Branding bestmöglich zu unterstützen.

Wir bieten sofort einsatzbereite Unterstützung für die folgenden E-Mail-Dienstanbieter:

Passe deinen E-Mail-Connector an​

Wenn keine der oben genannten Lösungen deinen Anforderungen entspricht, kannst du dich auch dafür entscheiden, dich mit deinem gewünschten E-Mail-Dienst über das Simple Mail Transfer Protocol (SMTP) zu verbinden.

Wenn du bereits deinen eigenen E-Mail-Dienst hast und nicht für die Verwendung einer SMTP-Verbindung in Frage kommst, bieten wir auch einen "HTTP E-Mail-Connector" an.

Wenn eine E-Mail gesendet werden muss, sendet er einen API-Aufruf an den konfigurierten endpoint, um den E-Mail-abhängigen Auth-Flow abzuschließen. Beachte, dass zur Vermeidung von Auth-Flow-Fehlern der konfigurierte Endpoint nach Erhalt des WebHooks eine 200-Antwort zurückgeben muss, um Logto zu informieren, dass die Benachrichtigung zum Senden der E-Mail empfangen wurde. In diesem Fall musst du deinen eigenen E-Mail-Dienst überwachen, um eine erfolgreiche Zustellung sicherzustellen.

Wenn unsere Standard-Connectors nicht deinen spezifischen Anforderungen entsprechen, zögere nicht, uns zu kontaktieren. Für OSS-Benutzer kannst du deinen Connector implementieren (OSS), wenn die Anforderung dringend ist. Wir begrüßen immer Beiträge; dein Einsatz könnte anderen Community-Mitgliedern mit denselben Bedürfnissen sehr helfen.

Konfigurationsschritte​

Folge den untenstehenden Schritten, um einen E-Mail-Connector hinzuzufügen:

  1. Navigiere zu Konsole > Connectors > E-Mail und SMS Connectors .
  2. Um einen neuen E-Mail-Connector hinzuzufügen, klicke auf die Schaltfläche "Einrichten" und wähle deinen gewünschten E-Mail-Anbieter aus.
  3. Überprüfe die README-Dokumentation und konfiguriere deinen gewählten Anbieter Schritt für Schritt.
  4. Klicke auf "Speichern und Fertig", um abzuschließen.

E-Mail-Connector ändern​

Du wirst feststellen, dass nur ein E-Mail-Connector hinzugefügt werden kann.

Wenn du bereits einen E-Mail-Connector hast, kannst du nur "E-Mail-Connector ändern" auswählen. Bei der Durchführung dieser Operation in der Konsole wird sie sofort wirksam, sobald sie gespeichert ist. Bitte teste daher deine Konfiguration, bevor du speicherst.

Um die Stabilität deines Dienstes zu gewährleisten, können Cloud-Benutzer einen Entwicklermandanten für die Entwicklungsumgebung erstellen. Nach dem Testen der Konfiguration in der Entwicklungsumgebung "migriere" die Konfiguration in die Produktion und speichere dann die Einrichtung.

E-Mail-Registrierung oder -Anmeldung aktivieren​

Sobald du den E-Mail-Connector erfolgreich hinzugefügt und die Konfiguration abgeschlossen hast, kannst du Anmelde- und Registrierungs-Konfigurationen aktivieren, die auf E-Mail + Bestätigungscode basieren, entsprechend deinen geschäftlichen Anforderungen.

  1. Navigiere zu: Konsole > Anmeldeerfahrung > Registrierung und Anmeldung
  2. Registrierungsmethoden festlegen: Wähle "E-Mail-Adresse" oder "E-Mail-Adresse oder Telefonnummer" als Registrierungskennzeichen. Hinweis: Die E-Mail-Verifizierung ist derzeit bei der Registrierung obligatorisch.
  3. Anmeldemethoden festlegen: Das gewählte Registrierungskennzeichen wird automatisch zu einer Anmeldemethode. Klicke auf "Weitere hinzufügen" für zusätzliche Anmeldeoptionen.
  4. Änderungen speichern und testen: Klicke auf "Änderungen speichern", um die neue Anmeldeerfahrung zu implementieren. Denke daran, die Funktionalität mit der "Live-Vorschau" zu testen.
warnung:

Da unsere Konfigurationen sofort wirksam werden, kann das Löschen eines vorhandenen E-Mail-Connectors die normalen Anmelde- und Registrierungsprozesse der Endbenutzer beeinträchtigen.

Zum Beispiel, wenn das Anmeldekennzeichen die Kombination "E-Mail + Bestätigungscode" enthält, verhindert das Löschen des vorhandenen E-Mail-Connectors, dass Benutzer Bestätigungscodes per E-Mail erhalten, und führt zu einem Fehler im Anmeldefluss.

Bitte sei dir der potenziellen Risiken bewusst, wenn du an Connectors arbeitest.

FAQs​

Wie kann ich den Namen des E-Mail-Absenders anpassen?​

Wir arbeiten noch an weiteren Connectors. Wenn du weitere Optionen benötigst, lass uns einfach deine Bedürfnisse in Discord wissen und reiche eine Funktionsanfrage auf GitHub ein. Wenn du weitere Unterstützung benötigst, kannst du uns auch per E-Mail kontaktieren.

Für Mitwirkende bieten wir eine einfach zu erweiternde Connector-Erstellungsmethode an, die es dir ermöglicht, deinen eigenen Connector anzupassen basierend auf deinen spezifischen Szenarien. Du bist immer willkommen, einen Pull-Request an Logto zu senden, damit auch andere in der Community von deiner Arbeit profitieren können.

Wie kann ich IP-Adressen für E-Mail-Anfragen in Logto E-Mail-Connectors einschränken?​

Ein Workaround ist die Verwendung des Logto HTTP E-Mail-Connectors.

Implementiere einen API-Endpunkt auf deinem Server, der den entsprechenden E-Mail-Dienst aufruft, und löse diesen API-Endpunkt über den Logto HTTP E-Mail-Connector aus. Auf diese Weise hast du die vollständige Kontrolle über die IP-Adresse deines API-Endpunkts und kannst die entsprechenden IP-Adressen zur Whitelist in der Konfiguration des E-Mail-Dienstanbieters hinzufügen.