Collabora CODEにおけるWOPIを介したブロックファイルのエクスポート

Collabora Online CODE で開いているドキュメントをユーザーがエクスポートできないようにするには、WOPI ホストが"DisableExport": trueそのドキュメントのCheckFileInfo応答で を返すようにします。Collabora の統合ドキュメントでは、これはエクスポート機能を無効にすると説明されています。設定すると、[ダウンロード] メニューオプションも非表示になります。HideExportOptionだけではインターフェイスが変更されるだけなので、エクスポートを禁止することが目的の場合は適切な制御ではありません。Collabora の拡張 CheckFileInfo 応答プロパティを参照してください。

メニューのみの設定ではなく、WOPI権限を使用してください。

CODEはWOPI統合における編集コンポーネントです。ストレージサービスまたはアプリケーションサービスがWOPIホストとして機能し、Collaboraがドキュメントを開く際にファイルごとの情報を提供します。そのため、特定のユーザーが特定のファイルをエクスポートできるかどうかを判断するのに、ホストは最適な場所となります。

ホストのCheckFileInfoエンドポイントから返される JSON オブジェクトに、ブール型のプロパティを含めます。

{
  "BaseFileName": "quarterly-plan.docx",
  "Size": 24576,
  "UserCanWrite": true,
  "DisableExport": true
}

これは例示のための抜粋であり、CheckFileInfo の完全な応答ではありません。その他の必須フィールドと、ホストが既に返している既存の統合プロパティはそのまま使用してください。キーの値はテキスト文字列ではなく、JSON ブール値である必要があります"true"。ファイルと現在のユーザーに対してアプリケーションが使用するのと同じ認証決定を使用して設定してください。

例えば、組織によっては、機密性の高い予算ワークブックの編集は許可するものの、Collaboraのエクスポート機能は使用できないように設定している場合があります。WOPIホストがスタッフのためにそのワークブックを開くと、 が返されますDisableExport: true。公開テンプレートや通常のドキュメントの場合、ホストはfalseポリシーに応じて を返すことができます。すべてのドキュメントに同じ制限を適用することが適切なのは、すべてのユーザーとドキュメントに同じ制限を適用する必要がある場合のみです。

ファイルを提供するWOPIホストを更新します

1. 統合エンドポイントを特定します。CollaboraからのWOPIリクエストに応答するホストルートを見つけますCheckFileInfo。Nextcloud、ownCloud、またはその他のストレージ製品では、通常、これは応答を生成する統合レイヤーまたはポリシーレイヤーを変更することを意味します。Collaboraコンテナのグローバル設定を編集しても、ホストのファイルごとのアクセス許可の代わりにはなりません。
2. ルールは適切な範囲で適用してください。認証済みユーザー、ファイル分類、共有権限、またはアプリケーション内の別のルールから値を取得します。すべてのユーザーを対象とするシンプルなポリシーの場合は、関連するすべてのドキュメントに対して true を返します。ブラウザ側のメニュー設定やクライアントから提供される値に依存しないようにしてください。
3. CheckFileInfo にブール値を返します。レスポンスが有効な JSON であり、Collabora が受信するレスポンスにプロパティが含まれていることを確認してください。コードレベルのポリシー変更には、フレームワークによっては WOPI ホストアプリケーションのデプロイまたは再起動が必要になる場合があります。ホストがフィールドを動的に提供する場合、CODE 自体の設定変更は不要です。
4. ドキュメントを再度開いてください。現在のエディターセッションを閉じ、影響を受けたアカウントでファイルを再度開いてください。CheckFileInfoはドキュメントを開く処理の一部として参照されるため、既に開いているセッションでは権限の変更が反映されない場合があります。

具体的なファイル、クラス、設定、または管理インターフェースは、WOPIホストと製品バージョンによって異なります。Collaboraのドキュメントではこのフィールドを定義していますが、Nextcloudやサードパーティ製アプリケーションに共通する設定は規定していません。ホストがダウンロード制限を公開していない場合は、その製品の最新の管理ドキュメントを確認するか、サポートされているWOPI応答パスでポリシーを実装してください。

HideExportOption はどのような場合に設定すべきですか？

