ข้ามไปยังเนื้อหาหลัก

ตัวเชื่อมต่ออีเมล

ตัวเชื่อมต่ออีเมลจะผสานรวมบริการส่งอีเมลของคุณเข้ากับ Logto เพื่อเปิดใช้งานการยืนยันตัวตนผู้ใช้อย่างปลอดภัยผ่านอีเมล เมื่อกำหนดค่าแล้ว คุณสามารถส่ง รหัสผ่านใช้ครั้งเดียว (OTP) สำหรับ การสมัครสมาชิก, การลงชื่อเข้าใช้, การรีเซ็ตรหัสผ่าน, การเชื่อมโยงบัญชี, การเชิญสมาชิก และ การยืนยันการดำเนินการที่มีความเสี่ยงสูง

เลือกตัวเชื่อมต่ออีเมลของคุณ​

Logto มีตัวเลือกตัวเชื่อมต่ออีเมลให้เลือก 3 ประเภท:

Logto Email Service ฟรี (เฉพาะ Cloud)​

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

ตัวเชื่อมต่อ Logto Email Service ขณะนี้รองรับการปรับแต่งแบรนด์ เช่น โลโก้ ข้อมูลบริษัท และชื่อผู้ส่ง

อย่างไรก็ตาม แม้จะสะดวก แต่ก็มีข้อจำกัดบางประการที่ควรทราบ — คุณไม่สามารถปรับแต่งที่อยู่อีเมลผู้ส่ง โดเมน หรือเนื้อหาอีเมลเฉพาะได้

เชื่อมต่อกับผู้ให้บริการอีเมล (ESP) ที่คุณต้องการโดยใช้คู่มือทีละขั้นตอนของ Logto

ตัวเลือกเหล่านี้ช่วยให้คุณสามารถ ปรับแต่งเทมเพลตอีเมลของคุณ ได้อย่างเต็มที่ ชื่อผู้ส่ง เพิ่มตัวแปร ฯลฯ เพื่อให้เหมาะกับแบรนด์ของคุณมากที่สุด

เรามีการรองรับผู้ให้บริการอีเมลต่อไปนี้แบบสำเร็จรูป:

ปรับแต่งตัวเชื่อมต่ออีเมลของคุณ​

หากไม่มีตัวเลือกข้างต้นตรงกับความต้องการของคุณ คุณสามารถเลือกเชื่อมต่อกับบริการอีเมลที่ต้องการผ่าน Simple Mail Transfer Protocol (SMTP) ได้เช่นกัน

หากคุณมีบริการอีเมลของตัวเองและไม่สามารถใช้การเชื่อมต่อ SMTP ได้ เรายังมี "HTTP email connector" ให้เลือกใช้

เมื่อจำเป็นต้องส่งอีเมล ระบบจะส่ง API call ไปยัง endpoint ที่กำหนดไว้เพื่อดำเนิน flow การยืนยันตัวตนที่ต้องใช้อีเมล โปรดทราบว่าเพื่อป้องกันข้อผิดพลาดใน flow การยืนยันตัวตน endpoint ที่กำหนดต้องตอบกลับด้วย 200 หลังได้รับ WebHook เพื่อแจ้ง Logto ว่าได้รับคำขอส่งอีเมลแล้ว ในกรณีนี้ คุณต้องตรวจสอบบริการอีเมลของคุณเองเพื่อให้แน่ใจว่าส่งสำเร็จ

หากตัวเชื่อมต่อมาตรฐานของเราไม่ตรงกับความต้องการเฉพาะของคุณ อย่าลังเลที่จะ ติดต่อเรา สำหรับผู้ใช้ OSS คุณสามารถ พัฒนาตัวเชื่อมต่อของคุณเอง (OSS) ได้หากมีความเร่งด่วน เรายินดีต้อนรับ การมีส่วนร่วม เสมอ ความพยายามของคุณอาจช่วยเหลือสมาชิกชุมชนคนอื่นที่มีความต้องการเดียวกัน

ขั้นตอนการตั้งค่า​

ทำตามขั้นตอนด้านล่างเพื่อเพิ่มตัวเชื่อมต่ออีเมล:

  1. ไปที่ Console > Connectors > Email and SMS connectors
  2. เพื่อเพิ่มตัวเชื่อมต่ออีเมลใหม่ ให้คลิกปุ่ม "Set up" และเลือกผู้ให้บริการอีเมลที่ต้องการ
  3. อ่านเอกสาร README และตั้งค่าตามขั้นตอนสำหรับผู้ให้บริการที่เลือก
  4. คลิก "Save and Done" เพื่อเสร็จสิ้น
บันทึก:

