Устранение ошибок TLS-сертификата Synapse Federation

Когда в логах Matrix Synapse SSL: CERTIFICATE_VERIFY_FAILEDво время федерации появляются сообщения, подключение может зависнуть, удаленный сервер может отклонить ваше соединение, или сообщения могут не дойти. Сначала определите, какой сертификат неисправен: сертификат удаленного сервера во время исходящего запроса или сертификат вашей собственной конечной точки федерации при подключении другого сервера. Затем исправьте цепочку сертификатов, имя хоста или конфигурацию доверия, которые указаны в логах и в результатах теста федерации. Не отключайте проверку TLS в качестве общего решения проблемы.

В протоколе Matrix для межсерверных соединений используется HTTPS, и спецификация Matrix требует, чтобы принимающая сторона предоставляла TLS-сертификат, подписанный признанным центром сертификации. Ошибка проверки обычно означает, что предоставленный сертификат просрочен, неполный, выдан для другого имени хоста или подписан центром сертификации, которому подключающийся сервер не доверяет. Обратный прокси-сервер также может предоставлять неправильный сертификат, даже если собственная конфигурация Synapse выглядит корректной.

1. Прежде чем вносить изменения в конфигурацию, определите неисправную сторону.

Проверьте запись в журнале Synapse, связанную с ошибкой, и запишите имя удаленного сервера и точную ошибку сертификата. Если Synapse сообщает об ошибке при отправке запроса на другой домашний сервер, проблема может быть связана с сертификатом удаленного сервера или доверием к центру сертификации, используемому вашим процессом Synapse. Если другие серверы не могут установить федеративное соединение с вашим доменом, проверьте вместо этого вашу публичную конечную точку TLS и обнаружение серверов.

Подтвердите имя вашего сервера Matrix homeserver.yaml, особенно в поле 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, должно совпадать с 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 по настройке обратного прокси-сервера для используемого вами прослушивателя и прокси.

Проверьте также 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отключение проверки сертификата для исходящей федерации. По умолчанию эта опция trueотключена; её отключение исключает проверку сертификата для исходящей федерации и ослабляет защиту от подмены личности. Отдельная опция federation_certificate_verification_whitelistсуществует для узких, специфических случаев, таких как скрытые сервисы Tor или контролируемые частные установки, а не в качестве замены для восстановления публичного сертификата. Для частной инфраструктуры, как правило, предпочтительнее использовать доверенный частный центр сертификации.

5. Проверьте время и проведите повторное тестирование.

Если даты сертификата отображаются как недействительные, даже если сам сертификат актуален, проверьте системные часы и синхронизацию времени на хосте Synapse и любом прокси-сервере. Существенно неверные часы могут привести к тому, что действительный сертификат будет отображаться как недействительный или просроченный. Также убедитесь, что автоматическое обновление действительно обновило файл, предоставляемый публично; обновление сертификата на диске не гарантирует, что прокси-сервер его перезагрузил.

После исправления ошибки повторно запустите тестер федерации и повторите попытку подключения, которая завершилась неудачей. Убедитесь, что тестер видит ожидаемое имя хоста, действительные даты и цепочку доверенных сертификатов, и проверьте журналы Synapse на наличие новых попыток федерации без ошибки проверки сертификата. Если тестер проходит успешно, но один из удаленных серверов по-прежнему не проходит проверку, зафиксируйте имя этого сервера, метку времени и соответствующую очищенную запись в журнале: возможно, проблема заключается в его собственном сертификате или среде доверия. Не передавайте закрытые ключи, токены доступа или содержимое сообщений пользователей во время устранения неполадок.

Оставить комментарий

Подключите Element Web к Keycloak через Synapse OIDC.

Настройте клиент Keycloak OIDC и провайдер Synapse, чтобы пользователи Element Web могли входить в систему через ваш сервер идентификации, не раскрывая секретные данные клиентов.

Настройте безопасное резервное копирование ключей элементов и перекрестную подпись.

Настройте безопасное резервное копирование ключей элементов и перекрестную подпись.

Сохраните ключ восстановления, проверьте свои сеансы Element и убедитесь, что ключи зашифрованных сообщений можно восстановить, не путая резервную копию с паролем вашей учетной записи.

Остановите сбои памяти Matrix Synapse во время синхронизации клиента.

Диагностика сбоев, связанных с нехваткой памяти в Synapse во время синхронизации, безопасная настройка кэширования, выявление задержек запросов и проверка стабильного использования памяти.

Устранение ошибок TLS-сертификата Synapse Federation

Выявите причину сбоев сертификатов федерации Matrix и определите правильный сервер, восстановите цепочку TLS или доверие к центру сертификации, а также проверьте правильность решения без отключения проверок безопасности.

Безопасная установка сервера 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, список политик и проверки разрешений.

Включите встроенную синхронизацию Matrix Sliding для более быстрой загрузки на мобильных устройствах.

Включите встроенную синхронизацию Matrix Sliding для более быстрой загрузки на мобильных устройствах.

Откажитесь от устаревшего прокси и настройте встроенную в Synapse функцию Sliding Sync. Проверьте обнаружение клиентов, затем измерьте скорость загрузки списка комнат и поведение при переподключении на совместимом телефоне.

Разместите Element Web на Nginx с пользовательским Homeserver.

Разверните Element Web как статический сайт, укажите в качестве сервера ваш домашний сервер Matrix, добавьте HTTPS и настройте Nginx для обслуживания обновлений без устаревших файлов.

Запустите облегченный домашний сервер Matrix на Raspberry Pi 4.

Настройте Conduit на 64-битном Raspberry Pi 4 с сохранением данных, федерацией HTTPS, защищенной регистрацией и проверкой работоспособности домашнего сервера.