Подключите Element Web к Keycloak через Synapse OIDC.
Настройте клиент Keycloak OIDC и провайдер Synapse, чтобы пользователи Element Web могли входить в систему через ваш сервер идентификации, не раскрывая секретные данные клиентов.
Когда в логах Matrix Synapse SSL: CERTIFICATE_VERIFY_FAILEDво время федерации появляются сообщения, подключение может зависнуть, удаленный сервер может отклонить ваше соединение, или сообщения могут не дойти. Сначала определите, какой сертификат неисправен: сертификат удаленного сервера во время исходящего запроса или сертификат вашей собственной конечной точки федерации при подключении другого сервера. Затем исправьте цепочку сертификатов, имя хоста или конфигурацию доверия, которые указаны в логах и в результатах теста федерации. Не отключайте проверку TLS в качестве общего решения проблемы.
В протоколе Matrix для межсерверных соединений используется HTTPS, и спецификация Matrix требует, чтобы принимающая сторона предоставляла TLS-сертификат, подписанный признанным центром сертификации. Ошибка проверки обычно означает, что предоставленный сертификат просрочен, неполный, выдан для другого имени хоста или подписан центром сертификации, которому подключающийся сервер не доверяет. Обратный прокси-сервер также может предоставлять неправильный сертификат, даже если собственная конфигурация Synapse выглядит корректной.
Проверьте запись в журнале Synapse, связанную с ошибкой, и запишите имя удаленного сервера и точную ошибку сертификата. Если Synapse сообщает об ошибке при отправке запроса на другой домашний сервер, проблема может быть связана с сертификатом удаленного сервера или доверием к центру сертификации, используемому вашим процессом Synapse. Если другие серверы не могут установить федеративное соединение с вашим доменом, проверьте вместо этого вашу публичную конечную точку TLS и обнаружение серверов.
Подтвердите имя вашего сервера Matrix homeserver.yaml, особенно в поле server_name. Это доменная часть локальных идентификаторов Matrix, определяющая, как другие домашние серверы могут с вами связаться. Не путайте его с внутренним именем хоста машины или контейнера. В текущей документации по установке Synapse поясняется, что имя сервера является идентификатором федерации, и рекомендуется выбрать его до установки.
Используйте инструмент 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 не поможет, если прокси-сервер предоставляет устаревший или не относящийся к делу сертификат.
Если тестировщик сообщает о проблеме с сертификатом для вашего сервера, обновите или перевыпустите сертификат для имени хоста федерации и настройте публичную конечную точку 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 или некорректное делегирование могут направлять узлы к конечной точке, предоставляющей несвязанный сертификат.
Если неработающий сертификат принадлежит удаленному домашнему серверу в частной сети, сначала убедитесь, что сертификат был намеренно выдан вашим частным центром сертификации (ЦС). По возможности установите и поддерживайте этот ЦС на хосте 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 или контролируемые частные установки, а не в качестве замены для восстановления публичного сертификата. Для частной инфраструктуры, как правило, предпочтительнее использовать доверенный частный центр сертификации.
Если даты сертификата отображаются как недействительные, даже если сам сертификат актуален, проверьте системные часы и синхронизацию времени на хосте Synapse и любом прокси-сервере. Существенно неверные часы могут привести к тому, что действительный сертификат будет отображаться как недействительный или просроченный. Также убедитесь, что автоматическое обновление действительно обновило файл, предоставляемый публично; обновление сертификата на диске не гарантирует, что прокси-сервер его перезагрузил.
После исправления ошибки повторно запустите тестер федерации и повторите попытку подключения, которая завершилась неудачей. Убедитесь, что тестер видит ожидаемое имя хоста, действительные даты и цепочку доверенных сертификатов, и проверьте журналы Synapse на наличие новых попыток федерации без ошибки проверки сертификата. Если тестер проходит успешно, но один из удаленных серверов по-прежнему не проходит проверку, зафиксируйте имя этого сервера, метку времени и соответствующую очищенную запись в журнале: возможно, проблема заключается в его собственном сертификате или среде доверия. Не передавайте закрытые ключи, токены доступа или содержимое сообщений пользователей во время устранения неполадок.
Настройте клиент Keycloak OIDC и провайдер Synapse, чтобы пользователи Element Web могли входить в систему через ваш сервер идентификации, не раскрывая секретные данные клиентов.
Сохраните ключ восстановления, проверьте свои сеансы Element и убедитесь, что ключи зашифрованных сообщений можно восстановить, не путая резервную копию с паролем вашей учетной записи.
Диагностика сбоев, связанных с нехваткой памяти в Synapse во время синхронизации, безопасная настройка кэширования, выявление задержек запросов и проверка стабильного использования памяти.
Выявите причину сбоев сертификатов федерации Matrix и определите правильный сервер, восстановите цепочку TLS или доверие к центру сертификации, а также проверьте правильность решения без отключения проверок безопасности.
Маршрутизация клиентов Matrix и федерация через Cloudflare по протоколу HTTPS 443, сохранение обнаружения Synapse и предотвращение кэширования API-трафика или нарушения загрузки медиафайлов.
Создайте резервную копию Synapse с помощью pg_dump, защитите ключ подписи и носители, а затем восстановите данные в чистую базу данных PostgreSQL, не используя повторно устаревшие одноразовые ключи.
Настройте Mjölnir, используя выделенный аккаунт Matrix, зашифрованную комнату управления, Docker Compose, список политик и проверки разрешений.
Откажитесь от устаревшего прокси и настройте встроенную в Synapse функцию Sliding Sync. Проверьте обнаружение клиентов, затем измерьте скорость загрузки списка комнат и поведение при переподключении на совместимом телефоне.
Разверните Element Web как статический сайт, укажите в качестве сервера ваш домашний сервер Matrix, добавьте HTTPS и настройте Nginx для обслуживания обновлений без устаревших файлов.
Настройте Conduit на 64-битном Raspberry Pi 4 с сохранением данных, федерацией HTTPS, защищенной регистрацией и проверкой работоспособности домашнего сервера.