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가 웹훅을 수신한 후 2xx 응답을 반환하여 Logto에 SMS 전송 알림을 정상적으로 수신했음을 알려야 합니다.

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

페이로드

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

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

ip 필드는 선택 사항이며, 사용 가능한 경우 클라이언트의 IP 주소를 포함합니다. 이 정보는 속도 제한, 사기 탐지 또는 로그 강화에 사용할 수 있습니다.

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