SMS-Verifizierung mit Twilio SMS einrichten

Der offizielle Logto Connector für den Twilio-Kurznachrichtendienst.

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

Twilio bietet programmierbare Kommunikationstools für das Tätigen und Empfangen von Telefonanrufen, das Senden und Empfangen von Textnachrichten und andere Kommunikationsfunktionen. Wir können die Textnachrichten mit dem "Verifizierungscode" über seine Webservice-APIs senden.

Twilio-Konto registrieren

Erstelle ein neues Konto bei Twilio. (Springe zum nächsten Schritt, wenn du bereits eines hast.)

Telefonnummern der Absender einrichten

Gehe zur Twilio-Konsole und melde dich mit deinem Twilio-Konto an.

Kaufe eine Telefonnummer unter "Phone Numbers" -> "Manage" -> "Buy a number".

tipp:

Manchmal kann es vorkommen, dass der SMS-Dienst in bestimmten Ländern oder Regionen nicht unterstützt wird. Wähle eine Nummer aus anderen Regionen, um dies zu umgehen.

Sobald wir eine gültige Nummer beansprucht haben, navigiere zu "Messaging" -> "Services". Erstelle einen neuen Nachrichtendienst, indem du auf die Schaltfläche klickst.

Gib einen benutzerfreundlichen Servicenamen ein und wähle Notify my users als unseren Servicezweck. Im nächsten Schritt wähle Phone Number als Sender Type und füge die gerade beanspruchte Telefonnummer als Absender zu diesem Dienst hinzu.

hinweis:

Jede Telefonnummer kann nur mit einem Nachrichtendienst verknüpft werden.

Kontozugangsdaten erhalten

Wir benötigen die API-Zugangsdaten, um den Connector zum Laufen zu bringen. Beginnen wir auf der Twilio-Konsole.

Klicke auf das "Account"-Menü in der oberen rechten Ecke und gehe dann zur Seite "API keys & tokens", um dein Account SID und Auth token zu erhalten.

Gehe zurück zu "Messaging" -> "Services" Einstellungen, beginnend von der Seitenleiste, und finde das Sid deines Dienstes.

Den Connector-JSON erstellen

Fülle die Felder accountSID, authToken und fromMessagingServiceSID mit Account SID, Auth token und Sid des entsprechenden Nachrichtendienstes aus.

Du kannst mehrere SMS-Connector-Vorlagen für verschiedene Fälle hinzufügen. Hier ist ein Beispiel für das Hinzufügen einer einzelnen Vorlage:

• Fülle das content-Feld mit beliebigen string-typisierten Inhalten aus. Vergiss nicht, den {{code}} Platzhalter für den zufälligen Bestätigungscode zu lassen.
• Fülle das usageType-Feld mit entweder Register, SignIn, ForgotPassword, Generic für verschiedene Anwendungsfälle aus. Um vollständige Benutzerflüsse zu ermöglichen, sind Vorlagen mit usageType Register, SignIn, ForgotPassword und Generic erforderlich.

Twilio SMS-Connector testen

Du kannst eine Telefonnummer eingeben und auf "Send" klicken, um zu sehen, ob die Einstellungen funktionieren, bevor du "Save and Done" auswählst.

Das war's. Vergiss nicht, den Connector in der Anmeldeerfahrung zu aktivieren.

Konfigurationstypen

Name	Typ
accountSID	string
authToken	string
fromMessagingServiceSID	string
templates	Templates[]

Template-Eigenschaften	Typ	Enum-Werte
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

Referenz

Twilio - Fehler- und Warnungswörterbuch