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