Zum Hauptinhalt springen

E-Mail-Verifizierung per HTTP-Aufruf einrichten

Der offizielle Logto Connector für HTTP-E-Mail.

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​

Der HTTP-E-Mail-Connector ermöglicht es dir, E-Mails über einen HTTP-Aufruf zu versenden. Um den HTTP-E-Mail-Connector zu verwenden, benötigst du einen eigenen E-Mail-Dienst, der eine HTTP-API zum Versenden von E-Mails bereitstellt. Logto ruft diese API auf, wenn eine E-Mail gesendet werden muss. Zum Beispiel, wenn sich ein Benutzer registriert, ruft Logto die HTTP-API auf, um eine Verifizierungs-E-Mail zu senden.

HTTP-E-Mail-Connector einrichten​

Um den HTTP-E-Mail-Connector zu verwenden, musst du einen HTTP-Endpunkt einrichten, den Logto aufrufen kann. Optional kannst du ein Autorisierungstoken für den Endpunkt festlegen.

Nutzlast​

Der HTTP-E-Mail-Connector sendet beim Auslösen einer E-Mail eine Nutzlast an den Endpunkt. Sie enthält die E-Mail-Adresse des Empfängers (to), den E-Mail-usageType, der den Authentifizierungsablauf angibt (type), ein payload mit verfügbaren Variablen (z. B. Verifizierungscode, Link, Anwendungsinformationen, Organisationsinformationen, Benutzerinformationen) und die locale des Benutzers sowie ein optionales ip-Feld mit der IP-Adresse des Clients (falls verfügbar).

Beispiel:

{
  "to": "foo@logto.io",
  "type": "SignIn",
  "payload": {
    "code": "123456",
    "locale": "de"
  },
  "ip": "192.168.1.1"
}

Das Feld ip kann für Ratenbegrenzung, Betrugserkennung oder erweitertes Logging verwendet werden.

Du kannst diese Informationen nutzen, um E-Mail-Vorlagen bei deinem E-Mail-Anbieter individuell anzupassen.

Alle verfügbaren Typen findest du unter E-Mail-Vorlage. Die vollständige Definition des Typs SendMessageData findest du im connector-kit.