ตั้งค่าการยืนยันอีเมลด้วย Aliyun Direct Mail (Set up email verification with Aliyun Direct Mail)

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

เคล็ดลับ:

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

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

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

ตั้งค่าบริการอีเมลใน Aliyun DirectMail Console

สร้างบัญชี Aliyun

ไปที่ Aliyun และสร้างบัญชี Aliyun หากคุณยังไม่มีบัญชี

เปิดใช้งานและตั้งค่า Aliyun Direct Mail

ไปที่ หน้าคอนโซลบริการ DM และลงชื่อเข้าใช้ เปิดใช้งานบริการ Direct Mail โดยคลิกปุ่ม "Apply to enable" (申请开通) ที่มุมซ้ายบนของหน้า และเริ่มกระบวนการตั้งค่า

เริ่มจาก หน้าคอนโซลผู้ดูแล DM คุณควร:

1. ไปที่ "Email Domains" (发信域名) จากแถบด้านข้างและเพิ่ม "New Domain" (新建域名) ตามคำแนะนำ
2. ปรับแต่ง "Sender Addresses" (发信地址) และ "Email Tags" (邮件标签) ตามต้องการ

หลังจากตั้งค่าเสร็จแล้ว มีสองวิธีในการทดสอบ:

• ไปที่ หน้า DirectMail Overview, ค้นหา "Operation Guide" (操作引导) ที่ด้านล่างของหน้า แล้วคลิก "Send Emails" (发送邮件) คุณจะพบวิธีการทดสอบหลากหลายรูปแบบ
• ไปที่ "Send Emails" (发送邮件) -> "Email Tasks" (发送邮件) ในแถบด้านข้างเพื่อสร้างงานทดสอบ

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

1. จาก หน้าคอนโซลผู้ดูแล DM, วางเมาส์เหนืออวาตาร์ของคุณที่มุมขวาบนแล้วไปที่ "AccessKey Management" (AccessKey 管理) และคลิก "Create AccessKey" (创建 AccessKey) คุณจะได้รับคู่ "AccessKey ID" และ "AccessKey Secret" หลังจากผ่านการยืนยันความปลอดภัย กรุณาเก็บรักษาไว้ให้ดี
2. ไปที่แท็บ "Sender Addresses" (发信地址) หรือ "Email Tags" (邮件标签) ที่คุณเพิ่งเข้าไปจาก หน้าคอนโซลผู้ดูแล DM, คุณจะพบ Sender Address หรือ Email Tag ได้อย่างง่ายดาย
3. กรอกการตั้งค่าตัวเชื่อมต่อ Aliyun DM:
   • กรอกฟิลด์ accessKeyId และ accessKeySecret ด้วยคู่ access key ที่คุณได้รับจากขั้นตอนที่ 1
   • กรอกฟิลด์ accountName และ fromAlias ด้วย "Sender Address" และ "Email Tag" ที่พบในขั้นตอนที่ 2 ชื่อ signature นี้จะใช้ร่วมกันทุกเทมเพลต (คุณสามารถเว้น fromAlias ว่างไว้ได้เพราะเป็นตัวเลือก)
   • คุณสามารถเพิ่มเทมเพลต DM connector หลายรายการสำหรับแต่ละกรณี ตัวอย่างเช่นการเพิ่มเทมเพลตเดียว:
     • กรอกฟิลด์ subject ซึ่งจะเป็นหัวข้อของอีเมลที่ส่งออก
     • กรอกฟิลด์ content ด้วยข้อความประเภท string ใด ๆ อย่าลืมเว้นที่ว่าง {{code}} สำหรับรหัสยืนยันแบบสุ่ม
     • กรอกฟิลด์ usageType ด้วยค่า Register, SignIn, ForgotPassword หรือ Generic สำหรับแต่ละกรณี (usageType เป็น property ของ Logto เพื่อระบุกรณีการใช้งานที่เหมาะสม) เพื่อเปิดใช้งาน user flows แบบสมบูรณ์ จำเป็นต้องมีเทมเพลตที่มี usageType เป็น Register, SignIn, ForgotPassword และ Generic

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

คุณสามารถกรอกที่อยู่อีเมลแล้วคลิก "Send" เพื่อดูว่าการตั้งค่าสามารถใช้งานได้ก่อนจะ "Save and Done"

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

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

ชื่อ	ประเภท
accessKeyId	string
accessKeySecret	string
accountName	string
fromAlias	string (OPTIONAL)
templates	Template[]

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