حل أخطاء شهادة TLS الخاصة باتحاد Synapse

عند ظهور سجلات Matrix Synapse SSL: CERTIFICATE_VERIFY_FAILEDأثناء عملية الاتحاد، قد تتعطل عملية الانضمام، أو قد يرفض خادم بعيد اتصالك، أو قد لا تصل الرسائل. حدد أولًا الشهادة التي بها المشكلة: شهادة الخادم البعيد أثناء طلب صادر، أو شهادة نقطة نهاية الاتحاد الخاصة بك عند اتصال خادم آخر. ثم أصلح سلسلة الشهادات، أو اسم المضيف، أو إعدادات الثقة التي تحددها السجلات واختبار الاتحاد. لا تقم بتعطيل التحقق من TLS كحل عام.

يستخدم نظام Matrix بروتوكول HTTPS في نقل البيانات بين الخوادم، وتتطلب مواصفات Matrix من الخادم المُستقبِل تقديم شهادة TLS موقعة من جهة إصدار شهادات معترف بها. عادةً ما يشير خطأ التحقق إلى أن الشهادة المقدمة منتهية الصلاحية، أو غير مكتملة، أو صادرة لاسم مضيف مختلف، أو موقعة من جهة إصدار شهادات لا يثق بها الخادم المتصل. كما يمكن للخادم الوكيل العكسي تقديم شهادة خاطئة حتى لو بدا تكوين Synapse صحيحًا.

1. حدد الجانب المعطل قبل تغيير التكوين

راجع سجل Synapse الخاص بالخطأ، ولاحظ اسم الخادم البعيد وخطأ الشهادة بالتحديد. إذا أبلغ Synapse عن الخطأ أثناء إرسال طلب إلى خادم منزلي آخر، فذلك يعني أن شهادة الخادم البعيد أو شهادة المرجع المصدق (CA) المستخدمة من قِبل عملية Synapse هي السبب. إذا تعذر على الخوادم الأخرى الاتصال بنطاقك، فافحص نقطة نهاية TLS العامة واكتشاف الخادم.

تأكد من اسم خادم Matrix الخاص بك من خلال [المصدر] homeserver.yaml، وخاصةً [المصدر server_name]. هذا هو جزء النطاق من معرّفات Matrix المحلية، وهو الذي يحدد كيفية وصول الخوادم المنزلية الأخرى إليك. لا تخلط بينه وبين اسم المضيف الداخلي للجهاز أو الحاوية. توضح وثائق تثبيت Synapse الحالية أن اسم الخادم هو هوية اتحاد، وتنصح باختياره قبل التثبيت.

2. اختبار الشهادة العامة ومسار الاتحاد

استخدم أداة اختبار اتحاد المصفوفة مع اسم خادم المصفوفة الخاص بك. تتحقق هذه الأداة من اكتشاف الاتحاد والاتصال، ويمكنها الكشف عما إذا كانت الشهادة الظاهرة خارجيًا أو التوجيه معطلاً. أصلح العنصر الذي تحدده الأداة قبل تعديل إعدادات الثقة الصادرة في Synapse.

من جهاز قادر على الوصول إلى نقطة نهاية الاتحاد، افحص شهادة TLS. استبدل matrix.example.orgاسم المضيف الذي يجب أن يعرض الشهادة، واستخدم منفذ الاتحاد الفعلي. المنفذ 8448 شائع، ولكن قد يستخدم خادم وكيل عكسي أو خادم مفوض منفذًا آخر.

openssl s_client -connect matrix.example.org:8448 \
  -servername matrix.example.org -showcerts </dev/null

يُرسل هذا -servernameالخيار إشارة اسم الخادم (SNI)، مما يسمح للوكيل المُستضاف افتراضيًا باختيار الشهادة للاسم المطلوب. تحقق من المخرجات للتأكد من نجاح عملية التحقق، ثم افحص موضوع الشهادة وتاريخ صلاحيتها.

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

يجب أن يتطابق الاسم المستخدم في اتحاد المصفوفة مع اسم نظام أسماء النطاقات (DNS) الموجود في اسم الموضوع البديل للشهادة. تحقق أيضًا من صلاحية الشهادة الحالية وأن نقطة النهاية ترسل شهاداتها الوسيطة. في حال استخدام خادم وكيل عكسي، اختبر عنوان الوكيل العام: فوجود ملف شهادة صحيح على مضيف Synapse لا يُجدي نفعًا إذا كان الوكيل يُقدّم شهادة قديمة أو غير ذات صلة.

3. إصلاح الشهادة التي يقدمها برنامج Synapse

