Zum Hauptinhalt springen

SMS-Connectors

Das Konfigurieren eines SMS-Connectors ermöglicht es dir, Einmalpasswörter (OTPs) an die Telefonnummer des Benutzers zu senden. Dieser passwortlose Authentifizierungsmechanismus kann in verschiedenen Szenarien genutzt werden, einschließlich Registrierung, Anmeldung, Passwort vergessen, Konto-Verknüpfungsprozesse, Mitgliedereinladungen und Verifizierung der Benutzeridentität. Es vereinfacht die Benutzer-Authentifizierung und erhöht die Sicherheit, indem das Risiko von passwortbezogenen Sicherheitsverletzungen minimiert wird.

Wähle deinen SMS-Connector​

Logto bietet einige integrierte SMS-Connectors, die eine sofortige Nutzung ermöglichen:

Wenn unsere Standard-Connectors nicht deinen spezifischen Anforderungen entsprechen, zögere nicht, uns zu kontaktieren. Für OSS-Nutzer 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 SMS-Connector hinzuzufügen:

  1. Navigiere zu Konsole > Connector > E-Mail und SMS-Connectors.
  2. Um einen neuen SMS-Connector hinzuzufügen, klicke auf die Schaltfläche "Einrichten" und wähle deinen gewünschten SMS-Anbieter aus.
  3. Überprüfe die README-Dokumentation für deinen gewählten Anbieter.
  4. Fülle die erforderlichen Felder im Abschnitt "Parameterkonfiguration" aus.
  5. Passe die SMS-Vorlage mit dem JSON-Editor an.
  6. Teste deine Konfiguration, indem du einen Bestätigungscode mit der "Generischen" Vorlage an dein Telefon sendest.
  7. Klicke auf "Speichern und Fertig", um abzuschließen.

SMS-Connector ändern​

Um zu einem anderen SMS-Connector zu wechseln:

  • Greife auf die Connector-Detailseite zu und klicke auf "Connector ändern" in der oberen rechten Ecke
  • Alternativ lösche den bestehenden Connector und erstelle einen neuen

Hinweis: Du kannst NUR EINEN SMS-Connector aktiv haben.

Wenn du bereits einen SMS-Connector hast, kannst du nur "SMS-Connector ändern" auswählen. Wenn du diese Operation in der Konsole durchführst, 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-Nutzer 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.

Telefonnummern-Registrierung oder -Anmeldung aktivieren​

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

  1. Navigiere zu: Konsole > Anmeldeerfahrung > Registrierung und Anmeldung
  2. Registrierungsmethoden festlegen: Wähle "Telefonnummer" oder "E-Mail-Adresse oder Telefonnummer" als Registrierungskennzeichen. Hinweis: Die Telefonnummernverifizierung 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 "Live-Vorschau" zu nutzen, um die Funktionalität zu testen.
warnung:

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

Zum Beispiel, wenn das Anmeldekennzeichen die Kombination "Telefonnummer + Bestätigungscode" enthält, verhindert das Löschen des bestehenden SMS-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​

Logto hat nicht den SMS-Connector, den ich verwenden möchte. Was soll ich tun?​

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

Für Open-Source-Logto-Nutzer bieten wir eine einfach zu erweiternde Methode zur Connector-Erstellung, 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.