เชื่อมต่อ Gmail หรือ Microsoft 365 กับ Nextcloud Mail โดยใช้ OAuth2

ในการเชื่อมต่อ Gmail หรือ Microsoft 365 กับ Nextcloud Mail โดยใช้ OAuth2 ให้ลงทะเบียนเว็บแอปพลิเคชันกับผู้ให้บริการอีเมล คัดลอก URI การเปลี่ยนเส้นทางของ Nextcloud Mail ลงในการลงทะเบียนนั้น และบันทึก Client ID และ Secret ไว้ในการตั้งค่าการดูแลระบบ Groupware ของ Nextcloud จากนั้นเชื่อมต่อกล่องจดหมายในแอป Mail และอนุมัติข้อความแจ้งให้ลงชื่อเข้าใช้ของผู้ให้บริการ การตั้งค่าที่ใช้งานได้จะต้องสามารถโหลดข้อความขาเข้าและส่งข้อความทดสอบได้ ไม่ใช่เพียงแค่แสดงหน้าจอการอนุญาตที่สำเร็จเท่านั้น

ตรวจสอบให้แน่ใจว่าบัญชีและการติดตั้ง Nextcloud ของคุณรองรับวิธีการนี้

Nextcloud Mail ใช้ IMAP ในการอ่านข้อความและ SMTP ในการส่งข้อความ OAuth2 จะขออนุญาตจากผู้ให้บริการยืนยันตัวตน XOAUTH2 เป็นกลไกที่ไคลเอนต์อีเมลใช้ในการแสดงโทเค็นการเข้าถึงแก่บริการอีเมลเหล่านี้ อย่างไรก็ตาม มันไม่ได้เปลี่ยนการเข้าสู่ระบบ Nextcloud ให้เป็นการเข้าสู่ระบบแบบครั้งเดียว (Single Sign-On) ที่ใช้ได้กับทุกเซิร์ฟเวอร์อีเมล

เอกสารการดูแลระบบปัจจุบันของ Nextcloud อธิบายถึงการผสานรวม Gmail OAuth และ Microsoft Outlook XOAUTH2 โดยเฉพาะ การสนับสนุน Microsoft ถูกเพิ่มเข้ามาใน Mail เวอร์ชัน 3.0.0; ข้อความในเมนูอาจแตกต่างกันไปตามเวอร์ชันของ Mail และ Nextcloud คู่มือนี้อ้างอิงจากคู่มือการดูแลระบบ Nextcloud 35 Mailฉบับล่าสุดที่ตรวจสอบเมื่อเดือนตุลาคม 2026

• ใช้ URL ของ Nextcloud ที่ใช้ HTTPS ซึ่งสามารถเปิดได้อย่างเสถียรจากเบราว์เซอร์ โดยต้องติดตั้งและเปิดใช้งานแอป Mail ไว้ด้วย
• ต้องมีสิทธิ์เข้าถึงระดับผู้ดูแลระบบ Nextcloud และได้รับอนุญาตให้ลงทะเบียนแอปพลิเคชัน OAuth ใน Google Cloud หรือ Microsoft Entra
• ตรวจสอบว่าบัญชีนั้นเป็น Gmail/Google Workspace, Outlook.com หรือกล่องจดหมาย Microsoft 365 ที่โฮสต์อยู่ใน Exchange Online
• ตรวจสอบให้แน่ใจว่าผู้ให้บริการอนุญาตการเข้าถึง IMAP และสำหรับการส่งอีเมล อนุญาตให้ใช้ SMTP ที่มีการตรวจสอบสิทธิ์ตามนโยบายขององค์กร

ข้อจำกัดที่สำคัญ:ผู้ให้บริการ IMAP แบบกำหนดเองที่ยอมรับ OAuth2 จะไม่ได้รับการสนับสนุนโดยอัตโนมัติในหน้าจอการกำหนดค่า Gmail/Microsoft ของ Nextcloud Mail เอกสารคำขอคุณสมบัติ Nextcloud Mail สำหรับผู้ให้บริการ OAuth2 ทั่วไปได้อธิบายความแตกต่างนี้ไว้แล้ว สำหรับผู้ให้บริการรายอื่น โปรดตรวจสอบเวอร์ชัน Mail ของคุณและวิธีการตรวจสอบสิทธิ์ที่รองรับ แทนที่จะป้อนข้อมูลประจำตัว Google หรือ Microsoft ที่ไม่เกี่ยวข้อง