إذا أبلغ المُختبِر عن مشكلة في شهادة خادمك، فقم بتجديد أو إعادة إصدار الشهادة لاسم مضيف الاتحاد، وقم بتهيئة نقطة نهاية TLS العامة لخدمة السلسلة الكاملة. يُشير دليل تهيئة Synapse الحالي إلى أنه tls_certificate_pathيجب أن يُشير إلى شهادة PEM تتضمن شهادات وسيطة؛ بالنسبة لـ Certbot، استخدم fullchain.pem، وليس cert.pem. احتفظ بالمفتاح الخاص في tls_private_key_pathملف منفصل واحمه من الوصول العام.

عند انتهاء اتصال TLS عند Nginx أو Caddy أو أي خادم وكيل عكسي آخر، قم بتحديث الشهادة وسلسلة الشهادات في إعدادات ذلك الخادم الوكيل، ثم أعد تحميل الخادم الوكيل باستخدام الطريقة المناسبة لتثبيتك. قد لا تتحكم مسارات شهادات TLS الخاصة بـ Synapse في الشهادة التي يراها نظراء الاتحاد في هذا الترتيب. اتبع وثائق Synapse الرسمية للخادم الوكيل العكسي لإعدادات المستمع والخادم الوكيل التي تستخدمها.

تحقق أيضًا من اكتشاف خادم DNS وMatrix. قد يقوم الاتحاد بحل اسم خادمك مباشرةً أو باتباع /.well-known/matrix/serverتفويض إلى اسم مضيف ومنفذ مختلفين. يجب أن تكون الشهادة صالحة لاسم المضيف الذي يتم الوصول إليه عبر مسار الاكتشاف هذا. قد يؤدي سجل DNS قديم أو تفويض غير صحيح إلى توجيه النظراء إلى نقطة نهاية تقدم شهادة غير ذات صلة.

4. إصلاح الثقة الصادرة لاتحاد خاص

إذا كانت الشهادة المعيبة تابعة لخادم منزلي بعيد على شبكة خاصة، فتأكد أولاً من أن الشهادة صادرة عمدًا من جهة إصدار الشهادات الخاصة بك. ثبّت هذه الجهة على مضيف Synapse وقم بصيانتها كلما أمكن. يوفر Synapse أيضًا federation_custom_ca_listشهادات مخصصة لجهات إصدار الشهادات تُستخدم في الاتحاد. يتطلب هذا الخيار ملفات PEM ويستبدل قائمة جهات إصدار الشهادات المُقدمة من نظام التشغيل، لذا أضف جميع جهات إصدار الشهادات التي يحتاجها نظامك بدلاً من إضافة جهة إصدار شهادات خاصة واحدة فقط دون تدقيق.

federation_custom_ca_list:
  - /etc/matrix-synapse/certs/private-root-ca.pem

حدد مسار شهادة المرجع المصدق، وليس المفتاح الخاص بالخادم. تأكد من قدرة برنامج Synapse على قراءتها، وتحقق من صحة مسافة YAML البادئة، ثم أعد تشغيل Synapse أو أعد تحميله وفقًا لطريقة النشر الخاصة بك. يشير دليل تكوين Synapse إلى أن هذا الخيار مخصص عادةً لشبكات الخوادم المنزلية الخاصة.

لا تقم federation_verify_certificates: falseبتعطيل خاصية كتم صوت خطأ الاتحاد العام. القيمة الافتراضية هي `false` true؛ تعطيلها يُلغي التحقق من الشهادة للاتحاد الصادر ويُضعف الحماية ضد انتحال الهوية. federation_certificate_verification_whitelistيُستخدم هذا الخيار المنفصل في حالات محددة وضيقة، مثل خدمات Tor المخفية أو الإعدادات الخاصة الخاضعة للتحكم، وليس كبديل لإصلاح الشهادة العامة. بالنسبة للبنية التحتية الخاصة، يُفضل عمومًا استخدام مرجع مصدق خاص موثوق.

5. تحقق من الوقت وأعد الاختبار

إذا ظهرت تواريخ الشهادات غير صالحة رغم أنها سارية، فتحقق من ساعة النظام ومزامنة الوقت على خادم Synapse وأي خادم وكيل. قد يؤدي وجود خطأ كبير في الساعة إلى ظهور شهادة صالحة على أنها غير صالحة أو منتهية الصلاحية. تأكد أيضًا من أن عملية التجديد التلقائي قد حدّثت الملف المُقدّم للجمهور؛ فتجديد الشهادة على القرص لا يضمن إعادة تحميلها بواسطة الخادم الوكيل.

