HTTP 호출을 통한 이메일 인증 설정

HTTP 이메일을 위한 공식 Logto 커넥터입니다.

팁:

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

시작하기

HTTP 이메일 커넥터를 사용하면 HTTP 호출을 통해 이메일을 보낼 수 있습니다. HTTP 이메일 커넥터를 사용하려면 이메일을 보내기 위한 HTTP API를 노출하는 자체 이메일 서비스가 필요합니다. Logto는 이메일을 보내야 할 때 이 API를 호출합니다. 예를 들어, 사용자가 등록할 때 Logto는 인증 이메일을 보내기 위해 HTTP API를 호출합니다.

HTTP 이메일 커넥터 설정

HTTP 이메일 커넥터를 사용하려면 Logto가 호출할 수 있는 HTTP 엔드포인트를 설정해야 합니다. 그리고 엔드포인트에 대한 선택적 인가 토큰이 필요합니다.

페이로드

HTTP 이메일 커넥터는 이메일을 트리거할 때 엔드포인트로 페이로드를 전송합니다. 여기에는 수신자의 이메일 (to), 인증 흐름을 나타내는 이메일 usageType (type), 사용 가능한 변수 (예: 인증 코드, 링크, 애플리케이션 정보, 조직 정보, 사용자 정보) 및 사용자의 locale을 포함하는 payload가 포함됩니다.

예시:

{
  "to": "[email protected]",
  "type": "SignIn",
  "payload": {
    "code": "123456",
    "locale": "de"
  }
}

이 정보를 사용하여 이메일 전송 제공업체에서 이메일 템플릿을 사용자 지정할 수 있습니다.

모든 사용 가능한 유형은 이메일 템플릿을 참조하세요. 전체 SendMessageData 유형 정의는 connector-kit에 있습니다.