Configurer la vérification par SMS avec HTTP SMS

Le connecteur officiel Logto pour HTTP SMS.

astuce:

Ce guide suppose que vous avez une compréhension de base des Connecteurs Logto. Pour ceux qui ne sont pas familiers, veuillez vous référer au guide des Connecteurs pour commencer.

Commencer

Le connecteur HTTP SMS vous permet d'envoyer des messages SMS via un appel HTTP. Pour utiliser le connecteur HTTP SMS, vous devez disposer de votre propre service SMS qui expose une API HTTP pour l'envoi de messages SMS. Logto appellera cette API lorsqu'il devra envoyer un SMS. Par exemple, lorsqu'un utilisateur s'inscrit, Logto appellera l'API HTTP pour envoyer un SMS de vérification.

Configurer le connecteur HTTP SMS

Pour utiliser le connecteur HTTP SMS, vous devez configurer un point de terminaison HTTP que Logto pourra appeler, ainsi qu'un jeton d'autorisation optionnel pour ce point de terminaison.

astuce:

Notez que pour éviter les erreurs dans le flux d'authentification, le endpoint configuré doit renvoyer une réponse 2xx après avoir reçu le webhook afin d'informer Logto qu'il a bien reçu la notification pour envoyer le SMS.

Dans ce scénario, vous devez surveiller le service SMS pour garantir la bonne livraison des SMS. Alternativement, vous pouvez ajouter une surveillance à votre API d'envoi de SMS pour détecter rapidement les échecs de livraison des SMS.

Charge utile

Le connecteur HTTP SMS enverra la charge utile suivante au point de terminaison lorsqu'il devra envoyer un SMS :

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

Le champ ip est optionnel et contient l'adresse IP du client lorsqu'elle est disponible. Il peut être utilisé pour la limitation de débit, la détection de fraude ou une journalisation améliorée.

Vous pouvez retrouver tous les types dans Modèles SMS, ainsi que la définition complète du type SendMessageData dans connector-kit.