エクスポート禁止を適用せずに「ダウンロード」コントロールを非表示にしたい場合は、HideExportOptionに設定してください。実際の制限には を推奨します。Collabora の統合ガイドによると、これはメニュー非表示の動作も意味します。両方のフィールドを true に返すと、統合における意図が明確になりますが、ドキュメントに記載されている動作には必要ないはずです。trueDisableExport: true

extra_export_formatsこれを のエントリと混同しないでくださいcoolwsd.xml。Collabora の現在の構成テンプレートには、これらのオプション形式を無効にしても、表示が非表示になるだけで、サーバー側のエクスポートは無効にならないと明記されています。これらのオプションは、どの追加形式が提供されるかを制御するものであり、ユーザーがドキュメントをエクスポートする権限があるかどうかを制御するものではありません。グローバル設定を変更する前に、現在のCollabora Online 構成テンプレートを確認してください。

この制限が保護するものと保護しないもの

DisableExportこの設定は、セッションにおける Collabora のエクスポート機能に適用されます。ユーザーがブラウザでファイルを編集する必要があるものの、エディタのエクスポート機能やダウンロード機能を使用しない場合に便利です。この設定自体によって、ストレージ サービス内の元のファイルへのユーザーのアクセス権が削除されるわけではありません。ホストが引き続きそのユーザーにソース ファイルを別の場所からダウンロードすることを許可している場合、Collabora の設定によってその経路が閉じられることはありません。

同様に、コンテンツを閲覧できるユーザーは、情報を手動でコピーしたり、スクリーンショットを撮ったり、ポリシーで許可されているその他のアプリケーション機能を使用したりできる可能性があります。この設定を、すべてのデータ漏洩を防止するもの、またはコンテンツのコピーが不可能であることを保証するものとして説明しないでください。オリジナルへのアクセスを制限するには、WOPI ホストおよびストレージ アプリケーションでもダウンロードおよび共有ルールを適用してください。ユーザーがコンテンツを一切閲覧できないようにする必要がある場合は、エクスポート フラグに頼るのではなく、ドキュメントへのアクセスを拒否してください。

インターフェース項目を非表示にすることと、操作を無効にすることには違いがあります。Collabora の設定テンプレートでは、オプションのエクスポート形式設定に関してこの違いを明確にしていますが、WOPI 応答フィールドは統合レベルの制限です。前者はメニューを簡素化するのに役立ちますが、後者は Collabora を介したエクスポートをブロックするための設定です。既存の統合で異なる動作が発生する場合は、特定のホスト製品が独自の「ダウンロード無効化」チェックボックスを両方のフィールドにマッピングしていると想定するのではなく、Collabora のリリースを確認し、実際の CheckFileInfo 応答を調べてください。

テストアカウントで制限事項を確認してください。

1. 制限ポリシーに合致する管理者以外のアカウントを使用し、新しいセッションでテストドキュメントを開いてください。
2. エディタの「ダウンロード」オプションが利用できなくなっていることを確認してください。まだ表示される場合は、このユーザーとファイルに対して生成された CheckFileInfo レスポンスを調べ、フィールドがブール値でありtrue、新しいレスポンスが返されていることを確認してください。
3. 通常のCollaboraインターフェースを通してエクスポート操作をテストしてください。ホストのポリシーがエディタの動作に反映されるはずです。メニュー項目が非表示になっているからといって、その制御が適用されていると結論付けないでください。
4. ストレージアプリケーションは個別に確認してください。テスト計画で許可されている場合のみ、独自のダウンロード経路を試してください。ダウンロードが成功すれば、Collaboraがエクスポートをブロックしている場合でも、ソースファイルへのアクセスポリシーではまだ許可されていることを意味します。
5. エクスポート権限を持つユーザーのドキュメントを開き、ホストがそのケースに対して意図した権限を返すことを確認してください。これにより、誤ってグローバルに適用されたルールを検出できます。

実装の詳細については、CollaboraのWOPI統合リファレンスとプロジェクト構成テンプレートを参照してください。CODEのサポートされる動作はリリースやホスト統合によって異なる場合があるため、デプロイするバージョンで応答と結果を検証してください。特定のホストバージョンやサンプルデプロイメントがテスト済みであるという保証はありません。