แก้ไขข้อผิดพลาดเกี่ยวกับใบรับรอง TLS ของ Synapse Federation

เมื่อบันทึกของ 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 ผ่าน แต่เซิร์ฟเวอร์ระยะไกลยังคงล้มเหลวอยู่ ให้บันทึกชื่อเซิร์ฟเวอร์ เวลา และรายการบันทึกที่เกี่ยวข้องที่ผ่านการกรองแล้ว: ใบรับรองหรือสภาพแวดล้อมความน่าเชื่อถือของเซิร์ฟเวอร์นั้นอาจเป็นปัญหาที่เหลืออยู่ อย่าแชร์คีย์ส่วนตัว โทเค็นการเข้าถึง หรือเนื้อหาข้อความของผู้ใช้ในระหว่างการแก้ไขปัญหา

ฝากความเห็น

แก้ไขข้อผิดพลาดเกี่ยวกับสิทธิ์การดูแลระบบห้อง Matrix โดยการดำเนินการ

ตรวจสอบหาสาเหตุของการบล็อก M_FORBIDDEN ว่าเกี่ยวข้องกับระดับพลังงานในห้อง การเป็นสมาชิก หรือสิทธิ์การเข้าถึงของผู้ดูแลระบบเซิร์ฟเวอร์ Synapse จากนั้นให้กู้คืนเฉพาะสิทธิ์ที่จำเป็นสำหรับการกระทำที่ถูกบล็อกเท่านั้น

ทำให้เซิร์ฟเวอร์ Matrix Synapse ของคุณสามารถเชื่อมต่อกับ Federation ได้

ทำให้เซิร์ฟเวอร์ Matrix Synapse ของคุณสามารถเชื่อมต่อกับ Federation ได้

ตั้งค่าการค้นหา Synapse, HTTPS และการกำหนดเส้นทางพร็อกซี เพื่อให้โฮมเซิร์ฟเวอร์ Matrix อื่นๆ สามารถค้นหาและติดต่อเซิร์ฟเวอร์ของคุณได้

เชื่อมต่อ Element Web กับ Keycloak ผ่าน Synapse OIDC

กำหนดค่าไคลเอ็นต์ Keycloak OIDC และผู้ให้บริการ Synapse เพื่อให้ผู้ใช้ Element Web สามารถลงชื่อเข้าใช้ผ่านเซิร์ฟเวอร์ยืนยันตัวตนของคุณได้โดยไม่ต้องเปิดเผยรหัสลับไคลเอ็นต์

ตั้งค่าการสำรองข้อมูลคีย์ Element และการลงนามไขว้ให้ปลอดภัย

ตั้งค่าการสำรองข้อมูลคีย์ Element และการลงนามไขว้ให้ปลอดภัย

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

หยุดปัญหาหน่วยความจำ Synapse Matrix ล่มระหว่างการซิงค์ข้อมูลไคลเอ็นต์

วินิจฉัยปัญหาหน่วยความจำไม่เพียงพอของ Synapse ระหว่างการซิงค์ ปรับการแคชอย่างปลอดภัย ระบุคำขอที่ค้างอยู่ และตรวจสอบการใช้งานหน่วยความจำที่เสถียร

แก้ไขข้อผิดพลาดเกี่ยวกับใบรับรอง TLS ของ Synapse Federation

ตรวจสอบความล้มเหลวของใบรับรองการรวมระบบ Trace Matrix ไปยังเซิร์ฟเวอร์ที่ถูกต้อง ซ่อมแซมห่วงโซ่ TLS หรือความเชื่อถือ CA และตรวจสอบการแก้ไขโดยไม่ต้องปิดใช้งานการตรวจสอบความปลอดภัย

วางเซิร์ฟเวอร์ Synapse Matrix ไว้หลัง Cloudflare อย่างปลอดภัย

วางเซิร์ฟเวอร์ Synapse Matrix ไว้หลัง Cloudflare อย่างปลอดภัย

กำหนดเส้นทางไคลเอ็นต์และเฟเดอเรชันของ Matrix ผ่าน Cloudflare บน HTTPS 443 เพื่อรักษาการค้นหา Synapse และหลีกเลี่ยงการแคชการรับส่งข้อมูล API หรือการทำให้การอัปโหลดสื่อหยุดชะงัก

กู้คืน Matrix Synapse อย่างปลอดภัยด้วยการสำรองข้อมูล PostgreSQL

สำรองข้อมูล Synapse ด้วย pg_dump ป้องกันคีย์ลงนามและสื่อบันทึกข้อมูล และกู้คืนลงในฐานข้อมูล PostgreSQL ที่สะอาดโดยไม่ใช้คีย์แบบใช้ครั้งเดียวที่หมดอายุแล้ว

เรียกใช้ Mjölnir เป็นบอทควบคุมห้องสนทนาใน Matrix ด้วย Docker

เรียกใช้ Mjölnir เป็นบอทควบคุมห้องสนทนาใน Matrix ด้วย Docker

ตั้งค่า Mjölnir ด้วยบัญชี Matrix เฉพาะ, ห้องจัดการที่เข้ารหัส, Docker Compose, รายการนโยบาย และการตรวจสอบสิทธิ์

เปิดใช้งาน Native Matrix Sliding Sync เพื่อการโหลดบนมือถือที่เร็วขึ้น

เปิดใช้งาน Native Matrix Sliding Sync เพื่อการโหลดบนมือถือที่เร็วขึ้น

ข้ามขั้นตอนการใช้พร็อกซีที่เลิกใช้งานแล้ว และกำหนดค่า Sliding Sync ที่มีอยู่ใน Synapse ตรวจสอบการค้นหาไคลเอ็นต์ จากนั้นวัดการโหลดรายการห้องและพฤติกรรมการเชื่อมต่อใหม่บนโทรศัพท์ที่ใช้งานร่วมกันได้