HTTP SMS로 SMS 인증을 설정하세요

HTTP SMS용 공식 Logto 커넥터입니다.

팁:

이 가이드는 Logto 커넥터에 대한 기본적인 이해를 전제로 합니다. 익숙하지 않은 분들은 커넥터 가이드를 참조하여 시작하세요.

시작하기

HTTP SMS 커넥터를 사용하면 HTTP 호출을 통해 SMS 메시지를 전송할 수 있습니다. HTTP SMS 커넥터를 사용하려면, SMS 메시지를 전송할 수 있는 HTTP API를 제공하는 자체 SMS 서비스가 필요합니다. Logto는 SMS를 전송해야 할 때 이 API를 호출합니다. 예를 들어, 사용자가 회원가입을 할 때 Logto는 HTTP API를 호출하여 인증 SMS를 전송합니다.

HTTP SMS 커넥터 설정

HTTP SMS 커넥터를 사용하려면, Logto가 호출할 수 있는 HTTP 엔드포인트와 (선택 사항으로) 엔드포인트용 인가 토큰을 설정해야 합니다.

팁:

인증 (Authentication) 플로우에서 오류를 방지하려면, 구성된 endpoint가 웹훅을 수신한 후 Logto에 SMS 전송 알림을 받았음을 알리기 위해 2xx 응답을 반환해야 합니다.

이와 동시에, 이 시나리오에서는 SMS 서비스의 성공적인 SMS 전송을 보장하기 위해 SMS 서비스를 모니터링해야 합니다. 또는, SMS 전송 API에 모니터링을 추가하여 SMS 전송 실패를 신속하게 감지할 수 있습니다.

페이로드

HTTP SMS 커넥터는 SMS를 전송해야 할 때 다음과 같은 페이로드를 엔드포인트로 전송합니다:

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

모든 타입은 SMS 템플릿에서 확인할 수 있으며, SendMessageData의 전체 타입 정의는 connector-kit에서 확인할 수 있습니다.