ตั้งค่าการยืนยัน SMS ด้วย Aliyun Short Message Service

ตัวเชื่อมต่อ Logto อย่างเป็นทางการสำหรับบริการข้อความสั้นของ Aliyun

เคล็ดลับ:

คู่มือนี้สมมติว่าคุณมีความเข้าใจพื้นฐานเกี่ยวกับ ตัวเชื่อมต่อ (Connectors) ของ Logto หากคุณยังไม่คุ้นเคย โปรดดูคู่มือ ตัวเชื่อมต่อ (Connectors) เพื่อเริ่มต้น

เริ่มต้นใช้งาน

Aliyun เป็นผู้ให้บริการคลาวด์หลักในเอเชีย โดยมีบริการคลาวด์มากมาย รวมถึง SMS (บริการข้อความสั้น) ตัวเชื่อมต่อ Aliyun SMS เป็นปลั๊กอินที่ทีม Logto จัดเตรียมไว้เพื่อเรียกใช้บริการ SMS ของ Aliyun ซึ่งช่วยให้ผู้ใช้ปลายทาง Logto สามารถลงทะเบียนและลงชื่อเข้าใช้บัญชี Logto ของตนผ่านรหัสยืนยันทาง SMS

ตั้งค่าบริการข้อความสั้นใน Aliyun SMS Console

สร้างบัญชี Aliyun

ไปที่ เว็บไซต์ Aliyun และลงทะเบียนบัญชี Aliyun ของคุณหากยังไม่มี

เปิดใช้งานและตั้งค่าบริการข้อความสั้นของ Aliyun

1. ลงชื่อเข้าใช้ด้วยบัญชี Aliyun ของคุณที่ เว็บไซต์ Aliyun และไปที่ หน้า SMS service console
2. คลิกปุ่ม "เปิดใช้งานฟรี" (免费开通) ที่มุมซ้ายบนของหน้า SMS service เพื่อเริ่มกระบวนการตั้งค่า
3. อ่านและยอมรับ "ข้อตกลงการเปิดใช้งานบริการ SMS" (短信服务开通条款) และคลิก "สมัครใช้บริการ" (开通服务) เพื่อดำเนินการต่อ
4. ตอนนี้คุณอยู่ที่ หน้า SMS service console ให้ไปที่ปุ่ม "จีนแผ่นดินใหญ่" (国内消息) หรือ "นอกจีนแผ่นดินใหญ่" (国际/港澳台消息) ที่แถบด้านข้างตามกรณีการใช้งานของคุณ
5. เพิ่มลายเซ็นและเทมเพลตตามแนวทางที่กำหนด และจัดเตรียมเอกสารหรือข้อมูลที่จำเป็นสำหรับการตรวจสอบ
   • อย่าลืมเลือก "ข้อความรหัสยืนยัน" (验证码) เป็น "สถานการณ์ใช้งาน" (适用场景) ขณะกรอกใบสมัครลายเซ็น และเลือก "ข้อความรหัสยืนยัน" (验证码) สำหรับ "ประเภท" (模板类型) ขณะสมัครขอรีวิวเทมเพลต เพราะเราจะใช้ลายเซ็นและเทมเพลตเหล่านี้เพื่อส่งรหัสยืนยัน ปัจจุบันยังไม่รองรับการส่ง SMS ที่ไม่เกี่ยวข้องกับรหัสยืนยัน
   • ใช้ {{code}} เป็นตัวแทนตำแหน่งที่ต้องการแสดงรหัสยืนยันดิจิทัลในเนื้อหาเทมเพลต
6. หลังจากส่งใบสมัครลายเซ็นและเทมเพลต SMS แล้ว คุณต้องรอให้มีผลใช้งาน ในขั้นตอนนี้สามารถกลับไปที่ หน้า SMS service console และส่ง SMS ทดสอบได้ หากลายเซ็นและเทมเพลตของคุณพร้อมใช้งานแล้ว สามารถทดสอบได้ทันที หากยังไม่พร้อมใช้งาน Aliyun ก็มีเทมเพลตทดสอบให้ใช้เช่นกัน
   • คุณอาจต้องเติมเงินเล็กน้อยก่อนส่งข้อความทดสอบ
   • อาจถูกขอให้ผูกเบอร์โทรศัพท์สำหรับทดสอบก่อนส่งข้อความทดสอบ ดูรายละเอียดเพิ่มเติมที่แท็บ "เริ่มต้นอย่างรวดเร็ว" (快速学习) ที่แถบด้านข้างของ หน้า SMS service console

สร้าง JSON สำหรับตัวเชื่อมต่อ

