Logto 내장 이메일 서비스
Logto는 다음과 같은 상황에서 편리하게 사용할 수 있도록 내장 이메일 서비스를 제공합니다:
- Logto의 이메일 로그인 경험을 빠르게 탐색하거나 테스트할 때.
- 온라인 제품에 직접 사용할 때. 주로
logto.email을 발신자 이메일 도메인으로 사용하는 데 불편함이 없는 신규 스타트업을 위한 것입니다.
Logto 이메일 서비스의 특징:
- 무료 제공: 완전히 무료이며 일일 이메일 사용량 제한이 없어 비용을 절감할 수 있습니다.
- 간편함: 별도의 서드파티 이메일 서비스 공급자와의 설정이 필요 없습니다. 이메일 템플릿의 기본 브랜딩 정보만 간단히 커스터마이즈하면 됩니다. 아직 자체 브랜딩 정보가 없다면, 몇 번의 클릭만으로 바로 사용할 수 있습니다.
- 안정적 전달: Logto의 이메일 서비스를 기반으로 안정적인 서비스와 신뢰할 수 있는 이메일 전달을 제공하여, 사용자가 귀하의 제품에 접근할 수 있도록 보장합니다.
하지만 편리함과 동시에 다음과 같은 제한 사항이 있습니다:
- 이메일은 고정된 주소
[email protected]에서 발송됩니다. - 이메일에 링크나 기타 커스텀 콘텐츠를 추가할 수 없습니다.
비즈니스가 성장함에 따라, 이후에 다른 이메일 서비스 공급자를 선택하여 사용할 수 있습니다. Logto는 다양한 즉시 사용 가능한 이메일 서비스 커넥터를 제공하며, SMTP, HTTP, WebHook 트리거를 통한 이메일 발송도 지원하므로, 항상 적합한 방법을 찾을 수 있습니다.
Logto 내장 무료 이메일 서비스는 현재 Cloud 사용자만 이용할 수 있습니다. 오픈소스 서비스를 사용하는 경우, 이메일 로그인을 위해 이메일 서비스 공급자를 자유롭게 설정할 수 있습니다.
설정 단계
다음 단계를 따라 Logto 이메일 서비스를 설정하세요:
- 커넥터 > 이메일 및 SMS 커넥터로 이동합니다.
- 새로운 이메일 커넥터를 추가하려면 "설정" 버튼을 클릭하고 "Logto 이메일 서비스" 커넥터를 선택하세요.
- "Logto 이메일 서비스" 커넥터가 성공적으로 생성되면, 이메일 템플릿에 표시되는 기본 브랜딩 정보를 커스터마이즈할 수 있습니다.
- 변경 사항을 적용한 후, 저장하기 전에 반드시 테스트 이메일 템플릿을 본인 이메일 주소로 발송해 확인하세요.
커스터마이즈 옵션:
- 발신 이메일: 발신자 이메일은
[email protected]로 고정되어 있으며 수정할 수 없습니다. - 발신자 이름: 브랜드명을 발신자 이름으로 설정하여 사용자가 쉽게 인식할 수 있도록 하세요.
- 회사 정보: 회사명, 주소, 우편번호 등을 표시하여 사용자 신뢰도를 높이고 컴플라이언스 요건을 충족하세요. URL은 입력할 수 없습니다.
- 앱 로고: 앱의 브랜드 로고를 업로드하여, 사용자가 받은 이메일에서 앱의 브랜드 가치를 보여줄 수 있습니다.
통합 이메일 템플릿
Logto 이메일 서비스는 특정 인증 (Authentication) 시나리오에 맞춘 통합 이메일 템플릿을 사용합니다:
| 용도 | 시나리오 |
|---|---|
| Register | 사용자가 이메일로 계정을 생성하고, Logto가 발송한 인증 코드를 입력하여 이메일을 인증합니다. |
| SignIn | 사용자가 이메일로 로그인하며, 비밀번호 대신 인증 코드를 입력하여 인증합니다. |
| ForgotPassword | 사용자가 로그인 시 비밀번호를 잊은 경우, Logto에서 이미 인증한 이메일을 통해 본인 인증을 진행할 수 있습니다. |
| Generic | 다양한 상황에서 일반 백업 옵션으로 사용할 수 있는 템플릿입니다. 커넥터 설정 테스트 등에도 활용됩니다. |
| OrganizationInvitation | 사용자를 조직에 초대하는 링크를 발송할 때 이 템플릿을 사용합니다. |
| UserPermissionValidation | 앱 사용 중, 은행 이체, 사용 중인 리소스 삭제, 멤버십 해지 등 추가 사용자 인증이 필요한 고위험 또는 비교적 위험도가 높은 작업 시, UserPermissionValidation 템플릿을 사용하여 사용자가 받는 이메일 인증 코드의 내용을 정의할 수 있습니다. |
| BindNewIdentifier | 사용자가 프로필을 수정할 때, 현재 계정에 이메일 주소를 바인딩하는 경우 BindNewIdentifier 템플릿을 사용하여 인증 이메일의 내용을 커스터마이즈할 수 있습니다. |
| MfaVerification | 이메일 MFA가 활성화된 경우, 다단계 인증 (MFA) 과정에서 사용자에게 인증 코드를 발송할 때 이 템플릿을 사용합니다. |
| BindMfa | 이메일 MFA가 활성화된 경우, MFA용 이메일 인증 코드 설정 시 이 템플릿을 사용합니다. 사용자가 계정에 MFA 요소로 이메일 주소를 바인딩하거나 설정할 때 인증 코드를 받게 됩니다. |
"Register" 용도의 이메일 템플릿 예시 (커스텀 브랜드 정보 포함):
커스텀 브랜드 정보가 없는 경우에도, 기본 표시 및 레이아웃으로 이메일 템플릿을 사용할 수 있습니다:
다국어 지원
Logto 내장 이메일 서비스는 여러 언어를 지원합니다. 사용자의 로그인 경험 설정을 자동으로 감지하여, 사용자가 선호하는 언어로 이메일을 발송합니다.
Management API를 통해 조직 초대 이메일을 발송할 때, 요청 페이로드에 locale 파라미터를 지정할 수 있습니다. 예시:
{
"inviterId": "inviter-user-id",
"invitee": "invitee-email-address",
"expiresAt": "epoch-timestamp",
"organizationId": "organization-id",
"messagePayload": {
"link": "https://your-app.com/invite-accept?invitation-id=abcd1234",
"locale": "fr"
}
}
자주 묻는 질문
Logto 이메일 서비스에 커스텀 CSS나 HTML을 추가할 수 있나요?
Logto 내장 이메일 서비스는 커스텀 CSS 또는 HTML을 지원하지 않습니다. 일반적인 브랜딩 요소만 수정할 수 있습니다. 모든 테넌트가 동일한 IP 주소와 발신자 주소를 공유하기 때문에, 내장 이메일 서비스의 안정성을 유지하기 위한 제한입니다. 자세한 내용은 "이메일 전달률을 높이는 요인"을 참고하세요.
이메일 템플릿을 커스터마이즈하려면 AWS Direct Mail, SendGrid, Mailgun, Postmark, SMTP 등 다른 이메일 커넥터 사용을 권장합니다.