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

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

팁:

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

시작하기

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

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

Aliyun 계정 만들기

Aliyun 웹사이트에 접속하여 아직 계정이 없다면 Aliyun 계정을 등록하세요.

Aliyun 단문 메시지 서비스 활성화 및 구성

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 커넥터 설정을 작성하세요:
   • 1단계에서 받은 access key 쌍을 accessKeyId와 accessKeySecret 필드에 입력하세요.
   • 2단계에서 언급한 "서명" (签名名称)을 signName 필드에 입력하세요. 모든 템플릿은 이 서명 이름을 공유합니다.
   • 다양한 상황에 맞게 여러 SMS 커넥터 템플릿을 추가할 수 있습니다. 단일 템플릿 추가 예시는 다음과 같습니다:
     • 2단계에서 받은 "템플릿 코드" (模板 CODE)를 templateCode 필드에 입력하세요. 이 값으로 SMS 내용을 제어할 수 있습니다.
     • usageType 필드에는 상황에 따라 Register, SignIn, ForgotPassword, Generic 중 하나를 입력하세요. (usageType은 적절한 사용 사례를 식별하는 Logto 속성입니다.) 전체 사용자 플로우를 활성화하려면 Register, SignIn, ForgotPassword, Generic usageType의 템플릿이 필요합니다.
4. "엄격한 전화번호 지역번호 확인" 설정:
   • 해외 전화번호(미국, 홍콩 등 중국 본토 외 지역)로 SMS를 보내야 한다면 활성화하세요. 활성화 시, 커넥터는 모든 전화번호가 유효한 지역번호(예: +1, +852)를 포함한다고 가정하여 중국 본토 여부를 판단합니다.
   • 주의: 기존 사용자의 전화번호에 지역번호가 없다면, 이 기능을 활성화할 경우 로그인 과정에 영향을 줄 수 있습니다. 해외 SMS 발송이 필요한 경우에만 활성화하세요.

Aliyun SMS 커넥터 테스트하기

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

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

구성 타입

이름	타입
accessKeyId	string
accessKeySecret	string
signName	string
templates	Template[]

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

참고 자료

Aliyun SMS - 빠른 시작