본문으로 건너뛰기

이메일 커넥터

이메일 커넥터는 Logto와 이메일 전송 서비스를 통합하여 이메일을 통한 안전한 사용자 인증을 가능하게 합니다. 설정이 완료되면 사용자 가입, 로그인, 비밀번호 재설정, 계정 연결, 회원 초대 및 고위험 작업 검증을 위해 일회용 비밀번호 (OTPs)를 보낼 수 있습니다.

이메일 커넥터 선택하기​

Logto는 세 가지 유형의 이메일 커넥터 옵션을 제공합니다:

무료 Logto 이메일 서비스 (클라우드 전용)​

이 내장 이메일 서비스 옵션은 테스트 및 프로덕션 모두에 빠르게 시작하기에 이상적입니다. 타사 통합이 필요 없으며, 무료로 신뢰할 수 있는 이메일 전송을 제공합니다. 사전 디자인된 이메일 템플릿에 기본 브랜딩을 간단히 맞춤 설정하세요.

Logto 이메일 서비스 커넥터는 이제 로고, 회사 정보 및 발신자 이름을 포함한 브랜딩 맞춤 설정 기능을 제공합니다.

그러나 편리함에도 불구하고, 발신자의 이메일 주소, 도메인 또는 특정 이메일 내용을 맞춤 설정할 수 없다는 제한이 있습니다.

Logto의 단계별 가이드를 사용하여 선호하는 이메일 서비스 제공업체 (ESP)와 연결하세요.

이 옵션들은 이메일 템플릿, 발신자 이름 등을 완전히 맞춤 설정하여 브랜딩을 최적화할 수 있게 합니다.

다음 이메일 서비스 제공업체에 대한 즉시 사용 가능한 지원을 제공합니다:

이메일 커넥터 맞춤 설정하기​

위의 솔루션 중 어느 것도 요구 사항을 충족하지 않는 경우, Simple Mail Transfer Protocol (SMTP)을 사용하여 원하는 이메일 서비스에 연결할 수도 있습니다.

이미 자체 이메일 서비스를 보유하고 있으며 SMTP 연결을 사용할 수 없는 경우, "HTTP 이메일 커넥터"도 제공합니다.

이메일을 보내야 할 때, 설정된 endpoint에 API 호출을 보내 이메일 의존 인증 흐름을 완료합니다. 인증 흐름 오류를 방지하기 위해, 설정된 엔드포인트는 이메일 전송 알림을 수신했음을 Logto에 알리기 위해 WebHook을 수신한 후 200 응답을 반환해야 합니다. 이 경우, 성공적인 전송을 보장하기 위해 자체 이메일 서비스를 모니터링해야 합니다.

표준 커넥터가 특정 요구 사항을 충족하지 않는 경우, 문의하세요. OSS 사용자의 경우, 요구 사항이 긴급한 경우 커넥터 구현 (OSS)를 구현할 수 있습니다. 우리는 항상 기여를 환영합니다; 여러분의 노력이 동일한 필요를 가진 다른 커뮤니티 구성원들에게 도움이 될 수 있습니다.

설정 단계​

이메일 커넥터를 추가하려면 아래 단계를 따르세요:

  1. 콘솔 > 커넥터 > 이메일 및 SMS 커넥터로 이동합니다.
  2. 새 이메일 커넥터를 추가하려면 "설정" 버튼을 클릭하고 원하는 이메일 제공업체를 선택하세요.
  3. README 문서를 검토하고 선택한 제공업체에 대한 설정을 단계별로 진행하세요.
  4. "저장 및 완료"를 클릭하여 마무리합니다.

이메일 커넥터 변경하기​

하나의 이메일 커넥터만 추가할 수 있음을 알 수 있습니다.

이미 이메일 커넥터가 있는 경우, "이메일 커넥터 변경"만 선택할 수 있습니다. 콘솔에서 이 작업을 수행할 때, 저장되면 즉시 적용되므로 저장하기 전에 설정을 테스트해야 합니다.

서비스의 안정성을 보장하기 위해, 클라우드 사용자는 개발 환경을 위한 개발 테넌트를 생성할 수 있습니다. 개발 환경에서 설정을 테스트한 후, 설정을 프로덕션으로 "이전"하고 설정을 저장하세요.

이메일 가입 또는 로그인 활성화하기​

이메일 커넥터를 성공적으로 추가하고 설정을 완료하면, 비즈니스 요구에 따라 이메일 + 인증 코드에 의존하는 로그인 및 가입 설정을 활성화할 수 있습니다.

  1. 이동 경로: 콘솔 > 로그인 경험 > 가입 및 로그인
  2. 가입 방법 설정: 가입 식별자로 "이메일 주소" 또는 "이메일 주소 또는 전화번호"를 선택하세요. 참고: 가입 시 이메일 인증은 현재 필수입니다.
  3. 로그인 방법 설정: 선택한 가입 식별자는 자동으로 로그인 방법이 됩니다. 추가 로그인 옵션을 위해 "다른 방법 추가"를 클릭하세요.
  4. 변경 사항 저장 및 테스트: "변경 사항 저장"을 클릭하여 새로운 로그인 경험을 구현하세요. "라이브 미리보기"를 사용하여 기능을 테스트하는 것을 잊지 마세요.
경고:

설정이 즉시 적용되기 때문에, 기존 이메일 커넥터를 삭제하면 최종 사용자의 정상적인 로그인 및 등록 과정에 영향을 미칠 수 있습니다.

예를 들어, 로그인 식별자가 "이메일 + 인증 코드" 조합을 포함하는 경우, 기존 이메일 커넥터를 삭제하면 사용자가 이메일로 인증 코드를 받을 수 없게 되어 로그인 흐름에서 오류가 발생합니다.

커넥터 작업 시 잠재적인 위험을 인지하세요.

자주 묻는 질문​

이메일 발신자 이름을 어떻게 맞춤 설정하나요?​

우리는 더 많은 커넥터를 작업 중입니다. 추가 옵션이 필요하면 Discord에서 요구 사항을 알려주시고 GitHub에서 기능 요청을 제출하세요. 추가 지원이 필요하면 이메일로 문의할 수도 있습니다.

기여자에게는 특정 시나리오에 따라 자신의 커넥터를 맞춤 설정할 수 있는 확장 가능한 커넥터 생성 방법을 제공합니다. Logto에 풀 리퀘스트를 제출하여 커뮤니티의 다른 사람들이 여러분의 작업에서 혜택을 받을 수 있도록 언제든지 환영합니다.

Logto 이메일 커넥터에서 이메일 요청에 대한 IP 주소를 어떻게 제한할 수 있나요?​

한 가지 해결책은 Logto HTTP 이메일 커넥터를 사용하는 것입니다.

서버에 관련 이메일 서비스를 호출하는 API 엔드포인트를 구현하고, Logto HTTP 이메일 커넥터를 통해 이 API 엔드포인트를 트리거하세요. 이렇게 하면 API 엔드포인트의 IP 주소를 완전히 제어할 수 있으며, 이메일 서비스 제공업체의 설정에서 해당 IP 주소를 화이트리스트에 추가할 수 있습니다.