ตั้งค่าการยืนยัน SMS ด้วย HTTP SMS

ตัวเชื่อมต่อ Logto อย่างเป็นทางการสำหรับ HTTP SMS

เคล็ดลับ:

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

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

ตัวเชื่อมต่อ HTTP SMS ช่วยให้คุณส่งข้อความ SMS ผ่านการเรียก HTTP ในการใช้งานตัวเชื่อมต่อนี้ คุณต้องมีบริการ SMS ของคุณเองที่เปิดเผย HTTP API สำหรับการส่งข้อความ SMS Logto จะเรียก API นี้เมื่อจำเป็นต้องส่ง SMS ตัวอย่างเช่น เมื่อผู้ใช้ลงทะเบียน Logto จะเรียก HTTP API เพื่อส่ง SMS ยืนยัน

ตั้งค่าตัวเชื่อมต่อ HTTP SMS

ในการใช้งานตัวเชื่อมต่อ HTTP SMS คุณต้องตั้งค่า HTTP endpoint ที่ Logto สามารถเรียกได้ และสามารถตั้งค่าโทเค็นการอนุญาต (authorization token) สำหรับ endpoint ได้ตามต้องการ

เคล็ดลับ:

โปรดทราบว่าเพื่อป้องกันข้อผิดพลาดใน flow การยืนยันตัวตน (authentication flow) endpoint ที่ตั้งค่าต้องตอบกลับด้วยรหัส 2xx หลังจากได้รับ webhook เพื่อแจ้งให้ Logto ทราบว่าได้รับการแจ้งเตือนให้ส่ง SMS แล้ว

ในขณะเดียวกัน ในกรณีนี้ คุณต้องตรวจสอบบริการ SMS เพื่อให้แน่ใจว่าการส่ง SMS สำเร็จ หรือคุณสามารถเพิ่มการมอนิเตอร์ใน API ส่ง SMS ของคุณเพื่อให้ตรวจพบความล้มเหลวในการส่ง SMS ได้อย่างรวดเร็ว

Payload

ตัวเชื่อมต่อ HTTP SMS จะส่ง payload ดังต่อไปนี้ไปยัง endpoint เมื่อจำเป็นต้องส่ง SMS:

{
  "to": "+1234567890",
  "type": "SignIn",
  "payload": {
    "code": "123456"
  },
  "ip": "192.168.1.1"
}

ฟิลด์ ip เป็นตัวเลือกและจะมีที่อยู่ IP ของไคลเอนต์เมื่อมีข้อมูล สามารถนำไปใช้สำหรับการจำกัดอัตรา (rate limiting) การตรวจจับการฉ้อโกง หรือการบันทึก log เพิ่มเติม

คุณสามารถดูประเภททั้งหมดได้ที่ SMS templates และดู type definition แบบเต็มของ SendMessageData ได้ที่ connector-kit