SMS-Verifizierung mit HTTP SMS einrichten

Der offizielle Logto Connector für HTTP SMS.

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 SMS Connector ermöglicht es dir, SMS-Nachrichten per HTTP-Aufruf zu versenden. Um den HTTP SMS Connector zu verwenden, benötigst du einen eigenen SMS-Dienst, der eine HTTP-API zum Versenden von SMS-Nachrichten bereitstellt. Logto ruft diese API auf, wenn eine SMS gesendet werden muss. Zum Beispiel: Wenn sich ein Benutzer registriert, ruft Logto die HTTP-API auf, um eine Verifizierungs-SMS zu senden.

HTTP SMS Connector einrichten

Um den HTTP SMS Connector zu verwenden, musst du einen HTTP-Endpunkt einrichten, den Logto aufrufen kann, sowie optional ein Autorisierungstoken für den Endpunkt.

tipp:

Beachte, dass zur Vermeidung von Fehlern im Authentifizierungsablauf der konfigurierte endpoint nach Erhalt des Webhooks eine 2xx-Antwort zurückgeben muss, um Logto darüber zu informieren, dass die Benachrichtigung zum Senden der SMS empfangen wurde.

In diesem Szenario musst du den SMS-Dienst überwachen, um eine erfolgreiche SMS-Zustellung sicherzustellen. Alternativ kannst du ein Monitoring für deine SMS-Versand-API hinzufügen, um SMS-Zustellungsfehler zeitnah zu erkennen.

Payload

Der HTTP SMS Connector sendet das folgende Payload an den Endpunkt, wenn eine SMS gesendet werden muss:

{
  "to": "+1234567890",
  "type": "SignIn",
  "payload": {
    "code": "123456"
  },
  "ip": "192.168.1.1"
}

Das Feld ip ist optional und enthält die IP-Adresse des Clients, sofern verfügbar. Es kann für Ratenbegrenzung, Betrugserkennung oder erweitertes Logging verwendet werden.

Alle Typen findest du in SMS-Vorlagen und die vollständige Typdefinition von SendMessageData im connector-kit.