เมื่อบันทึกของ Matrix Synapse แสดงข้อผิดSSL: CERTIFICATE_VERIFY_FAILEDพลาดระหว่างการเชื่อมต่อเครือข่าย การเข้าร่วมอาจหยุดชะงัก เซิร์ฟเวอร์ระยะไกลอาจปฏิเสธการเชื่อมต่อของคุณ หรือข้อความอาจไม่ส่งถึง ขั้นแรกให้ตรวจสอบว่าใบรับรองใดมีปัญหา: ใบรับรองของเซิร์ฟเวอร์ระยะไกลระหว่างการร้องขอขาออก หรือใบรับรองของปลายทางเครือข่ายของคุณเองเมื่อเซิร์ฟเวอร์อื่นเชื่อมต่อ จากนั้นซ่อมแซมห่วงโซ่ใบรับรอง ชื่อโฮสต์ หรือการกำหนดค่าความเชื่อถือที่บันทึกและการทดสอบเครือข่ายระบุ อย่าปิดใช้งานการตรวจสอบ TLS เป็นวิธีแก้ปัญหาทั่วไป
การรับส่งข้อมูลระหว่างเซิร์ฟเวอร์ของ Matrix ใช้ HTTPS และข้อกำหนดของ Matrix กำหนดให้ปลายทางต้องแสดงใบรับรอง TLS ที่ลงนามโดยหน่วยงานออกใบรับรองที่ได้รับการยอมรับ ข้อผิดพลาดในการตรวจสอบมักหมายความว่าใบรับรองที่แสดงหมดอายุ ไม่สมบูรณ์ ออกให้สำหรับชื่อโฮสต์ที่แตกต่างกัน หรือลงนามโดยหน่วยงานออกใบรับรองที่เซิร์ฟเวอร์ที่เชื่อมต่อไม่ไว้วางใจ นอกจากนี้ พร็อกซีแบบย้อนกลับอาจแสดงใบรับรองที่ไม่ถูกต้องแม้ว่าการกำหนดค่าของ Synapse เองจะดูถูกต้องก็ตาม
1. ระบุฝั่งที่เกิดปัญหาให้ชัดเจนก่อนทำการเปลี่ยนแปลงการตั้งค่า
ตรวจสอบบันทึกของ Synapse เกี่ยวกับความล้มเหลวและจดบันทึกชื่อเซิร์ฟเวอร์ระยะไกลและข้อผิดพลาดของใบรับรองอย่างแม่นยำ หาก Synapse รายงานความล้มเหลวขณะทำการร้องขอไปยังโฮมเซิร์ฟเวอร์อื่น แสดงว่าใบรับรองของเซิร์ฟเวอร์ระยะไกลหรือความเชื่อถือ CA ที่กระบวนการ Synapse ของคุณใช้นั้นเป็นสาเหตุ หากเซิร์ฟเวอร์อื่นไม่สามารถเชื่อมต่อกับโดเมนของคุณได้ ให้ตรวจสอบจุดเชื่อมต่อ TLS สาธารณะและการค้นหาเซิร์ฟเวอร์แทน
ตรวจสอบชื่อเซิร์ฟเวอร์ Matrix ของคุณจากไฟล์homeserver.yaml`<address>` โดยเฉพาะอย่างยิ่ง `<address>` server_nameนี่คือส่วนโดเมนของรหัส Matrix ในเครื่อง และเป็นตัวกำหนดว่าโฮมเซิร์ฟเวอร์อื่นๆ จะเข้าถึงคุณได้อย่างไร อย่าสับสนกับชื่อโฮสต์ภายในของเครื่องหรือคอนเทนเนอร์เอกสารการติดตั้ง Synapse ฉบับปัจจุบัน อธิบายว่าชื่อเซิร์ฟเวอร์เป็นรหัสประจำตัวของสหพันธ์ และแนะนำให้เลือกชื่อนี้ก่อนการติดตั้ง
2. ทดสอบใบรับรองสาธารณะและเส้นทางการเชื่อมโยงเครือข่าย
ใช้เครื่องมือ ทดสอบการเชื่อมต่อ เครือข่าย Matrix Federation Testerโดยใช้ชื่อเซิร์ฟเวอร์ Matrix ของคุณ เครื่องมือนี้จะตรวจสอบการค้นหาและการเชื่อมต่อเครือข่าย และสามารถเปิดเผยได้ว่าใบรับรองหรือการกำหนดเส้นทางที่มองเห็นได้จากภายนอกนั้นล้มเหลวหรือไม่ แก้ไขปัญหาที่เครื่องมือระบุ ก่อนที่จะปรับการตั้งค่าความเชื่อถือขาออกของ Synapse
จากเครื่องที่สามารถเข้าถึงเอนด์พอยต์ของเฟเดอเรชันของคุณได้ ให้ตรวจสอบใบรับรอง TLS แทนที่matrix.example.orgด้วยชื่อโฮสต์ที่ควรแสดงใบรับรอง และใช้พอร์ตเฟเดอเรชันจริงของคุณ พอร์ต 8448 เป็นพอร์ตที่ใช้กันทั่วไป แต่รีเวิร์สพร็อกซีหรือเซิร์ฟเวอร์ที่ได้รับมอบหมายอาจใช้พอร์ตอื่น
openssl s_client -connect matrix.example.org:8448 \
-servername matrix.example.org -showcerts </dev/null
ตัวเลือก นี้-servernameจะส่ง SNI (Server Name Indication) เพื่อให้พร็อกซีที่โฮสต์เสมือนสามารถเลือกใบรับรองสำหรับชื่อที่ร้องขอได้ ตรวจสอบผลลัพธ์เพื่อดูว่าการตรวจสอบสำเร็จหรือไม่ จากนั้นตรวจสอบหัวข้อและวันหมดอายุของใบรับรอง:
openssl s_client -connect matrix.example.org:8448 \
-servername matrix.example.org </dev/null 2>/dev/null | \
openssl x509 -noout -subject -issuer -dates -ext subjectAltName
ชื่อที่ใช้โดย Matrix federation ต้องตรงกับชื่อ DNS ใน Subject Alternative Name ของใบรับรอง นอกจากนี้ ตรวจสอบด้วยว่าใบรับรองยังคงใช้งานได้และปลายทางส่งใบรับรองระดับกลางมาด้วย หากคุณใช้พร็อกซีแบบย้อนกลับ ให้ทดสอบที่อยู่พร็อกซีสาธารณะ: ไฟล์ใบรับรองที่ถูกต้องบนโฮสต์ Synapse จะไม่ช่วยอะไรหากพร็อกซีให้บริการใบรับรองที่ล้าสมัยหรือไม่เกี่ยวข้อง
3. แก้ไขใบรับรองที่ Synapse ให้บริการ
หากโปรแกรมทดสอบรายงานปัญหาเกี่ยวกับใบรับรองสำหรับเซิร์ฟเวอร์ของคุณ ให้ต่ออายุหรือออกใบรับรองใหม่สำหรับชื่อโฮสต์ของเฟเดอเรชัน และกำหนดค่าเอนด์พอยต์ TLS สาธารณะให้ให้บริการห่วงโซ่ใบรับรองทั้งหมด คู่มือการกำหนดค่าปัจจุบันของ Synapse ระบุว่าtls_certificate_pathต้องชี้ไปยังใบรับรอง PEM ที่มีใบรับรองระดับกลาง สำหรับ Certbot ให้ใช้fullchain.pemไม่ใช่cert.pemเก็บคีย์ส่วนตัวไว้ในtls_private_key_pathไฟล์แยกต่างหากและป้องกันไม่ให้บุคคลภายนอกเข้าถึงได้
เมื่อ TLS สิ้นสุดลงที่ Nginx, Caddy หรือพร็อกซีแบบย้อนกลับอื่นๆ ให้ทำการอัปเดตใบรับรองและห่วงโซ่ใบรับรองในการตั้งค่าพร็อกซีนั้น จากนั้นโหลดพร็อกซีใหม่โดยใช้วิธีที่เหมาะสมกับการติดตั้งของคุณ เส้นทางใบรับรอง TLS ของ Synapse เองอาจไม่สามารถควบคุมใบรับรองที่เพื่อนร่วมเครือข่ายมองเห็นได้ในกรณีนี้ โปรดปฏิบัติตามเอกสารประกอบพร็อกซีแบบย้อนกลับอย่างเป็นทางการของ Synapseสำหรับการตั้งค่า Listener และพร็อกซีที่คุณใช้
ตรวจสอบการค้นหาเซิร์ฟเวอร์ DNS และ Matrix ด้วย Federation อาจแก้ไขชื่อเซิร์ฟเวอร์ของคุณโดยตรง หรืออาจใช้/.well-known/matrix/serverการมอบหมายไปยังชื่อโฮสต์และพอร์ตอื่น ใบรับรองต้องถูกต้องสำหรับชื่อโฮสต์ที่เข้าถึงได้โดยเส้นทางการค้นหานั้น บันทึก DNS ที่ล้าสมัยหรือการมอบหมายที่ไม่ถูกต้องอาจทำให้โหนดอื่นชี้ไปยังปลายทางที่มีใบรับรองที่ไม่เกี่ยวข้อง
4. ซ่อมแซมความไว้วางใจขาออกสำหรับสหพันธ์ส่วนตัว
หากใบรับรองที่ใช้งานไม่ได้นั้นเป็นของโฮมเซิร์ฟเวอร์ระยะไกลบนเครือข่ายส่วนตัว ให้ตรวจสอบก่อนว่าใบรับรองนั้นออกโดยหน่วยงานออกใบรับรอง (CA) ส่วนตัวของคุณโดยเจตนา ติดตั้งและดูแลรักษา CA นั้นบนโฮสต์ Synapse เมื่อเป็นไปได้ Synapse ยังรองรับfederation_custom_ca_listใบรับรอง CA แบบกำหนดเองที่ใช้สำหรับการรวมระบบ ตัวเลือกนี้ต้องการไฟล์ PEM และจะแทนที่รายการ CA ที่ระบบปฏิบัติการจัดหาให้ ดังนั้นควรเพิ่ม CA ทุกตัวที่การใช้งานของคุณต้องการ แทนที่จะเพิ่ม CA ส่วนตัวเพียงตัวเดียวโดยไม่ตรวจสอบให้ดี
federation_custom_ca_list:
- /etc/matrix-synapse/certs/private-root-ca.pem
ตั้งค่าเส้นทางไปยังใบรับรอง CA ไม่ใช่คีย์ส่วนตัวของเซิร์ฟเวอร์ ตรวจสอบให้แน่ใจว่ากระบวนการ Synapse สามารถอ่านได้ ตรวจสอบความถูกต้องของการเยื้อง YAML และรีสตาร์ทหรือโหลด Synapse ใหม่ตามวิธีการติดตั้งของคุณคู่มือการกำหนดค่า Synapseระบุว่าตัวเลือกนี้โดยปกติแล้วมีไว้สำหรับเครือข่ายโฮมเซิร์ฟเวอร์ส่วนตัว
อย่าตั้งค่าfederation_verify_certificates: falseให้ปิดเสียงข้อผิดพลาดของสหพันธ์สาธารณะ ค่าเริ่มต้นคือtrueปิดอยู่ การปิดใช้งานจะลบการตรวจสอบใบรับรองสำหรับสหพันธ์ขาออกและลดการป้องกันการปลอมแปลงตัวตน ตัวเลือกแยกต่างหากนี้federation_certificate_verification_whitelistมีไว้สำหรับกรณีเฉพาะเจาะจง เช่น บริการ Tor Hidden Services หรือการตั้งค่าส่วนตัวที่ควบคุมได้ ไม่ใช่เพื่อทดแทนการซ่อมแซมใบรับรองสาธารณะ สำหรับโครงสร้างพื้นฐานส่วนตัว โดยทั่วไปแล้วควรใช้ CA ส่วนตัวที่เชื่อถือได้
5. ตรวจสอบเวลาและทดสอบซ้ำ
หากวันที่ในใบรับรองดูเหมือนไม่ถูกต้อง แม้ว่าใบรับรองจะยังใช้งานได้อยู่ ให้ตรวจสอบนาฬิการะบบและการซิงโครไนซ์เวลาบนโฮสต์ Synapse และพร็อกซีใดๆ นาฬิกาที่ผิดเพี้ยนอย่างมากอาจทำให้ใบรับรองที่ถูกต้องดูเหมือนไม่ถูกต้องหรือหมดอายุแล้ว นอกจากนี้ ให้ตรวจสอบว่าการต่ออายุอัตโนมัติได้อัปเดตไฟล์ที่ให้บริการต่อสาธารณะแล้วหรือไม่ การต่ออายุใบรับรองบนดิสก์ไม่ได้รับประกันว่าพร็อกซีได้โหลดไฟล์นั้นใหม่แล้ว
หลังจากแก้ไขแล้ว ให้เรียกใช้ Federation Tester อีกครั้งและลองเชื่อมต่อซ้ำอีกครั้งหลังจากที่การเชื่อมต่อล้มเหลว ตรวจสอบให้แน่ใจว่า Tester เห็นชื่อโฮสต์ที่คาดหวัง วันที่ถูกต้อง และห่วงโซ่ความน่าเชื่อถือ และตรวจสอบบันทึกของ Synapse เพื่อดูความพยายามในการเชื่อมต่อใหม่โดยไม่มีข้อผิดพลาดในการตรวจสอบใบรับรอง หาก Tester ผ่าน แต่เซิร์ฟเวอร์ระยะไกลยังคงล้มเหลวอยู่ ให้บันทึกชื่อเซิร์ฟเวอร์ เวลา และรายการบันทึกที่เกี่ยวข้องที่ผ่านการกรองแล้ว: ใบรับรองหรือสภาพแวดล้อมความน่าเชื่อถือของเซิร์ฟเวอร์นั้นอาจเป็นปัญหาที่เหลืออยู่ อย่าแชร์คีย์ส่วนตัว โทเค็นการเข้าถึง หรือเนื้อหาข้อความของผู้ใช้ในระหว่างการแก้ไขปัญหา