適切なファイルを復元してNextcloudの整合性警告を解消する

Nextcloudの「一部のファイルが整合性チェックに合格していません」という警告を解消するには、まず「管理設定」→「概要」→「無効なファイル一覧…」を開き、レポートに記載されているファイルのみを復元または削除してください。signature.jsonチェックを編集したり、抑制したりしないでください。整合性エラーは、更新の不完全さ、意図しないカスタマイズ、または調査が必要な予期しないファイルを示している可能性があります。

ファイルを変更する前にレポートを読んでください

警告は管理者の概要ページに表示されます。Nextcloudのコード署名に関するドキュメントには、そこで実行できる便利な操作が2つ記載されています。それは、無効なファイルの一覧を表示することと、再スキャンを実行することです。レポートでは、問題がコンポーネント（例：coreアプリケーション）ごとにグループ化され、エラーの種類とファイルパスが表示されます。最新のNextcloud 35管理者マニュアルにも、これらの操作とocc整合性コマンドが記載されています。

• INVALID_HASHファイルのハッシュ値が、署名に記録されている値と異なっています。ローカル編集、アップグレード中の不完全な置換、または予期せぬ変更が原因である可能性があります。
• MISSING_FILE署名付きファイルが存在しません。誤って削除されたか、アップデート中に削除されなかった可能性があります。
• EXTRA_FILEインストール環境内にファイルが存在するが、署名済みファイルセットに含まれていない。ローカルファイル、旧リリースからの残存ファイル、またはセキュリティレビューが必要なファイルである可能性がある。
• EXCEPTION検証ツールが署名を検証できませんでした。例えば、必要な署名データが欠落しているか無効である場合などが考えられます。指定されたアプリとそのソースを確認してください。

これらのラベルはチェック結果を示すものであり、原因を示すものではありません。余分なファイルがあるからといって必ずしも悪意のあるファイルとは限らず、ハッシュ値の不一致は侵害の証拠にはなりません。コンポーネント、パス、エラーを記録し、デプロイ方法や最近の変更点と比較してください。

対象を絞ったチェックを実行する

シェルアクセス権限がある場合は、occNextcloudのインストールディレクトリからWebサーバーのユーザーとして実行してください。適切なアカウントとPHPコマンドは、オペレーティングシステム、コンテナイメージ、Snap、またはホスティングプロバイダによって異なる場合があります。一般的なDebianまたはUbuntuのApacheインストール環境で、Nextcloudがにあり/var/www/nextcloud、Webユーザーがである場合www-dataは、以下を使用してください。

cd /var/www/nextcloud
sudo -E -u www-data php occ integrity:check-core
sudo -E -u www-data php occ integrity:check-app calendar

calendarレポートに表示されているアプリ識別子に置き換えてください。コアチェックは Nextcloud サーバーファイルを検証し、アプリチェックは指定された 1 つのアプリを検証します。Nextcloud 35 のマニュアルには、occ integrity:check-app --allインストール済みアプリのチェック方法も記載されています。チェックが成功しても出力がない場合があります-v。確認が必要な場合に使用してください。インストールがコンテナ化されている場合、またはパッケージによって管理されている場合は、occこれらのパスを無条件にコピーするのではなく、ドキュメントに記載されている方法で呼び出し、実際の Web ユーザーを使用してください。

信頼できるソースからファイルを復元する

コアファイル用

INVALID_HASHまたはMISSING_FILEそれ以下のバージョンについてはcore、現在インストールされているNextcloudのリリースを正確に使用してください。公式ダウンロードソースからクリーンなアーカイブを入手するか、既知の正常なバックアップまたはデプロイメントアーティファクトから一致するファイルを復元してください。ファイルを置き換える前に、インストールされているバージョンを比較し、サイト固有の設定とデータディレクトリを保持してください。アップグレードの中断後に複数のコアファイルが失敗した場合は、個々のファイルをランダムに置き換えるのではなく、デプロイメントを修復するか、そのインストールタイプでサポートされているアップグレードプロセスを再実行してください。

の場合EXTRA_FILE、パスを調べて作成者を特定してください。インストールに含まれていないローカルファイルがNextcloudコードディレクトリの外にある場合は、そのファイルを移動してください。必要なカスタム作業が含まれている可能性がある場合は、まずコピーを保存してください。見慣れないファイルや疑わしいファイルの場合は、調査のために保存し、削除する前にアクセスログとデプロイ履歴を確認してください。警告を消すためだけに、任意のファイルを削除しないでください。

アプリファイル用

署名済みのアプリで、ファイルが変更されているか、ファイルが欠落している場合は、公式の Nextcloud アプリ ストアまたはアプリ メンテナーの信頼できるリリース チャネルから、同じ互換性のあるアプリ バージョンを再インストールしてください。ローカルでの変更が含まれている場合は、まずアプリ ディレクトリをバックアップしてください。カスタム アプリまたは署名されていないアプリの場合は、整合性メッセージに署名ステータスまたは実装が反映される可能性があります。署名データを作成するのではなく、開発者に確認してください。Nextcloud のドキュメントには、アプリの を変更しないように記載されていますsignature.json。コアとアプリのコード署名は、変更や不完全なアップグレードを検出する方法を提供するため、記録されたハッシュを変更すると、その目的が損なわれます。

Nextcloudは、FTPを使用して置換ファイルを転送する場合、バイナリ転送モードを使用することを推奨しています。テキストモードで変換すると、バイト列が変更され、新たなハッシュ値の不一致が発生する可能性があります。

再スキャンして結果を確認してください

1. 一致するコアまたはアプリの整合性コマンドを再度実行するか、管理設定 → 概要に戻って「再スキャン…」を選択します。
2. 影響を受けたコンポーネントが無効ファイルリストに表示されなくなったことを確認してください。CLIを使用した場合、アプリチェックが合格すれば出力は表示されず、詳細チェックを実行すると結果が確認できます。
3. 概要ページを再読み込みし、警告が消えていることを確認してください。警告が残っている場合は、更新されたレポートを開いてください。別のファイルまたは別のコンポーネントが特定されている可能性があります。

同じエラーがすぐに再発する場合は、デプロイプロセス、カスタマイズ、またはマウントされたボリュームによって変更されたファイルが復元されていないか調査してください。署名例外については、アプリのサポート対象リリースを確認し、メンテナーに問い合わせてください。レポートで説明のつかないコアファイルが特定された場合は、セキュリティとデプロイの問題として扱い、先に進む前に信頼できるバックアップとサーバーログを確認してください。

Nextcloudの公式コード署名および整合性に関するドキュメント、Nextcloud 35の整合性コマンドリファレンス、および公式のNextcloudサーバーリリースアーカイブを参照してください。