マトリックスルームの管理者権限エラーをアクションで解決する

Element にエラーが表示された場合はM_FORBIDDEN: You do not have permission、まず失敗した操作を正確に特定してください。ルーム管理の失敗のほとんどは、アカウントのルーム権限レベルまたはメンバーシップが原因です。Synapse Admin API の失敗は、ホームサーバーの server-admin アカウントが必要です。現在のルーム管理者に必要なルーム権限のみを付与してもらうか、拒否された操作が本当に server-admin タスクである場合にのみ Synapse Admin API を使用してください。

架空の例:アレックスはMatrixルームのモデレーターを務めており、スパムを削除できますが、M_FORBIDDEN招待できるユーザーを変更しようとするとエラーが発生します。アレックスはそのルームのモデレーターであり、ルーム管理者ではありません。この例は説明のためのものであり、テスト済みのアカウントやサーバーに関する主張ではありません。

どの権限システムがリクエストを拒否したかを特定します。

Matrix は、M_FORBIDDEN一般的なアクセス禁止エラーとしてこのエラーを使用します。このコードだけでは、問題がルームの電力レベル、ルームメンバーシップ、アカウント制限、または管理 API の認証のいずれに起因しているかはわかりません。エラーメッセージ全体を読み、Alex が何をしていたか(ルーム設定の編集、誰かの招待または禁止、ルームへの参加、または Synapse 管理ツールの起動など)を確認してください。

ルームの権限は、そのm.room.power_levels状態イベントに保存されます。デフォルト、モデレーター、管理者などの要素ロールは、これらの値を確認するためのユーザー向けの方法ですが、ルームはカスタムレベルを設定できます。ホームサーバーのサーバー管理者は別のロールであり、そのユーザーを自動的にルーム管理者にするわけではありません。対処法:ロールを変更する前に失敗したアクションを分類し、エラーが要素のルーム設定またはエンドポイントから発生したかどうかを確認します/_synapse/admin/。

部屋のパワーレベルに合わせて部屋のアクションを修正する

AlexがElementで設定を変更できない場合は、既存のルーム管理者にルームの役割と権限を確認してもらってください。Element Webまたはデスクトップで、ルームを開き、「ルーム情報」またはルームメニューを開き、「ルーム設定」を選択して、「役割と権限」に移動します。「特権ユーザー」の下にあるAlexのエントリと、特定のアクションに必要な役割を確認してください。ラベルとレイアウトはクライアントのバージョンによって異なる場合があります。

アレックスの招待権限タスクに関して、管理者はアレックス自身の権限レベルと、その権限を変更するために必要なレベルの両方を確認する必要があります。マトリックス仕様では、これらは別々に定義されています。しきい値はinvite招待を制御し、権限レベルイベント自体を変更するには、その状態イベントを送信する権限が必要です。メンバーはユーザーを招待する権限を持っていても、招待しきい値を変更する権限がない場合があります。現在の管理者は、アレックスを適切な最低レベルに昇格させるか、あるいは自身で特定の権限変更を行うことができます。

Elementのドキュメントに記載されているデフォルト設定では、通常、管理者はレベル100、モデレーターはレベル50ですが、ルームで要件をカスタマイズできます。すべてのルームがこれらのデフォルト設定を使用しているとは限りません。また、唯一の管理者を降格させることは避けてください。Elementは、降格させるとルームを管理できる人がいなくなる可能性があると警告しています。対処法:ロールの変更を保存する前に、現在の管理者に、信頼できる別の管理者が残っていることを確認してもらってください。

チーム内でルームを管理できるユーザーがいない場合は、現在のルーム管理者が別のアカウントまたはデバイスで利用可能かどうかを確認してください。Synapse でホストされているルームの場合、ホームサーバーの管理者は Synapse の Make Room Admin API を使用して、ルーム内のローカルユーザーに利用可能な最高権限を付与できる場合があります。これはホームサーバー管理者向けの復旧手段であり、通常のクライアント側の権限バイパスではありません。このエンドポイントにはサーバー管理者の認証情報が必要であり、他の場所でホストされているルームには適用されない場合があります。最新の Synapse エンドポイントのドキュメントを参照し、Admin API は一般公開されないようにしてください。

