본문으로 건너뛰기

이메일 커넥터

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

이메일 커넥터 선택하기​

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

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

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

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

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

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

이 옵션들은 이메일 템플릿, 발신자 이름을 완전히 맞춤 설정하고, 변수를 추가하는 등 브랜드에 가장 잘 맞도록 할 수 있습니다.

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

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

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

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

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

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

구성 단계​

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

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

중요한 이메일 (예: 인증 코드)이 사용자의 받은 편지함에 안정적으로 도달하고 스팸 필터를 피하기 위해 두 가지 우선순위에 집중하세요:

  • 이메일 인증 설정 (SPF, DKIM, DMARC) 이메일 제공업체 (Gmail, Outlook 등)는 이러한 프로토콜을 사용하여 스팸 발송자가 아님을 확인합니다. 이러한 설정이 없으면 이메일이 스팸으로 분류되거나 거부될 수 있습니다.
    • SPF (Sender Policy Framework): 도메인에서 이메일을 보낼 수 있는 서버 / IP 목록을 작성합니다.
    • DKIM (DomainKeys Identified Mail): 이메일이 변조되지 않았음을 증명하는 디지털 서명을 추가합니다.
    • DMARC (Domain-based Message Authentication): SPF / DKIM에 실패한 이메일을 수신자가 어떻게 처리할지 알려줍니다.
  • 인증 및 마케팅 이메일 분리 마케팅 이메일은 종종 스팸 불만이나 높은 반송률을 유발합니다. 인증 이메일이 동일한 도메인 / IP를 공유하면 전송 가능성이 저하됩니다.
    • 전용 도메인 사용: 인증 이메일은 @auth.yourdomain.com에서, 마케팅은 @marketing.yourdomain.com에서 보냅니다.
    • 전용 IP: 인증 이메일을 위한 고유 IP를 요청하고 천천히 워밍업합니다.
    • "From" 주소 일치: 발신자 도메인이 SPF / DKIM / DMARC 기록과 일치하는지 확인합니다.

이메일 커넥터 변경하기​

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

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

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

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

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

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

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

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

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

자주 묻는 질문​

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

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

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

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

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

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