ลงทะเบียนไคลเอ็นต์ OAuth ด้วย URI การเปลี่ยนเส้นทางที่ถูกต้อง

Gmail หรือ Google Workspace

1. ใน Nextcloud ให้เข้าสู่ระบบในฐานะผู้ดูแลระบบ เปิดการตั้งค่าการดูแลระบบ → กลุ่มงานและค้นหาการผสานรวม Gmailคัดลอก URI การเปลี่ยนเส้นทางที่แสดงโดยอินสแตนซ์ของคุณ อย่าคิดว่า URL ที่คัดลอกมาจากการติดตั้งของผู้อื่นนั้นถูกต้องเสมอไป
2. เปิดGoogle Cloud Consoleและเลือกหรือสร้างโปรเจ็กต์ กำหนดค่าการยินยอม/การสร้างแบรนด์และการตั้งค่ากลุ่มเป้าหมายของ Google Auth Platform ให้เหมาะสมกับองค์กร Workspace หรือผู้ใช้ภายนอกของคุณ เพิ่มผู้ใช้ทดสอบหากแอปพลิเคชันยังอยู่ในขั้นตอนการทดสอบ
3. สร้างไคลเอ็นต์ OAuth ประเภทเว็บแอปพลิ เค ชัน ใส่ URL ที่ถูกต้องจาก Nextcloud ในช่องAuthorized redirect URIsจากนั้นบันทึก Client ID และ Client Secret อย่างปลอดภัย Google กำหนดให้ต้องตรงกับ redirect URI ทุกประการ รวมถึงรูปแบบ (scheme), เส้นทาง (path), ตัวพิมพ์ใหญ่-เล็ก และเครื่องหมายทับท้าย (trailing slash)
4. ตรวจสอบขอบเขตการอนุญาตและข้อกำหนดการเผยแพร่ การเข้าถึง Gmail IMAP และ SMTP ใช้ OAuth https://mail.google.com/ซึ่งมีขอบเขตจำกัดในวงกว้าง และอยู่ภายใต้ข้อกำหนดด้านข้อมูลผู้ใช้และการตรวจสอบของ Google ผู้ดูแลระบบต้องพิจารณาว่าการใช้งานที่เสนอมานั้นตรงตามข้อกำหนดเหล่านั้นหรือไม่

Google ได้อธิบายขั้นตอนการลงทะเบียนเว็บเซิร์ฟเวอร์ไว้ในคำแนะนำการใช้งานเว็บแอปพลิเคชัน OAuth2 รวมถึง ขอบเขตและโปรโตคอล XOAUTH2 ของ Gmailโดยเฉพาะการกำหนดค่าทดสอบมีประโยชน์สำหรับการตรวจสอบความถูกต้องเบื้องต้น แต่โดยทั่วไปแล้วแอปพลิเคชัน OAuth ภายนอกที่ตั้งไว้ในโหมดทดสอบจะได้รับโทเค็นรีเฟรชที่จะหมดอายุหลังจากเจ็ดวันเมื่อขอสิทธิ์เข้าถึงอีเมล Gmail โปรดดู คำแนะนำเกี่ยวกับ การหมดอายุของโทเค็นจาก Google การอนุญาตซ้ำทุกสัปดาห์จึงอาจบ่งชี้ถึงข้อจำกัดของสถานะการเผยแพร่มากกว่ารหัสผ่าน IMAP ที่เสีย

Microsoft 365 หรือ Outlook.com