بعد التصحيح، أعد تشغيل أداة اختبار الاتحاد وكرر الاتصال الذي فشل. تأكد من أن أداة الاختبار ترى اسم المضيف المتوقع، والتواريخ الصحيحة، وسلسلة موثوقة، وتحقق من سجلات Synapse بحثًا عن محاولات اتحاد جديدة بدون خطأ التحقق من الشهادة. إذا نجحت أداة الاختبار ولكن لا يزال أحد الخوادم البعيدة يفشل، فاحفظ اسم ذلك الخادم، والطابع الزمني، وإدخال السجل ذي الصلة بعد تنقيحه: فقد تكون شهادته أو بيئة الثقة الخاصة به هي المشكلة المتبقية. لا تشارك المفاتيح الخاصة، أو رموز الوصول، أو محتويات رسائل المستخدم أثناء استكشاف الأخطاء وإصلاحها.

اترك تعليقاً

اجعل خادم Matrix Synapse الخاص بك قابلاً للوصول إليه من أجل الاتحاد

اجعل خادم Matrix Synapse الخاص بك قابلاً للوصول إليه من أجل الاتحاد

قم بتكوين اكتشاف Synapse و HTTPS وتوجيه الوكيل حتى تتمكن خوادم Matrix المنزلية الأخرى من العثور على خادمك والاتصال به.

ربط Element Web بـ Keycloak عبر Synapse OIDC

قم بتكوين عميل Keycloak OIDC وموفر Synapse حتى يتمكن مستخدمو Element Web من تسجيل الدخول من خلال خادم الهوية الخاص بك دون الكشف عن أسرار العميل.

إعداد النسخ الاحتياطي لمفتاح العنصر والتوقيع المتبادل بأمان

إعداد النسخ الاحتياطي لمفتاح العنصر والتوقيع المتبادل بأمان

احفظ مفتاح الاسترداد، وتحقق من جلسات Element الخاصة بك، وتأكد من إمكانية استعادة مفاتيح الرسائل المشفرة دون الخلط بين النسخة الاحتياطية وكلمة مرور حسابك.

إيقاف أعطال ذاكرة Matrix Synapse أثناء مزامنة العميل

تشخيص حالات فشل نفاد الذاكرة في Synapse أثناء المزامنة، وضبط التخزين المؤقت بأمان، وتحديد تراكم الطلبات، والتحقق من استخدام الذاكرة بشكل مستقر.

حل أخطاء شهادة TLS الخاصة باتحاد Synapse

تتبع حالات فشل شهادات اتحاد المصفوفة إلى الخادم الصحيح، وإصلاح سلسلة TLS أو ثقة CA، والتحقق من الإصلاح دون تعطيل عمليات التحقق الأمني.

ضع خادم Synapse Matrix خلف Cloudflare بأمان

ضع خادم Synapse Matrix خلف Cloudflare بأمان

توجيه عملاء Matrix والاتحاد عبر Cloudflare على HTTPS 443، والحفاظ على اكتشاف Synapse، وتجنب تخزين حركة مرور API مؤقتًا أو تعطيل عمليات تحميل الوسائط.

استعادة برنامج Matrix Synapse بأمان باستخدام نسخة احتياطية من قاعدة بيانات PostgreSQL

قم بعمل نسخة احتياطية من Synapse باستخدام pg_dump، وقم بحماية مفتاح التوقيع والوسائط الخاصة به، واستعدها في قاعدة بيانات PostgreSQL نظيفة دون إعادة استخدام المفاتيح القديمة التي تستخدم لمرة واحدة.

قم بتشغيل Mjölnir كبوت لإدارة غرف المصفوفة باستخدام Docker

قم بتشغيل Mjölnir كبوت لإدارة غرف المصفوفة باستخدام Docker

قم بإعداد Mjölnir باستخدام حساب Matrix مخصص، وغرفة إدارة مشفرة، وDocker Compose، وقائمة السياسات، وفحوصات الأذونات.

تفعيل خاصية مزامنة انزلاق المصفوفة الأصلية لتحميل أسرع على الأجهزة المحمولة

تفعيل خاصية مزامنة انزلاق المصفوفة الأصلية لتحميل أسرع على الأجهزة المحمولة

تجاوز استخدام الخادم الوكيل القديم وقم بتكوين ميزة المزامنة المنزلقة المدمجة في Synapse. تحقق من اكتشاف العميل، ثم قم بقياس تحميل قائمة الغرف وسلوك إعادة الاتصال على هاتف متوافق.

استضافة موقع Element Web على خادم Nginx مع خادم منزلي مخصص

قم بنشر Element Web كموقع ثابت، وقم بتوجيهه إلى خادم Matrix الرئيسي الخاص بك، وأضف HTTPS، وقم بتكوين Nginx لتقديم التحديثات بدون ملفات قديمة.