在本文中，我们来解释如何将ONLYOFFICE文档编辑器连接至Confluence工作空间。
关于 ONLYOFFICE 与 Confluence 集成
ONLYOFFICE 提供了将 ONLYOFFICE 文档集成至 Confluence 的官方连接器，可实现在其文档库中编辑办公文档的功能。您可在 Atlassian 市场中安装 ONLYOFFICE 连接器，或是从 GitHub 页面上进行下载。本应用程序基于 Apache 许可进行分发。
如需了解其工作原理以及如何对 ONLYOFFICE - Confluence 连接器进行编译，请查阅我们的 API 文档。
主要功能
- 使用新建文档选项创建文本文档、电子表格以及演示文稿。
- 创建并填写在线表单。
- 使用在 ONLYOFFICE 中编辑选项对文档进行编辑和查看。
- 实时文档共同编辑：两种共同编辑模式（“快速”和“严格”）、跟踪更改、评论以及内置聊天功能。
- 支持 JWT，可确保您的文档仅可由拥有适当权限的用户访问，从而确保流量安全性。
支持的格式
- 可创建、编辑以及查看：DOCX、PPTX、XLSX、DOCXF
- 可填写表单：OFORM
- 可转换为 Office Open XML：ODT、DOC、ODP、PPT、ODS、XLS
- 仅可查看：PDF
将 ONLYOFFICE 文档连接至 Confluence
系统要求
- ONLYOFFICE 文档（文档服务器）5.9.4 或更高版本
您需要一个可在 Confluence 与任意终端客户端中进行解析和连接的 ONLYOFFICE 文档实例。其必须要能够以 POST 方式直接连接 Confluence。
可参考官方文档页面以了解更多关于安装 ONLYOFFICE 文档的信息。
- Confluence 数据中心 6.13.1 - 7.15.0 或 Confluence 服务器 6.13.1 - 7.15.0
从 Atlassian 市场安装 ONLYOFFICE - Confluence 连接器
您可从官方 Atlassian 市场中下载最新版本的连接器。可按照以下步骤进行操作：
以管理员身份登录您的 Confluence 实例。
点击管理员下拉框并选择管理应用。此时将弹出管理应用页面。
点击页面左侧的查找新应用。
通过搜索方式找到 ONLYOFFICE - Confluence 连接器。搜索结果中将包含与您 Confluence 实例兼容的加载项版本。
点击安装以下载并安装应用程序。
为 Confluence 配置 ONLYOFFICE 连接器
前往 Confluence 管理 >> 管理应用 >> ONLYOFFICE - Confluence 连接器 >> 配置：
- 文档服务器 - 指定已安装 ONLYOFFICE 文档的 URL 地址（如：https://documentserver）。
- 密钥 - 指定用于签署数据的 JWT Secret。如需了解更多信息，可查看本文中的为 ONLYOFFICE 与 Confluence 集成启用 JWT 章节内容。
高级服务器设置：
- 文档编辑服务内部请求服务器地址 - 用于从文档编辑服务访问 Confluence 服务器的地址。
- 服务器内部请求文档编辑服务地址 - 用于从 Confluence 服务器访问文档编辑服务的地址。
为 ONLYOFFICE 与 Confluence 集成启用 JWT
如需保护文档免遭未经授权访问的侵扰，可使用 ONLYOFFICE 编辑器提供的 JSON Web Token（JWT）功能。这一 Token 在文档编辑器初始化时就已添加至配置中，并会在 ONLYOFFICE 文档服务内部进行命令交换时得到初始化。密钥用于签署 JSON Web Token 并在向 ONLYOFFICE 文档发送请求时验证 Token。
如需保护文档，您需要启用 Token 验证功能并在 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
- 在以下 3 个位置将
false修改为true以启用 Token 验证功能：
services.CoAuthoring.token.enable.browserservices.CoAuthoring.token.enable.request.inboxservices.CoAuthoring.token.enable.request.outbox
- 在以下 3 个部分使用您自己的密钥来进行替换。这里所涉及的密钥必须相同。
services.CoAuthoring.secret.inbox.stringservices.CoAuthoring.secret.outbox.stringservices.CoAuthoring.secret.session.string
{
"services": {
"CoAuthoring": {
"token": {
"enable": {
"request": {
"inbox": true,
"outbox": true
},
"browser": true
}
},
"secret": {
"inbox": {
"string": "yoursecret"
},
"outbox": {
"string": "yoursecret"
},
"session": {
"string": "yoursecret"
}
}
}
}
}
- 保存更改。
- 重启服务以使配置更改生效：
supervisorctl restart all
第 2 步：在连接器设置中声明相同的密钥
在连接器设置的密钥字段声明相同的密钥并保存设置。
连接演示版 ONLYOFFICE 文档
如果您想在不安装 ONLYOFFICE 文档的情况下于 Confluence 内部对 ONLYOFFICE 在线编辑器进行测试，可前往 Confluence 管理 >> 管理应用 >> ONLYOFFICE - Confluence 连接器 >> 配置，勾选连接至演示版 ONLYOFFICE 文档服务器并点击保存按钮。
这是一个可在 30 天内进行使用的公开测试服务器。请勿在此处分享您的敏感数据。
开始在 Confluence 内部使用 ONLYOFFICE 文档
如需创建文件：
- 打开需要创建文件的页面。
- 点击新建文档按钮。
- 选择所需的文件类型。
- 在文件类型图标旁的文本字段中输入文件名称。
- 点击保存按钮。
文档将在 ONLYOFFICE 文档编辑器中打开。
如需编辑或查看文档：
- 找到需要进行操作的文件。
- 点击在 ONLYOFFICE 中编辑按钮。
文档将在 ONLYOFFICE 编辑器中打开。如需对文档进行共同编辑，已授权用户应同时打开相同的文件。
如需创建表单：
- 打开需要创建文件的页面。
- 点击新建文档按钮并选择表单选项。
- 在文件类型图标旁的文本字段中输入文件名称。
- 选择要附加至此页或其他页面的 .docx 文件，或选择从头创建选项。
- 表单将在 ONLYOFFICE 文档编辑器中打开。
- 将表单保存为 .docxf 以获取对其进行进一步编辑、修改或协作的权限。
如需创建可填写表单或限制其他用户的文件编辑权限：
- 前往附件。
- 点击位于 .docxf 文件右侧的使用 ONLYOFFICE 创建表单链接。这将在附件部分创建 .oform 文件。
如需填写表单：
- 前往附件。
- 点击位于 .oform 文件右侧的在 ONLYOFFICE 中填写链接。
- 表单将在 ONLYOFFICE 文档编辑器中打开。