1. ในเมนูการตั้งค่าการดูแลระบบของ Nextcloud → Groupwareให้ค้นหาการผสานรวมกับ Microsoftและคัดลอก URI การเปลี่ยนเส้นทางที่แสดง
2. ในศูนย์การจัดการ Microsoft Entraให้ไปที่การลงทะเบียนแอปและสร้างการลงทะเบียน สำหรับประเภทบัญชีที่อธิบายไว้ในคู่มือมาตรฐานของ Nextcloud ให้เลือกทั้งบัญชี Microsoft ขององค์กรและส่วนบุคคล ใช้ แพลตฟอร์มการเปลี่ยนเส้นทาง เว็บและป้อน URI ของ Nextcloud ให้ถูกต้อง
3. คัดลอกรหัสแอปพลิเคชัน (ไคลเอ็นต์)ภายใต้ใบรับรองและความลับให้สร้างความลับไคลเอ็นต์และคัดลอกค่า ของความลับนั้น ทันที ไม่ใช่ตัวระบุความลับ บันทึกวันหมดอายุลงในปฏิทินการดำเนินงานของคุณ
4. ใช้สิทธิ์ที่ได้รับมอบหมายที่เกี่ยวข้องกับอีเมลซึ่งจำเป็นสำหรับขั้นตอน OAuth ของ IMAP และ SMTP ของผู้ให้บริการ โดยต้องได้รับความยินยอมจากองค์กรเมื่อจำเป็น เอกสารของ Microsoft ระบุขอบเขตและIMAP.AccessAsUser.Allสิทธิ์สำหรับโทเค็นรีเฟรชไว้ด้วย อย่าสับสนสิทธิ์โปรโตคอลเหล่านี้กับสิทธิ์ Microsoft Graph Mail.Read/Mail.SendSMTP.Sendoffline_access

สำหรับรายละเอียดการลงทะเบียน โปรดดูเอกสารการลงทะเบียนแอปของ Microsoftและคำแนะนำ IMAP/SMTP OAuth ของ Exchange Onlineการตั้งค่าทั่วไปที่ระบุไว้ในเอกสารของ Nextcloud จะเว้นช่องผู้เช่าไว้commonว่างเปล่า ควรใช้ค่าเฉพาะผู้เช่าหรือกลุ่มเป้าหมายที่แคบกว่าก็ต่อเมื่อผู้ดูแลระบบได้ตรวจสอบประเภทบัญชีและการเปลี่ยนแปลงนโยบายที่เกี่ยวข้องแล้วเท่านั้น

บันทึกข้อมูลการเข้าสู่ระบบใน Nextcloud และเชื่อมต่อกล่องจดหมาย

1. กลับไปที่การตั้งค่าการดูแลระบบ → กลุ่มงานวางรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ของผู้ให้บริการลงใน ส่วน การผสานรวม Gmailหรือการผสานรวม Microsoft ที่เกี่ยวข้อง แล้วบันทึก ห้ามใส่รหัสลับลงในช่อง URI การเปลี่ยนเส้นทาง หรือเผยแพร่ในภาพหน้าจอ ตั๋ว หรือระบบควบคุมเวอร์ชันเด็ดขาด
2. ลงชื่อเข้าใช้ในฐานะผู้ใช้กล่องจดหมายที่ต้องการ เปิดแอป Mailแล้วเลือกเพิ่มบัญชีอีเมล ป้อนที่อยู่อีเมล เลือกการกำหนดค่าบัญชีอัตโนมัติก่อน แล้วเริ่มเชื่อมต่อ ขั้นตอนการเชื่อมต่อของ Microsoft ที่ Nextcloud จัดทำเอกสารไว้อาจยังคงแสดงช่องรหัสผ่านอยู่ รหัสผ่านที่ป้อนไว้จะถูกละทิ้งเมื่อกำหนดค่า OAuth ของผู้ให้บริการ อย่าใส่รหัสผ่านบัญชีจริงโดยไม่จำเป็น
3. ในหน้าต่างป๊อปอัพของผู้ให้บริการ ให้เลือกบัญชี Google หรือ Microsoft ที่ถูกต้อง ตรวจสอบสิทธิ์การเข้าถึงที่ร้องขอ และให้ความยินยอมหากองค์กรของคุณอนุมัติแล้ว อนุญาตให้เบราว์เซอร์แสดงป๊อปอัพ และกลับไปยังแท็บ Nextcloud เดิมหลังจากที่ผู้ให้บริการเปลี่ยนเส้นทางกลับมา
4. หากการตั้งค่าอัตโนมัติเลือกเซิร์ฟเวอร์ผิด ให้ตรวจสอบชื่อโฮสต์ IMAP และ SMTP ด้วยตนเอง รวมถึงตัวเลือกการเข้ารหัสสำหรับผู้ให้บริการนั้นๆ ปุ่ม OAuth จะเชื่อมโยงกับปลายทาง Gmail/Microsoft ที่รู้จัก การป้อนชื่อโฮสต์ที่ไม่เกี่ยวข้องด้วยตนเองอาจไม่เปิดใช้งานขั้นตอนการเข้าสู่ระบบที่คาดหวัง