เพื่อให้แน่ใจว่าอีเมลสำคัญ (เช่น รหัสยืนยัน) ไปถึงกล่องจดหมายของผู้ใช้อย่างน่าเชื่อถือและไม่ตกเป็นสแปม ให้เน้นสองสิ่งนี้:

  • ตั้งค่าการยืนยันตัวตนอีเมล (SPF, DKIM, DMARC) ผู้ให้บริการอีเมล (Gmail, Outlook ฯลฯ) ใช้โปรโตคอลเหล่านี้เพื่อตรวจสอบว่าคุณไม่ใช่สแปมเมอร์ หากขาดการตั้งค่าเหล่านี้ อีเมลอาจตกเป็นสแปมหรือถูกปฏิเสธ
    • SPF (Sender Policy Framework): ระบุเซิร์ฟเวอร์ / IP ที่อนุญาตให้ส่งอีเมลในนามโดเมนของคุณ
    • DKIM (DomainKeys Identified Mail): เพิ่มลายเซ็นดิจิทัลเพื่อพิสูจน์ว่าอีเมลไม่ถูกแก้ไข
    • DMARC (Domain-based Message Authentication): แจ้งผู้รับว่าจะจัดการอีเมลที่ไม่ผ่าน SPF / DKIM อย่างไร
  • แยกอีเมลยืนยันตัวตน & อีเมลการตลาด อีเมลการตลาดมักทำให้เกิดการร้องเรียนสแปมหรืออัตราตีกลับสูง หากอีเมลยืนยันตัวตนใช้โดเมน / IP เดียวกัน อัตราการส่งถึงกล่องจดหมายจะลดลง
    • ใช้โดเมนเฉพาะ: ส่งอีเมลยืนยันจาก @auth.yourdomain.com การตลาดจาก @marketing.yourdomain.com
    • IP เฉพาะ: ขอ IP เฉพาะสำหรับอีเมลยืนยันตัวตนและค่อย ๆ อุ่น IP
    • ให้ที่อยู่ "From" ตรงกับ SPF / DKIM / DMARC

เปลี่ยนตัวเชื่อมต่ออีเมล​

คุณจะสังเกตได้ว่าสามารถเพิ่มตัวเชื่อมต่ออีเมลได้เพียงหนึ่งตัวเท่านั้น

เมื่อคุณมีตัวเชื่อมต่ออีเมลอยู่แล้ว คุณสามารถเลือก "Change email connector" ได้เท่านั้น เมื่อดำเนินการนี้ในคอนโซล การเปลี่ยนแปลงจะมีผลทันทีหลังจากบันทึก ดังนั้นโปรดทดสอบการตั้งค่าก่อนบันทึกทุกครั้ง

เพื่อความเสถียรของบริการ ผู้ใช้ Cloud สามารถสร้าง dev tenant สำหรับสภาพแวดล้อมพัฒนา หลังจากทดสอบการตั้งค่าใน dev แล้ว ให้ "migrate" การตั้งค่าไปยัง production แล้วจึงบันทึก

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

เมื่อคุณเพิ่มตัวเชื่อมต่ออีเมลและตั้งค่าเรียบร้อยแล้ว คุณสามารถเปิดใช้งานการตั้งค่าการลงชื่อเข้าใช้และสมัครสมาชิกที่ใช้ "อีเมล + รหัสยืนยัน" ตามความต้องการของธุรกิจ

  1. ไปที่: Console > Sign-in experience > Sign-up and sign-in
  2. ตั้งค่าวิธีสมัครสมาชิก: เลือก "Email address" หรือ "Email address or phone number" เป็นตัวระบุการสมัครสมาชิก หมายเหตุ: ปัจจุบันต้องยืนยันอีเมลเสมอในขั้นตอนสมัครสมาชิก
  3. ตั้งค่าวิธีลงชื่อเข้าใช้: ตัวระบุที่เลือกในขั้นตอนสมัครสมาชิกจะกลายเป็นวิธีลงชื่อเข้าใช้โดยอัตโนมัติ คลิก "Add another" เพื่อเพิ่มตัวเลือกการลงชื่อเข้าใช้อื่น ๆ
  4. บันทึกและทดสอบ: คลิก "Save changes" เพื่อใช้งานประสบการณ์ลงชื่อเข้าใช้ใหม่ อย่าลืมใช้ "Live preview" เพื่อทดสอบฟังก์ชัน
คำเตือน:

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

ตัวอย่างเช่น หากตัวระบุการลงชื่อเข้าใช้รวม "อีเมล + รหัสยืนยัน" การลบตัวเชื่อมต่ออีเมลจะทำให้ผู้ใช้ไม่ได้รับรหัสยืนยันทางอีเมลและเกิดข้อผิดพลาดใน flow การลงชื่อเข้าใช้

โปรดระวังความเสี่ยงที่อาจเกิดขึ้นเมื่อดำเนินการกับตัวเชื่อมต่อ

คำถามที่พบบ่อย​

จะปรับแต่งชื่อผู้ส่งอีเมลได้อย่างไร?​

เรากำลังพัฒนาตัวเชื่อมต่อเพิ่มเติม หากคุณต้องการตัวเลือกอื่น ๆ แจ้งความต้องการของคุณใน Discord และส่ง Feature Request ที่ GitHub หากต้องการความช่วยเหลือเพิ่มเติม สามารถ ติดต่อเราทางอีเมล ได้เช่นกัน

สำหรับผู้ร่วมพัฒนา เรามีวิธีสร้างตัวเชื่อมต่อที่ขยายได้ง่าย ให้คุณ ปรับแต่งตัวเชื่อมต่อของคุณเอง ตามกรณีใช้งานเฉพาะของคุณ คุณสามารถส่ง pull request มายัง Logto ได้เสมอ เพื่อให้ชุมชนได้รับประโยชน์ร่วมกัน

จะจำกัด IP สำหรับคำขออีเมลใน Logto email connectors ได้อย่างไร?​

วิธีหนึ่งคือใช้ Logto HTTP email connector

ให้คุณสร้าง API endpoint บนเซิร์ฟเวอร์ของคุณที่เรียกบริการอีเมลที่เกี่ยวข้อง และเรียก endpoint นี้ผ่าน HTTP email connector ของ Logto วิธีนี้จะช่วยให้คุณควบคุม IP ของ endpoint ได้อย่างสมบูรณ์ และสามารถเพิ่ม IP ที่ต้องการลงใน whitelist ของผู้ให้บริการอีเมลได้