Aliyun Direct Mail로 이메일 인증을 설정하세요 (Set up email verification with Aliyun Direct Mail)

Logto 공식 Aliyun 커넥터는 direct mail 서비스를 위한 커넥터입니다.

팁:

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

시작하기

Aliyun은 아시아에서 주요 클라우드 서비스 제공업체로, DM (direct mail)을 포함한 다양한 클라우드 서비스를 제공합니다. Aliyun DM 커넥터는 Logto 팀에서 제공하는 플러그인으로, Aliyun DM 서비스 API를 호출할 수 있게 해줍니다. 이를 통해 Logto 최종 사용자는 메일 인증 코드(또는 인증 코드)를 통해 Logto 계정에 등록 및 로그인할 수 있습니다.

Aliyun DirectMail 콘솔에서 이메일 서비스 설정하기

Aliyun 계정 만들기

Aliyun에 접속하여 아직 계정이 없다면 Aliyun 계정을 만드세요.

Aliyun Direct Mail 활성화 및 구성

DM 서비스 콘솔 페이지로 이동하여 로그인하세요. 페이지 왼쪽 상단의 "신청 개통" (申请开通) 버튼을 클릭하여 Direct Mail 서비스를 활성화하고 구성 과정을 시작하세요.

DM 관리 콘솔 페이지에서 다음을 진행하세요:

1. 사이드바에서 "발신 도메인" (发信域名)으로 이동하여 안내에 따라 "신규 도메인" (新建域名)을 추가하세요.
2. 각각 "발신 주소" (发信地址)와 "메일 태그" (邮件标签)를 설정하세요.

설정이 완료되면 두 가지 방법으로 테스트할 수 있습니다:

• DirectMail 개요 페이지로 이동하여, 페이지 하단의 "운영 가이드" (操作引导)에서 "이메일 보내기" (发送邮件)를 클릭하세요. 다양한 테스트 방법을 확인할 수 있습니다.
• 사이드바에서 "이메일 보내기" (发送邮件) -> "이메일 작업" (发送邮件) 경로를 따라가 테스트 작업을 생성하세요.

커넥터 JSON 작성하기

1. DM 관리 콘솔 페이지에서 우측 상단의 아바타에 마우스를 올리고 "AccessKey 관리" (AccessKey 管理)로 이동한 후 "AccessKey 생성" (创建 AccessKey)을 클릭하세요. 보안 인증을 완료하면 "AccessKey ID"와 "AccessKey Secret" 쌍을 받게 됩니다. 안전하게 보관하세요.
2. DM 관리 콘솔 페이지에서 방금 방문한 "발신 주소" (发信地址) 또는 "메일 태그" (邮件标签) 탭으로 이동하면 발신 주소 또는 메일 태그를 쉽게 찾을 수 있습니다.
3. Aliyun DM 커넥터 설정을 작성하세요:
   • 1단계에서 받은 access key 쌍을 accessKeyId와 accessKeySecret 필드에 입력하세요.
   • 2단계에서 찾은 "발신 주소"와 "메일 태그"를 각각 accountName과 fromAlias 필드에 입력하세요. 모든 템플릿은 이 서명 이름을 공유합니다. (fromAlias는 선택 사항이므로 비워둘 수 있습니다.)
   • 다양한 상황에 맞게 여러 DM 커넥터 템플릿을 추가할 수 있습니다. 단일 템플릿을 추가하는 예시는 다음과 같습니다:
     • subject 필드에 이메일 제목을 입력하세요.
     • content 필드에는 임의의 문자열 내용을 입력하세요. 무작위 인증 코드를 위한 {{code}} 플레이스홀더를 반드시 남겨두세요.
     • usageType 필드는 사용 목적에 따라 Register, SignIn, ForgotPassword, Generic 중 하나로 입력하세요. (usageType은 적절한 사용 사례를 식별하기 위한 Logto 속성입니다.) 전체 사용자 플로우를 활성화하려면 Register, SignIn, ForgotPassword, Generic 용 템플릿이 필요합니다.

Aliyun DM 커넥터 테스트하기

이메일 주소를 입력하고 "보내기"를 클릭하여 "저장 및 완료" 전에 설정이 정상적으로 동작하는지 확인할 수 있습니다.

이제 끝입니다. 회원가입 및 로그인에서 커넥터 활성화를 잊지 마세요.

설정 타입

Name	Type
accessKeyId	string
accessKeySecret	string
accountName	string
fromAlias	string (OPTIONAL)
templates	Template[]

Template Properties	Type	Enum values
subject	string	N/A
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'