Nuxeo

ONLYOFFICEとNuxeoの統合について

ONLYOFFICEは、ONLYOFFICE DocsをNuxeoと統合し、コンテンツ管理システム内でオフィス文書を編集するための公式コネクタを提供しています。公式のNuxeo MarketplaceからONLYOFFICEコネクタをインストールするか、GitHubページからダウンロードできます。このアプリケーションはApacheライセンスの下で配布されています。

注記

ONLYOFFICEコネクタをNuxeo用にコンパイルする方法について詳しくは、APIドキュメントをご覧ください。

主な機能

テキスト文書、スプレッドシート、プレゼンテーション、フォームの編集。
リアルタイムでの共同編集：2つの共同編集モード（高速モードと厳密モード）、変更履歴、コメント、組み込みチャット。
適切な権限を持つユーザー以外が文書にアクセスできないようにするためのJWTサポート。

サポートされている形式

編集用：DOCX、PPTX、XLSX、DOCXF（PDFとして保存）
フォーム記入用：DOCXF（PDFとして保存）
閲覧のみ：PDF、ODT、ODS、ODP、DOC、XLS、PPT、CSV、RTF

ONLYOFFICE DocsをNuxeoに接続する

要件

ONLYOFFICE Document Server v6.1（サーバーまたはクラウドバージョン）以降

ONLYOFFICE Docsのインスタンスが、Nuxeoおよびすべてのエンドクライアントから解決可能で接続可能である必要があります。Nuxeoに直接POSTできる必要があります。

注記
ONLYOFFICE Docsのインストールについて詳しくは、公式のドキュメントページをご覧ください。
Nuxeo LTS 2021
Nuxeo用ONLYOFFICEコネクタ

Nuxeo用ONLYOFFICEアドオンのインストール

インターネットアクセスのあるNuxeo Online Services登録インスタンス、未登録インスタンス、またはオフラインインスタンスにONLYOFFICEを接続できます。

注記

提供された手順はnuxeoctlスクリプトを使用しています。パッケージのインストール方法については、公式のNuxeoドキュメントページをご覧ください。

インターネットアクセスのあるNuxeo Online Services登録インスタンスの場合、次の手順に従ってください：

サーバーを停止する
```
./nuxeoctl stop
```
コネクタをインストールするために次のコマンドを実行する：
```
./nuxeo/bin/nuxeoctl mp-install onlyoffice-nuxeo-x.x.x
```
ここでonlyoffice-nuxeo-x-x-xは、Nuxeo用のONLYOFFICEコネクタの最新バージョンです。
注記
コネクタのバージョンを見つけるには：
1. Nuxeo Marketplaceにアクセスし、公式のONLYOFFICEコネクタを見つけます。
2. インストールボタンをクリックします。
3. インターネットアクセスのあるNuxeo Online Services登録インスタンスセクションでコネクタのバージョンを確認します。
パッケージがダウンロードされインストールされた後、サーバーを起動する
```
./nuxeoctl start
```

未登録インスタンスまたはオフラインインスタンスの場合、次の手順に従ってください：

サーバーを停止する
```
./nuxeoctl stop
```
コネクタをダウンロードする
```
wget https://connect.nuxeo.com/nuxeo/site/marketplace/package/onlyoffice-nuxeo/download?version=x.x.x
```
ここでversion=x.x.xは、Nuxeo用のONLYOFFICEコネクタの最新バージョンです。そうでない場合は、Nuxeo Marketplaceを訪れ、リンクを手動で見つけてください。
ダウンロードした.zipファイルのパスを指定してパッケージをインストールする
```
./nuxeoctl mp-install /Path/to/file/onlyoffice-nuxeo-x.x.x.zip
```
パッケージがダウンロードされインストールされた後、サーバーを起動する
```
./nuxeoctl start
```

Nuxeo用ONLYOFFICEアドオンの設定

任意のテキストエディタでnuxeo/bin/nuxeo.confファイルを開き、次の行を追加してください：

onlyoffice.docserv.url=http://documentserver/
onlyoffice.jwt.secret=yoursecret

ここでdocserv.urlはインストールされ稼働中のONLYOFFICE DocsインスタンスのURLであり、jwt.secretはONLYOFFICE Docsへのリクエスト時にJSON Webトークンを検証するためのシークレットです。

