ファイルライブラリでの Office オンライン編集（ONLYOFFICE Docs 連携）

ファイルライブラリの Office オンライン編集（ONLYOFFICE Docs）のネットワーク接続方向と利用条件を説明します。お客様のネットワーク管理者がファイアウォールとドメインの許可リストを計画するための情報です。現在は SaaS のみで提供しています。

ファイルライブラリ内の Office ファイル（.docx、.xlsx、.pptx）は、ブラウザ内でオンライン編集できます。エディタは MaiAgent が運用する ONLYOFFICE Document Server（以下「ドキュメントサーバー」）が提供します。ユーザーがエディタを閉じると、編集結果が新しいバージョンとしてファイルライブラリに保存されます。

このページは、お客様のネットワーク管理者と情報セキュリティ担当者向けです。ユーザーのブラウザに必要な接続先、各コンポーネント間のドキュメントの流れ、利用条件を説明します。編集操作については、ユーザーマニュアルのファイルライブラリ：オンライン編集をご覧ください。現在、この機能は SaaS のみで提供しています。オンプレミス版についてはページ末尾の説明をご覧ください。

サービスの構成要素

コンポーネント	役割
ドキュメントサーバー（ONLYOFFICE Document Server）	ブラウザ内のエディタと共同編集機能を提供し、編集終了後に完成したファイルの取得を MaiAgent に通知します
MaiAgent プラットフォーム	編集セッションを発行し、保存通知を受信して、編集結果をファイルの新しいバージョンとして書き込みます
オブジェクトストレージ	ファイルライブラリの元のファイルと各バージョンを保存します

接続方向

ユーザー側で許可が必要な接続

接続元 → 接続先	用途
ユーザーのブラウザ → MaiAgent 管理画面のドメイン（HTTPS）	ファイルライブラリを開き、編集セッションを取得します
ユーザーのブラウザ → ドキュメントサーバーのドメイン（HTTPS）	エディタを読み込み、編集中にドキュメントサーバーと通信します

エディタは MaiAgent 管理画面のドメインではなく、ドキュメントサーバー自身のドメインから読み込まれます。社内ネットワークでドメインの許可リスト、プロキシサーバー、SSL 検査を使用している場合は、ドキュメントサーバーのドメインも許可してください。ドメインについては MaiAgent の担当者にお問い合わせください。

プラットフォーム内部の接続

以下の接続はすべて MaiAgent が運用する環境内で行われるため、お客様による設定は不要です。セキュリティ評価でドキュメントの流れを確認できるように記載しています。

接続元 → 接続先	用途
ドキュメントサーバー → オブジェクトストレージ	ドキュメントを開く際に、有効期間の短いダウンロード URL で元のファイルを読み込みます
ドキュメントサーバー → MaiAgent プラットフォーム	編集終了時に保存を通知します
MaiAgent プラットフォーム → ドキュメントサーバー	ヘルスチェック、編集後のファイル取得、ユーザーがエディタを閉じた後の保存要求を行います

プラットフォームとドキュメントサーバー間の編集設定と保存通知は、共有シークレットによる署名で認証します。

利用条件

• 組織でファイルライブラリとオンライン編集を有効にする必要があります。有効でない場合、ファイルメニューに編集項目は表示されません。

• メンバーには、そのスペースの編集権限が必要です。

• 対応形式は .docx、.xlsx、.pptx のみで、1 ファイルあたり 10 MB 以内です。旧形式（.doc、.xls、.ppt）のオンライン編集には対応していません。

• アクセス制御を維持するため、エディタ内のダウンロードと印刷は無効にしています。ファイルはファイルライブラリからダウンロードしてください。

• 編集中の自動保存ではバージョンは作成されません。全員がエディタを閉じた後に、内容が新しいバージョンとして保存されます。

サービスが利用できない場合

プラットフォームは編集項目を表示する前に、ドキュメントサーバーが正常に動作しているか確認します（確認結果は約 30 秒間保持されます）。確認に失敗すると Office の編集項目が無効になり、直接エディタを開いた場合は、サービスが一時的に利用できないため新しいバージョンをアップロードするよう案内されます。ドキュメントサーバーが復旧すると、約 30 秒以内に編集項目が自動で復旧します。

代替方法

編集サービスが利用できない場合やファイルがサイズ上限を超える場合は、パソコン上で編集し、ファイルライブラリの 新しいバージョンをアップロード からアップロードできます。この方法はドキュメントサーバーに依存しません。

保存に失敗すると、ファイル名の横に 保存に失敗しました。クリックして再試行 と表示され、関係するメンバーにもアプリ内のお知らせが届きます。クリックすると保存を再試行できます。

オンプレミス版

Office オンライン編集は現在 SaaS のみで提供しています。オンプレミス版への対応時期については MaiAgent の担当者にお問い合わせください。