Synapse Federation TLS証明書のエラーを解決する

Matrix Synapse のログにSSL: CERTIFICATE_VERIFY_FAILEDフェデレーション中にエラーが表示された場合、参加処理が停止したり、リモート サーバーが接続を拒否したり、メッセージが届かない場合があります。まず、どの証明書に問題があるかを特定してください。送信リクエスト中にリモート サーバーの証明書に問題があるのか​​、別のサーバーが接続した際にフェデレーション エンドポイント自身の証明書に問題があるのか​​を確認してください。次に、ログとフェデレーション テストで特定された証明書チェーン、ホスト名、または信頼構成を修復してください。一般的な解決策として TLS 検証を無効にしないでください。

Matrixのサーバー間通信はHTTPSを使用し、Matrixの仕様では、宛先側が認証局によって署名されたTLS証明書を提示することが求められています。検証エラーが発生する場合、通常は提示された証明書の有効期限が切れている、不完全である、別のホスト名に対して発行されている、または接続サーバーが信頼していない認証局によって署名されていることを意味します。Synapseの設定が正しく見える場合でも、リバースプロキシが誤った証明書を提供する可能性があります。

1. 設定を変更する前に、障害が発生している側を特定する。

障害発生時のSynapseログエントリを確認し、リモートサーバー名と正確な証明書エラーをメモしてください。Synapseが別のホームサーバーへのリクエスト中に障害を報告した場合、リモートサーバーの証明書、またはSynapseプロセスで使用されているCAトラストに問題がある可能性があります。他のサーバーがドメインとフェデレーションできない場合は、代わりにパブリックTLSエンドポイントとサーバー検出を確認してください。

homeserver.yaml特に、Matrixサーバー名を確認してくださいserver_name。これはローカルMatrix IDのドメイン部分であり、他のホームサーバーがあなたにアクセスする方法を決定します。マシンまたはコンテナの内部ホスト名と混同しないでください。現在のSynapseインストールドキュメントでは、サーバー名はフェデレーションIDであると説明されており、インストール前に選択することを推奨しています。

2. 公開証明書とフェデレーションルートをテストする

Matrix サーバー名を指定してMatrix Federation Tester を使用してください。このツールはフェデレーションの検出と接続性をチェックし、外部からアクセス可能な証明書またはルーティングに問題があるかどうかを明らかにします。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 名と一致している必要があります。また、証明書が有効であること、およびエンドポイントが中間証明書を送信していることを確認してください。リバースプロキシを使用している場合は、パブリックプロキシ アドレスをテストしてください。プロキシが古い証明書または無関係な証明書を提供している場合、Synapse ホストに正しい証明書ファイルがあっても意味がありません。

3. Synapseが提供する証明書を修正する

テスターがサーバーの証明書の問題を報告した場合は、フェデレーションホスト名の証明書を更新または再発行し、パブリックTLSエンドポイントが完全な証明書チェーンを提供するように構成してください。Synapseの現在の構成マニュアルではtls_certificate_path、中間証明書を含むPEM証明書を指す必要があると規定されています。Certbotの場合は、fullchain.pemではなくを使用してくださいcert.pem。秘密鍵は別のtls_private_key_pathファイルに保管し、一般のアクセスから保護してください。

TLSがNginx、Caddy、またはその他のリバースプロキシで終了する場合は、そのプロキシの設定で証明書と証明書チェーンを更新し、インストール環境に適した方法でプロキシを再起動してください。この構成では、Synapse独自のTLS証明書パスがフェデレーションピアから見える証明書を制御しない場合があります。使用するリスナーとプロキシの設定については、Synapseリバースプロキシの公式ドキュメントを参照してください。

DNSとMatrixサーバーの検出も確認してください。フェデレーションでは、サーバー名を直接解決する場合と、/.well-known/matrix/server委任に従って別のホスト名とポートに解決する場合があります。証明書は、その検出ルートで到達するホスト名に対して有効である必要があります。古いDNSレコードや誤った委任は、ピアを無関係な証明書を提示するエンドポイントに誘導する可能性があります。

4. プライベートフェデレーションのアウトバウンド信頼を修復する