注記

ONLYOFFICE DocsのアドレスはNuxeoからアクセス可能である必要があり、NuxeoのアドレスもONLYOFFICE Docsからアクセス可能である必要があります。

注記

ONLYOFFICE Docs v7.2以降、JWTはデフォルトで有効化され、シークレットキーは自動的に生成されます。Nuxeo側でも有効化する必要があります：ONLYOFFICE Docs設定ファイルでシークレットキーを見つけ、コネクタ設定で同じシークレットキーを指定してください。詳細については、本記事のONLYOFFICEとNuxeoの統合用JWTの有効化セクションをご覧ください。

ONLYOFFICEとNuxeoの統合用JWTの有効化

文書を不正アクセスから保護するために、ONLYOFFICEエディターはJSON Webトークン（JWT）を使用します。トークンは、Document Editorが初期化される際や内部のONLYOFFICE Docsサービス間でのコマンド交換時に設定に追加されます。シークレットキーはJSON Webトークンを署名し、ONLYOFFICE Docsへのリクエスト時にトークンを検証するために使用されます。

ONLYOFFICE Docs v7.2以降、JWTはデフォルトで有効化され、シークレットキーは自動的に生成されます。ONLYOFFICE Docs設定ファイルでシークレットキーを見つけ、コネクタ設定で同じシークレットキーを指定する必要があります。

ステップ1：ONLYOFFICE Docs設定ファイルでシークレットキーを見つける

任意のテキストエディタでlocal.jsonファイルを開く。

Linuxの場合 - /etc/onlyoffice/documentserver/local.json
Windowsの場合 - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
Dockerの場合 - docker exec -it <containerID> bashコマンドを使用してONLYOFFICE Docsコンテナに入り、/etc/onlyoffice/documentserver/local.jsonを開く

または、local.jsonを開かずにデフォルトのシークレットキーを見つけるために次のコマンドを使用できます：
```
sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'
```

local.jsonファイルは次のようになります：

{
  "services": {
    "CoAuthoring": {
      "token": {
        "enable": {
          "request": {
            "inbox": true,
            "outbox": true
          },
          "browser": true
        }
      },
      "secret": {
        "inbox": {
          "string": "yoursecret"
        },
        "outbox": {
          "string": "yoursecret"
        },
        "session": {
          "string": "yoursecret"
        }
      }
    }
  }
}

trueの値は3つのセクションで指定されています。これはトークン検証が有効であることを意味します。
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
自動生成されたシークレットキーは3つのセクションで指定されています。デフォルトのシークレット値を独自のシークレットキーに置き換えることができます。シークレットキーは3つのセクションで同じである必要があります。
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
変更を加えた場合は、それを保存し、設定変更を反映させるためにサービスを再起動してください。
```
supervisorctl restart all
```

ステップ2：コネクタ設定で同じシークレットキーを指定する

nuxeo/bin/nuxeo.confファイルで、onlyoffice.jwt.secret=yoursecret文字列に同じシークレットを指定し、設定を保存してください。

Nuxeo内でONLYOFFICE Docsを使用開始する

文書またはフォームを編集または表示するには：

必要なファイルを開く。
ONLYOFFICEで表示ボタンをクリックする。

文書またはフォームが表示および編集のために開かれます。

ONLYOFFICE_viewfile

注記

文書を共同編集するには、ユーザーが文書を編集する権限を持っている必要があり、コネクタでサポートされている文書形式である必要があります。

注記

フォームについて詳しくは、作成および記入に関する記事をご覧ください。

文書を共同編集するには：

文書の概要ページを開く。
ONLYOFFICEで共同編集アイコンをウィンドウの右下隅でクリックする。

文書が共同編集のために開かれます。

ONLYOFFICEとNuxeoの統合について​

主な機能​

サポートされている形式​

ONLYOFFICE DocsをNuxeoに接続する​

要件​

Nuxeo用ONLYOFFICEアドオンのインストール​

Nuxeo用ONLYOFFICEアドオンの設定​

ONLYOFFICEとNuxeoの統合用JWTの有効化​

Nuxeo内でONLYOFFICE Docsを使用開始する​