エラーがSynapse Admin APIから発生した場合

リクエストが失敗した場合/_synapse/admin/...、Element のルーム Admin では不十分です。Synapse では、多くの Admin API 呼び出しでサーバー管理者の有効なアクセス トークンが必要です。トークンが意図したアカウントに属し、失効または入力ミスがなく、ドキュメントに記載されている認証ヘッダーを使用して送信されていることを確認してください。アクセス トークンを公開の問題、ブラウザのスクリーンショット、または共有ログに貼り付けないでください。パスワードと同様に扱ってください。

Synapseは、リバースプロキシを使用してAdmin APIを一般公開から隠蔽し、通常はSynapseを実行しているマシンからリクエストを行うことを推奨しています。管理者は、インストールされているSynapseのバージョンに合ったAPIを使用する必要があります。最初の対応として、データベースを直接編集してユーザーを昇格させることは避けてください。Synapseの現在のガイダンスでは、サーバー管理者アカウントを取得した後は、管理者コマンドとAPIを使用するようにオペレーターに指示しています。

メンバーシップ、アカウントの状態、および結果を確認してください

失敗した操作が参加またはイベント送信だった場合は、Alexが実際にルームに参加していて、BANされていないことを確認してください。招待されることと参加することは同じではありません。アカウントの権限レベルが高くても、メンバーシップルールによってアクセスがブロックされる場合があります。エラーが関連性のない複数のルームやログイン中に発生する場合は、ルーム管理者の問題ではない可能性があります。エラー応答全体を確認し、アカウントがロック、停止、またはホームサーバーによって何らかの制限を受けていないかを確認してください。

適切な管理者が権限を変更した後、アレックスに同じルームで同じ操作を再試行させてください。招待や設定変更が成功するなど、期待される結果を確認し、ルームの「役割と権限」ビューで目的のレベルが設定されていることを確認してください。それでも失敗する場合は、ホームサーバー管理者向けに、正確な操作、ルームID、タイムスタンプ、HTTPステータス、および編集済みのエラーテキストを記録してください。アクセストークンは含めないでください。

標準エラーコードとルーム電力レベルルールの意味については、Matrix Client-Server API仕様を参照してください。ルーム設定のワークフローについては、Elementのヘルプおよびサポートページを参照してください。サーバー管理者認証とルーム復旧操作については、 Synapse Admin APIドキュメントを参照してください。メッセージの内容と操作方法は、クライアント、ホームサーバー、ルームバージョン、およびカスタマイズされた電力レベルによって異なります。

コメントを残す

マトリックスルームの管理者権限エラーをアクションで解決する

M_FORBIDDEN の原因をルームの電力レベル、メンバーシップ、または Synapse サーバー管理者アクセスに特定し、ブロックされたアクションに必要な権限のみを復元します。

フェデレーションのためにMatrix Synapseサーバーにアクセス可能にする

フェデレーションのためにMatrix Synapseサーバーにアクセス可能にする

他のMatrixホームサーバーがあなたのサーバーを見つけて接続できるように、Synapseの検出、HTTPS、およびプロキシルーティングを設定してください。

Synapse OIDCを介してElement WebをKeycloakに接続します。

Keycloak OIDCクライアントとSynapseプロバイダーを設定することで、Element Webユーザーがクライアントシークレットを公開することなく、IDサーバー経由でサインインできるようになります。

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

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

復旧キーを保存し、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に組み込まれているスライディング同期を設定してください。クライアント検出機能をチェックした後、互換性のあるスマートフォンでルームリストの読み込みと再接続の動作を測定します。