この記事はAIによって翻訳されました

Redmine

ONLYOFFICEとRedmineの統合について

ONLYOFFICEは、ONLYOFFICE DocsをRedmineと統合する公式コネクタを提供しています。これにより、Redmineの以下のモジュールに添付されたオフィス文書を共同編集できます：課題、ファイル、文書、Wiki、ニュース、フォーラム。ONLYOFFICEコネクタはRedmineマーケットプレイスまたはONLYOFFICEのGitHubページからダウンロードできます。このアプリケーションはApacheライセンスの下で配布されています。

ONLYOFFICEコネクタ for Redmineの動作について詳しく知りたい場合は、APIドキュメントをご覧ください。

主な機能

ユーザーのアクセス権に応じて、Redmineモジュールからテキスト文書、スプレッドシート、プレゼンテーションを閲覧および編集。
オンラインフォームの作成と記入。
リアルタイムでの文書共同編集：2つの共同編集モード（高速モードと厳密モード）、変更履歴モード、コメント、内蔵チャット。
JWTサポートにより、適切な権限を持つユーザー以外が文書にアクセスできないようにトラフィックを保護。
ユーザーの言語設定を考慮したテンプレートを使用して新しい添付ファイルを作成。

サポートされている形式

作成用：DOCX、DOCXF、XLSX、PPTX
編集用：DOCM、DOCX、DOCXF、DOTM、DOTX、*EPUB、*FB2、*HTML、*ODT、*OTT、PDF、*RTF、*TXT、*CSV、*ODS、*OTS、XLSM、XLSX、XLTM、XLTX、*ODP、*OTP、POTM、POTX、PPSM、PPSX、PPTM、PPTX
閲覧用：DJVU、DOC、DOCM、DOCX、DOCXF、DOT、DOTM、DOTX、*EPUB、*FB2、FODT、HTM、*HTML、MHT、MHTML、*ODT、OFORM、*OTT、OXPS、PDF、*RTF、STW、SXW、*TXT、WPS、WPT、XML、XPS、*CSV、ET、ETT、FODS、*ODS、*OTS、SXC、XLS、XLSB、XLSM、XLSX、XLT、XLTM、XLTX、DPS、DPT、FODP、*ODP、*OTP、POT、POTM、POTX、PPS、PPSM、PPSX、PPT、PPTM、PPTX、SXI

* 編集用に形式を開くには、形式設定で確認してください。一部の形式制限により、データ損失が発生する可能性があります。

バージョン3.1.0の新機能

機能

oformの代わりにPDFを記入。

修正

手動バージョン依存性チェックを修正。

完全な変更履歴はこちらで確認できます。

ONLYOFFICE DocsをRedmineに接続する

要件

ONLYOFFICE Document Server v7.1（サーバーまたはクラウドバージョン）以降
ONLYOFFICE Docsのインスタンスが、Redmineおよびすべてのエンドクライアントから解決可能で接続可能である必要があります。Redmineに直接POSTできる必要があります。

ONLYOFFICE Docsのインストールについて詳しくは、公式ドキュメントページをご覧ください。
Redmine： v4.0.0 - v5.0.x。Redmineを初めて使用する場合は、これらの手順に従ってインストールしてください。
Ruby： RedmineインストールでサポートされているRubyバージョンを使用（推奨：Ruby 2.7+ / 3.x）。
Redmine用ONLYOFFICE Connector v3.1.0

Redmine用ONLYOFFICEコネクタのインストール

プラグインをインストールするには、Redmine v. 4.2以上、またはRedmine v. 5.0以上が必要です。プラグインはRuby v. 2.7.2以上、またはRuby v. 3.0.0以上と互換性があります。

Redmine v. 5.0とRuby v. 3.0.0の使用を推奨します。

また、プラグインを解凍するためにzstdが必要になる場合があります。

公式Redmineの手順に従ってRedmineをインストールします。

Redmineをインストールしたら、プラグインをダウンロードします。

curl --location https://github.com/ONLYOFFICE/onlyoffice-redmine/releases/latest/download/onlyoffice_redmine.tar.zst --output onlyoffice_redmine.tar.zst

ダウンロードしたプラグインをpluginsディレクトリに解凍します。
```
tar --extract --file onlyoffice_redmine.tar.zst --directory plugins
```
Redmineが自動的に行わなかった場合、プラグインの依存関係をインストールします。
```
bundle install
```

マイグレーションを実行します。

RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine

Redmineを再起動します。

プラグインのインストールについて詳しくは、Redmine Wikiページをご覧ください。

Redmine用ONLYOFFICEコネクタの設定

管理パネル > プラグインに移動し、Redmine用ONLYOFFICE統合プラグインを見つけて設定をクリックします。次のパラメータを指定します：

文書編集サービスのアドレス - ONLYOFFICE DocsがインストールされているURLアドレスとポートを入力します（例：https://documentserver:8080）。このフィールドは必須です。
ONLYOFFICE DocsのアドレスはRedmineからアクセス可能である必要があり、RedmineのアドレスもONLYOFFICE Docsからアクセス可能である必要があります。
ネットワーク構成がインストールされたRedmineとONLYOFFICE Docs間のリクエストをパブリックアドレスを使用して許可しない場合、高度なサーバー設定セクションを使用できます。この場合、内部リクエスト用のアドレスを対応するフィールドに指定します：
- サーバーからの内部リクエスト用ONLYOFFICE Docsのアドレス - Redmineから文書編集サービスにアクセスするために使用されるアドレスを指定します。
- ONLYOFFICE Docsからの内部リクエスト用サーバーアドレス - 文書編集サービスからRedmineにアクセスするために使用されるアドレスを指定します。
秘密鍵 - データを署名するために使用される秘密を指定します。
ONLYOFFICE Docs v7.2以降、JWTはデフォルトで有効になっており、秘密鍵は自動的に生成されます。詳細については、この記事のONLYOFFICEとRedmine統合のためのJWTの有効化セクションを参照してください。
証明書検証を無効にする（非推奨） - 自己署名証明書を使用している場合、証明書の検証を無効にしてRedmineがONLYOFFICE Docsとの接続を確立できるようにするためにこのボックスをチェックします（そうでない場合、Redmineは自己署名証明書を検証せず、ONLYOFFICE Docsとの接続を許可しません）。これは安全でない解決策であり、CAが発行した証明書に置き換えることを強くお勧めします。
必要に応じて次のカスタマイズ設定を確認します：
- チャットメニューボタンを表示。
- ヘッダーをよりコンパクトに表示。
- フィードバックサポートメニューボタンを表示。
- ヘルプメニューボタンを表示。
- モノクロームツールバーのヘッダーを表示。

変更を保存するには、下部の適用ボタンをクリックします。

ONLYOFFICEとRedmine統合のためのJWTの有効化

文書を不正アクセスから保護するために、ONLYOFFICEエディターはJSON Web Token（JWT）を使用します。トークンは文書エディターが初期化される際と、内部ONLYOFFICE Docsサービス間でのコマンド交換時に設定に追加されます。秘密鍵はJSON Web Tokenを署名し、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
```