本文由AI翻译

Redmine

关于 ONLYOFFICE 和 Redmine 的集成

ONLYOFFICE 提供了一个官方连接器，可以将 ONLYOFFICE 文档 与 Redmine 集成，以便在以下 Redmine 模块中协作处理附加的办公文档：问题、文件、文档、Wiki、新闻和论坛。您可以从 Redmine 市场或 ONLYOFFICE 的GitHub 页面下载 ONLYOFFICE 连接器。该应用程序以 Apache 许可证分发。

要了解有关 ONLYOFFICE Redmine 连接器如何工作的更多信息，请访问我们的API 文档。

主要功能

根据用户访问权限，从 Redmine 模块查看和编辑文本文档、电子表格和演示文稿。
创建和填写在线表单。
实时协同编辑文档：两种协同编辑模式（快速和严格）、修订模式、评论和内置聊天。
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 中的新功能

功能

填充 PDF 而不是 oform。

修复

修复了手动版本依赖性检查。

完整的更改日志可在此处查看。

将 ONLYOFFICE 文档连接到 Redmine

要求

ONLYOFFICE 文档服务器 v7.1（服务器或云版本）或更高版本
您需要一个 ONLYOFFICE 文档 实例，该实例可以从 Redmine 和任何终端客户端解析和连接。它必须能够直接向 Redmine 发送 POST 请求。

请参阅官方文档页面以了解有关安装 ONLYOFFICE 文档的更多信息。
Redmine：v4.0.0 - v5.0.x。如果您是 Redmine 新手，请按照这些说明进行安装。
Ruby：使用您的 Redmine 安装支持的 Ruby 版本（推荐：Ruby 2.7+ / 3.x）。
ONLYOFFICE Redmine 连接器 v3.1.0

安装 ONLYOFFICE Redmine 连接器

要安装插件，您需要 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 页面。

配置 ONLYOFFICE Redmine 连接器

进入管理面板 > 插件，找到 ONLYOFFICE Redmine 集成插件并点击配置。指定以下参数：

文档编辑服务地址 - 输入安装 ONLYOFFICE 文档 的 URL 地址和端口（例如 https://documentserver:8080）。此字段为必填项。
ONLYOFFICE 文档的地址必须能从 Redmine 访问，同时 Redmine 的地址也必须能从 ONLYOFFICE 文档访问。
如果您的网络配置不允许使用公共地址在安装的 Redmine 和 ONLYOFFICE 文档 之间请求，可以使用高级服务器设置部分。在相应字段中指定内部请求的地址：
- ONLYOFFICE 文档的内部请求地址 - 指定从 Redmine 访问文档编辑服务的地址。
- 从 ONLYOFFICE 文档的内部请求服务器地址 - 指定从文档编辑服务访问 Redmine 的地址。
密钥 - 指定用于签署数据的密钥。
从 ONLYOFFICE 文档 v7.2 开始，JWT 默认启用，并自动生成密钥。有关详细信息，请参阅本文的启用 ONLYOFFICE 和 Redmine 集成的 JWT部分。
禁用证书验证（不安全） - 勾选此框以禁用证书验证，并允许 Redmine 与 ONLYOFFICE 文档 建立连接，如果您使用的是自签名证书（否则，Redmine 将不验证自签名证书，也不允许与 ONLYOFFICE 文档 的连接）。这是一个不安全的解决方案，我们强烈建议您将证书替换为由某个 CA 颁发的证书。
如有必要，请检查以下自定义设置：
- 显示聊天菜单按钮。
- 以更紧凑的方式显示标题。
- 显示反馈支持菜单按钮。
- 显示帮助菜单按钮。
- 显示单色工具栏标题。

点击底部的应用按钮以保存更改。

启用 ONLYOFFICE 和 Redmine 集成的 JWT

为了保护文档免受未经授权的访问，ONLYOFFICE 编辑器使用 JSON Web Token (JWT)。在初始化文档编辑器和内部 ONLYOFFICE 文档服务之间的命令交换时，令牌会被添加到配置中。密钥用于签署 JSON Web Token 并在请求到 ONLYOFFICE 文档时验证令牌。

从 ONLYOFFICE 文档 v7.2 开始，JWT 默认启用，并自动生成密钥。您需要在 ONLYOFFICE 文档配置文件中找到您的密钥，然后在连接器设置中指定相同的密钥。

步骤 1：在 ONLYOFFICE 文档配置文件中找到您的密钥

使用任何可用的文本编辑器打开 local.json 文件。
- 对于 Linux - /etc/onlyoffice/documentserver/local.json
- 对于 Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
- 对于 Docker – 使用 docker exec -it <containerID> bash 命令进入 ONLYOFFICE 文档 容器并打开 /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 值。这意味着令牌验证已启用。
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
自动生成的密钥在三个部分中指定。您可以用自己的密钥替换默认密钥。密钥在三个部分中必须相同。
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
如果您进行了更改，请保存并重启服务以使配置更改生效。
```
supervisorctl restart all
```