1. จาก หน้า SMS service console วางเมาส์เหนืออวาตาร์ของคุณที่มุมขวาบนแล้วไปที่ "การจัดการ AccessKey" (AccessKey 管理) และคลิก "สร้าง AccessKey" (创建 AccessKey) คุณจะได้รับคู่ "AccessKey ID" และ "AccessKey Secret" หลังจากผ่านการยืนยันความปลอดภัย กรุณาเก็บรักษาไว้ให้ดี
2. ไปที่แท็บ "จีนแผ่นดินใหญ่" (国内消息) หรือ "นอกจีนแผ่นดินใหญ่" (国际/港澳台消息) ที่คุณเพิ่งเข้าไป คุณจะพบ "ลายเซ็น" (签名名称) และ "รหัสเทมเพลต" (模板 CODE) ได้อย่างง่ายดาย
   • หากต้องการใช้ลายเซ็นและเทมเพลตสำหรับทดสอบเท่านั้น ให้ไปที่แท็บ "เริ่มต้นอย่างรวดเร็ว" (快速学习) แทน และจะพบรายการเหล่านี้ใต้ "ลายเซ็น & เทมเพลต (สำหรับทดสอบเท่านั้น)"
3. กรอกการตั้งค่าตัวเชื่อมต่อ Aliyun SMS:
   • กรอกช่อง accessKeyId และ accessKeySecret ด้วยคู่ access key ที่ได้จากขั้นตอนที่ 1
   • กรอกช่อง signName ด้วย "ลายเซ็น" (签名名称) ที่กล่าวถึงในขั้นตอนที่ 2 เทมเพลตทั้งหมดจะใช้ชื่อลายเซ็นนี้ร่วมกัน
   • คุณสามารถเพิ่มเทมเพลตตัวเชื่อมต่อ SMS ได้หลายรายการสำหรับแต่ละกรณี ตัวอย่างเช่นการเพิ่มเทมเพลตเดียว:
     • กรอกช่อง templateCode ซึ่งใช้ควบคุมเนื้อหา SMS ด้วย "รหัสเทมเพลต" (模板 CODE) จากขั้นตอนที่ 2
     • กรอกช่อง usageType ด้วยค่า Register, SignIn, ForgotPassword หรือ Generic ตามกรณีการใช้งาน (usageType เป็น property ของ Logto เพื่อระบุกรณีใช้งานที่เหมาะสม) เพื่อให้รองรับ user flow เต็มรูปแบบ จำเป็นต้องมีเทมเพลตที่มี usageType เป็น Register, SignIn, ForgotPassword และ Generic
4. ตั้งค่า "Strict Phone Region Number Check":
   • เปิดใช้งานหากคุณต้องการส่ง SMS ไปยังเบอร์โทรศัพท์ต่างประเทศ (นอกจีนแผ่นดินใหญ่ เช่น US, HK ฯลฯ) เมื่อเปิดใช้งาน ตัวเชื่อมต่อจะถือว่าเบอร์โทรศัพท์ทั้งหมดมีรหัสประเทศที่ถูกต้อง (เช่น +1, +852) เพื่อระบุว่าเป็นเบอร์จีนแผ่นดินใหญ่หรือไม่
   • ข้อควรระวัง: หากผู้ใช้เดิมของคุณมีเบอร์โทรศัพท์ที่ไม่มีรหัสประเทศ การเปิดใช้งานนี้อาจส่งผลต่อกระบวนการลงชื่อเข้าใช้ของพวกเขา เปิดใช้งานเฉพาะเมื่อจำเป็นสำหรับการส่ง SMS ต่างประเทศ

ทดสอบตัวเชื่อมต่อ Aliyun SMS

คุณสามารถกรอกเบอร์โทรศัพท์และคลิก "ส่ง" เพื่อดูว่าการตั้งค่าสามารถใช้งานได้ก่อนจะ "บันทึกและเสร็จสิ้น"

เรียบร้อยแล้ว อย่าลืม เปิดใช้งานตัวเชื่อมต่อในขั้นตอนสมัครและลงชื่อเข้าใช้

ประเภทการตั้งค่า

ชื่อ	ประเภท
accessKeyId	string
accessKeySecret	string
signName	string
templates	Template[]

คุณสมบัติของ Template	ประเภท	ค่าที่เป็นไปได้
templateCode	string	N/A
usageType	enum string	'Register' / 'SignIn' / 'ForgotPassword' / 'Generic'

แหล่งอ้างอิง

Aliyun SMS - เริ่มต้นอย่างรวดเร็ว