ในแบบฟอร์มบัญชี Nextcloud Mail หากเป็นปลายทางของ Google ที่กำหนดค่า OAuth ไว้แล้ว จะแสดง " ลงชื่อเข้าใช้ด้วย Google"และหากเป็นปลายทางของ Microsoft จะแสดง " ลงชื่อเข้าใช้ด้วย Microsoft " เอกสาร ต้นฉบับของแบบฟอร์มบัญชี Nextcloud Mailแสดงป้ายกำกับแบบมีเงื่อนไขเหล่านี้ การมีปุ่มเฉพาะของผู้ให้บริการเป็นสัญญาณเบื้องต้นที่มีประโยชน์ว่า Nextcloud ได้รับรู้ถึงการผสานรวมที่ต้องการแล้ว แต่ไม่ได้พิสูจน์ว่าการอนุญาตหรือการเข้าถึงกล่องจดหมายเสร็จสมบูรณ์แล้ว

แก้ไขปัญหาที่เกิดขึ้นในแต่ละขั้นตอน

ไมโครซอฟต์อธิบายการควบคุม SMTP AUTH รวมถึงการกำหนดค่าเฉพาะสำหรับแต่ละกล่องจดหมาย ในเอกสารประกอบ SMTP AUTH ของ Exchange Onlineหลีกเลี่ยงการลดความปลอดภัยของอีเมลโดยรวมเพียงเพื่อให้กล่องจดหมายเดียวใช้งานได้ หากนโยบายห้ามใช้โปรโตคอลดังกล่าว ให้ใช้ไคลเอนต์อีเมลที่ได้รับอนุมัติหรือเวิร์กโฟลว์ที่องค์กรสนับสนุนแทน

ตรวจสอบทิศทางการไหลของจดหมายทั้งสองทิศทาง

1. เปิดกล่องจดหมายเข้าใน Nextcloud Mail รีเฟรชหน้าเว็บ และตรวจสอบว่าข้อความที่ได้รับล่าสุดปรากฏขึ้นพร้อมผู้ส่ง หัวเรื่อง และเนื้อหาตามที่คาดไว้
2. ส่งอีเมลทดสอบสั้นๆ ไปยังกล่องจดหมายอื่นที่คุณควบคุมอยู่ ตรวจสอบการส่งถึงที่นั่น จากนั้นตรวจสอบโฟลเดอร์ส่งแล้วใน Nextcloud Mail วิธีนี้จะช่วยแยกปัญหาเรื่องสิทธิ์การเข้าถึง SMTP ออกจากปัญหาการซิงค์ IMAP ได้
3. ออกจากระบบแล้วเข้าสู่ระบบใหม่อีกครั้ง จากนั้นเปิดแอปเมล สำหรับการใช้งานจริง ให้ตรวจสอบอีกครั้งหลังจากที่โทเค็นการเข้าถึงได้รับการรีเฟรชตามปกติแล้ว การตรวจสอบสำเร็จในทันทีไม่ได้หมายความว่าโทเค็นจะได้รับการต่ออายุในระยะยาว

หากกล่องจดหมายยังคงไม่ซิงค์กัน เอกสารของ Nextcloud occ mail:account:exportจะระบุวิธีการค้นหา ID บัญชีอีเมลและocc mail:account:sync -vvv ACCOUNT_IDวิธีการแก้ไขปัญหาเฉพาะเจาะจงคู่มือการแก้ไขปัญหา Groupware ของ Nextcloud ยังอธิบายถึงการบันทึกข้อมูลการดีบัก IMAP/SMTP ต่อบัญชี และเตือนว่าบันทึกอาจมีข้อมูลที่ละเอียดอ่อน บันทึกเฉพาะสิ่งที่จำเป็นเท่านั้น ลบโทเค็นและที่อยู่ก่อนแชร์ และปิดการดีบักแบบละเอียดหลังจากนั้น

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