More than 1 year has passed since last update.

ONLYOFFICE DocsとStrapiの連携方法について

Last updated at 2022-06-21Posted at 2022-06-21

ONLYOFFICEとStrapiの連携について

Strapiは、APIを構築するために使用されるオープンソースのコンテンツマネージャーシステムです。ONLYOFFICEでは、ONLYOFFICE DocsとStrapiを統合し、Strapiのメディアライブラリでオフィスドキュメントを編集するための公式コネクタを提供しています。ONLYOFFICE統合プラグインは、npmライブラリまたはGitHubページから入手できます。コネクターはApache-2.0ライセンスで配布されています。

主な機能

テキスト文書、スプレッドシート、スライドの編集と表示
リアルタイムでの共同編集：2つの共同編集モード（高速と厳格）、変更履歴モード、コメント、内蔵チャット
JWTのサポートにより、適切な権限を持つユーザーを除いて、誰もドキュメントにアクセスできないように、トラフィックが保護できる

サポートされるフォーマット

閲覧・編集用：docx, xlsx, pptx
閲覧のみ：doc, docx, docm, dot, dotx, dotm, odt, fodt, ott, rtf, txt, html, htm, mht, xml, pdf, djvu, fb2, epub, xps, xls, xlsx, xlsm, xlt, xltx, xltm, ods, fods, ots, csv, pps, ppsx, ppsm, ppt, pptx, pptm, pot, potx, potm, odp, fodp, otp

ONLYOFFICE DocsとStrapiの接続について

動作環境

ONLYOFFICE Docs（ドキュメントサーバ）v6.1.0以上

Strapiとエンドクライアントの両方から解決可能で接続可能なONLYOFFICE Docsのインスタンス、Strapiに直接POSTできる必要があります。

ONLYOFFICE Docsのインストールについては、
公式ドキュメントページをご参照ください。

Strapi v4.0.0以降
Strapi用ONLYOFFICEコネクタv1.0.3

Strapi用ONLYOFFICE連携プラグインのインストール

１．エディタでフレームを挿入し、api.jsを読み込めるようにするため、strapi/config/middlewares.jsファイルのstrapi::security行を以下の構成に置き換えます。

{
  name: "strapi::security",
  config: {
    contentSecurityPolicy: {
      useDefaults: true,
      directives: {
        "script-src": ["'self'", "https:", "http:"],
        "frame-src": ["'self'", "https:", "http:"],
      },
    },
  }
},

もしこのような設定がすでに存在するならば、ディレクティブを追加するだけです。

２．プラグインをあなたのStrapiプロジェクトにインストールします。

npm install onlyoffice-strapi --save

３．ONLYOFFICEプラグインを管理者UIに含めるために、Strapiを再構築して再起動します。以下の通り、実行してください。

# using yarn
yarn build
yarn develop      

# using npm
npm run build
npm run develop

これで、Strapi用ONLYOFFICE連携プラグインがインストールされ、設定できるようになりました。プラグインは左パネルのプラグインセクションから「ONLYOFFICE」という名前でアクセスできます。

StrapiのONLYOFFICE連携プラグインを設定する

StrapiにONLYOFFICE連携プラグインを設定するには：

左のパネルから設定セクションを開いてください。
グローバル設定セクションで、ONLYOFFICEメニュー項目をクリックします。
ONLYOFFICE設定ページで、ドキュメントサーバーアドレス、つまりインストールされたONLYOFFICE DocsのURLを入力します。

ONLYOFFICEとStrapiの連携でJWTを有効にする

JWTまたはJSON Web Tokenは、クライアントの認証を検証するために、HTTPリクエスト内でクライアントからサーバーに送信される文字列です。JWTはクライアントサイドにのみ保存されるため、当事者間の通信は保護され、デジタル署名されます。

トークンは、JWT（JSON Web Tokens）標準を使用して生成されます。トークンはサーバーの鍵で署名されているので、クライアントはトークンが正当なものであることを確認することができます。

ONLYOFFICE Docsはトークンを検証します。ペイロードのデータは有効であるとみなされ、メインパラメータの対応するデータの代わりに使用されます。トークンが無効な場合、コマンドは実行されません。詳しくは、APIセキュリティガイドをご覧ください。

JWTでドキュメントを保護するには：

左側のパネルから、「設定」セクションを開いてください。
「グローバル設定」セクションで、「ONLYOFFICE」メニュー項目をクリックします。
「ONLYOFFICE設定」ページで、「ドキュメントサーバーJWTシークレットキー」フィールドにシークレットキーを入力します。詳細については、こちらをご覧ください。