Aller au contenu principal

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 endpoint HTTP que Logto pourra appeler, ainsi qu'un jeton d'autorisation facultatif pour ce endpoint.

astuce:

Notez que pour éviter les erreurs dans le flux d'authentification, l'endpoint configuré doit retourner 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.

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

Charge utile

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

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

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