Aliyun Short Message Service로 SMS 인증을 설정하세요

Aliyun 단문 메시지 서비스에 대한 공식 Logto 커넥터입니다.

팁:

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

시작하기

Aliyun은 아시아의 주요 클라우드 서비스 제공업체로, SMS (단문 메시지 서비스)를 포함한 다양한 클라우드 서비스를 제공합니다. Aliyun SMS Connector는 Logto 팀이 제공하는 플러그인으로, 이를 통해 Logto 최종 사용자는 SMS 인증 코드를 통해 Logto 계정에 등록하고 로그인할 수 있습니다.

Aliyun SMS 콘솔에서 단문 메시지 서비스를 설정하세요

Aliyun 계정 생성하기

Aliyun 웹사이트로 이동하여 Aliyun 계정이 없으면 등록하세요.

Aliyun Short Message Service 활성화 및 구성하기

1. Aliyun 웹사이트에 Aliyun 계정으로 로그인하고 SMS 서비스 콘솔 페이지로 이동하세요.
2. SMS 서비스 페이지의 왼쪽 상단에 있는 "무료 개통" (免费开通) 버튼을 클릭하고 구성 과정을 시작하세요.
3. "SMS 서비스 개통 약관" (短信服务开通条款)을 읽고 동의한 후 "서비스 개통" (开通服务)을 클릭하여 진행하세요.
4. 이제 SMS 서비스 콘솔 페이지에 있으며, 사용 사례에 따라 사이드바의 "중국 본토" (国内消息) 또는 "중국 본토 외" (国际/港澳台消息) 버튼으로 이동하세요.
5. 가이드라인에 따라 서명 및 템플릿을 추가하고 검토에 필요한 자료나 정보를 제공하세요.
   • 서명 신청서를 작성할 때 "적용 시나리오" (适用场景)로 "인증 코드 메시지" (验证码)를 선택하고, 템플릿 검토를 신청할 때 "템플릿 유형" (模板类型)으로 "인증 코드 메시지" (验证码)를 선택하세요. 현재, 인증 코드 관련 문자 메시지 외의 SMS 메시지 전송은 지원하지 않습니다.
   • 템플릿 내용에서 디지털 인증 코드를 배치할 위치에 {{code}}를 자리 표시자로 사용하세요.
6. SMS 서명 및 템플릿 신청서를 제출한 후, 적용될 때까지 기다려야 합니다. 이 시점에서 SMS 서비스 콘솔 페이지로 돌아가 테스트 SMS를 보낼 수 있습니다. 서명과 템플릿이 사용 준비가 되면 직접 시도할 수 있으며, 아직 적용되지 않은 경우 Aliyun은 테스트 템플릿도 제공합니다.
   • 테스트 메시지를 보내기 전에 소액을 충전해야 할 수도 있습니다.
   • 테스트 메시지를 보내기 전에 테스트 전화번호를 바인딩해야 할 수도 있습니다. 자세한 내용은 SMS 서비스 콘솔 페이지 사이드바의 "빠른 시작" (快速学习) 탭을 참조하세요.

커넥터 JSON 작성하기

1. SMS 서비스 콘솔 페이지에서 오른쪽 상단의 아바타에 마우스를 올리고 "AccessKey 관리" (AccessKey 管理)로 이동하여 "AccessKey 생성" (创建 AccessKey)을 클릭하세요. 보안 인증을 완료한 후 "AccessKey ID"와 "AccessKey Secret" 쌍을 받게 됩니다. 이를 잘 보관하세요.
2. 방금 방문한 "중국 본토" (国内消息) 또는 "중국 본토 외" (国际/港澳台消息) 탭으로 이동하여 "서명" (签名名称) 및 "템플릿 코드" (模板 CODE)를 쉽게 찾을 수 있습니다.
   • 테스트 전용 서명 및 템플릿을 사용하려면 대신 "빠른 시작" (快速学习) 탭으로 이동하여 "서명 및 템플릿 (테스트 전용)" 아래에서 찾을 수 있습니다.
3. Aliyun SMS Connector 설정을 작성하세요:
   • 1단계에서 얻은 액세스 키 쌍으로 accessKeyId 및 accessKeySecret 필드를 작성하세요.
   • 2단계에서 언급한 "서명" (签名名称)으로 signName 필드를 작성하세요. 모든 템플릿은 이 서명 이름을 공유합니다.
   • 다양한 경우에 대해 여러 SMS 커넥터 템플릿을 추가할 수 있습니다. 단일 템플릿을 추가하는 예시는 다음과 같습니다:
     • 2단계의 "템플릿 코드" (模板 CODE)로 SMS 컨텍스트를 제어할 templateCode 필드를 작성하세요.
     • usageType 필드를 Register, SignIn, ForgotPassword 또는 Generic 중 하나로 작성하여 다양한 사용 사례에 맞추세요. (usageType은 적절한 사용 사례를 식별하기 위한 Logto 속성입니다.) 전체 사용자 흐름을 활성화하려면 Register, SignIn, ForgotPassword 및 Generic 사용 유형의 템플릿이 필요합니다.

Aliyun SMS 커넥터 테스트하기

전화번호를 입력하고 "전송"을 클릭하여 설정이 작동하는지 "저장 및 완료" 전에 확인할 수 있습니다.

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

구성 유형

이름	유형
accessKeyId	string
accessKeySecret	string
signName	string
templates	Template[]

템플릿 속성	유형	열거형 값
templateCode	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'

참고 자료

Aliyun SMS - 빠른 시작