証明書の発行に失敗した証明書がプライベートネットワーク上のリモートホームサーバーに属している場合は、まずその証明書がプライベート認証局(CA)によって意図的に発行されたものであることを確認してください。可能であれば、そのCAをSynapseホストにインストールして維持してください。Synapseは、federation_custom_ca_listフェデレーションに使用するカスタムCA証明書も提供しています。このオプションはPEMファイルを想定しており、オペレーティングシステムが提供するCAリストを置き換えるため、プライベートCAを1つだけ無作為に追加するのではなく、デプロイメントに必要なすべての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 の隠しサービスや制御されたプライベート設定など、特定の狭いケースのために別途用意されており、公開証明書の修復の代替として使用されるものではありません。プライベートインフラストラクチャの場合、一般的には信頼できるプライベート CA を使用することをお勧めします。

5. 時間を確認し、再テストする

証明書の有効期限が切れていないにもかかわらず、証明書の日付が無効と表示される場合は、Synapse ホストおよびプロキシのシステムクロックと時刻同期を確認してください。クロックのずれが大きいと、有効な証明書が無効または期限切れと表示されることがあります。また、更新の自動化によって公開されているファイルが実際に更新されたことを確認してください。ディスク上の証明書の更新は、プロキシがそれを再読み込みすることを保証するものではありません。

修正後、フェデレーションテスターを再実行し、失敗した接続を再度実行してください。テスターが期待されるホスト名、有効な日付、および信頼できるチェーンを認識していることを確認し、Synapseログで証明書検証エラーのない新しいフェデレーション試行がないか確認してください。テスターが合格してもリモートサーバーの1つがまだ失敗する場合は、そのサーバー名、タイムスタンプ、および関連する匿名化されたログエントリを取得してください。そのサーバー自身の証明書または信頼環境に問題が残っている可能性があります。トラブルシューティング中は、秘密鍵、アクセストークン、またはユーザーメッセージの内容を共有しないでください。

コメントを残す

要素キーのバックアップとクロス署名を安全に設定する

要素キーのバックアップとクロス署名を安全に設定する

復旧キーを保存し、Elementセッションを確認し、暗号化されたメッセージキーがアカウントパスワードと混同することなく復元できることを確認してください。

クライアント同期中に発生するMatrix Synapseのメモリクラッシュを停止する

Synapseの同期中に発生するメモリ不足エラーを診断し、キャッシュを安全に調整し、リクエストのバックログを特定し、安定したメモリ使用状況を確認します。

Synapse Federation TLS証明書のエラーを解決する

トレースマトリックスのフェデレーション証明書の障害を正しいサーバーに追跡し、TLSチェーンまたはCA信頼を修復し、セキュリティチェックを無効にすることなく修正を検証します。

Synapse MatrixサーバーをCloudflareの背後に安全に配置する

Synapse MatrixサーバーをCloudflareの背後に安全に配置する

Route MatrixクライアントとCloudflareをHTTPS 443経由でフェデレーションすることで、Synapseの検出機能を維持し、APIトラフィックのキャッシュやメディアアップロードの中断を回避します。

PostgreSQLダンプを使用してMatrix Synapseを安全に復元する

pg_dumpを使用してSynapseをバックアップし、署名キーとメディアを保護し、古いワンタイムキーを再利用せずにクリーンなPostgreSQLデータベースに復元します。

MjölnirをDockerでMatrixルームモデレーションボットとして実行する

MjölnirをDockerでMatrixルームモデレーションボットとして実行する

Mjölnirを、専用のMatrixアカウント、暗号化された管理ルーム、Docker Compose、ポリシーリスト、および権限チェックとともにセットアップします。

モバイル読み込み速度を向上させるために、ネイティブマトリックススライディング同期を有効にする

モバイル読み込み速度を向上させるために、ネイティブマトリックススライディング同期を有効にする

廃止されたプロキシはスキップし、Synapseに組み込まれているスライディング同期を設定してください。クライアント検出機能をチェックした後、互換性のあるスマートフォンでルームリストの読み込みと再接続の動作を測定します。

カスタムホームサーバーを使用してNginx上でWebサイトをホストする

Element Webを静的サイトとしてデプロイし、Matrixホームサーバーに接続し、HTTPSを追加し、Nginxを設定して古いファイルなしで更新を配信します。

Raspberry Pi 4で軽量なMatrix Homeserverを実行する

64ビット版Raspberry Pi 4に、永続データ、HTTPSフェデレーション、保護された登録、および動作中のホームサーバーのチェック機能を備えたConduitをセットアップします。

独自のドメインにカスタムMatrixルームエイリアスを設定する

ElementまたはMatrix APIを使用して、権限、Synapse命名規則、およびフェデレーションのチェックを行いながら、ドメイン上の共有しやすいMatrixルームのアドレスを設定できます。