如何将 ONLYOFFICE 文档与 Confluence 进行连接_onlyoffice token

在本文中，我们来解释如何将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 市场中下载最新版本的连接器。可按照以下步骤进行操作：

1. 以管理员身份登录您的 Confluence 实例。

2. 点击管理员下拉框并选择管理应用。此时将弹出管理应用页面。

3. 点击页面左侧的查找新应用。

4. 通过搜索方式找到 ONLYOFFICE - Confluence 连接器。搜索结果中将包含与您 Confluence 实例兼容的加载项版本。

5. 点击安装以下载并安装应用程序。

为 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 文档

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 步：在连接器设置中声明相同的密钥

在连接器设置的密钥字段声明相同的密钥并保存设置。

连接演示版 ONLYOFFICE 文档

如果您想在不安装 ONLYOFFICE 文档的情况下于 Confluence 内部对 ONLYOFFICE 在线编辑器进行测试，可前往 Confluence 管理 >> 管理应用 >> ONLYOFFICE - Confluence 连接器 >> 配置，勾选连接至演示版 ONLYOFFICE 文档服务器并点击保存按钮。

这是一个可在 30 天内进行使用的公开测试服务器。请勿在此处分享您的敏感数据。

开始在 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 文档编辑器中打开。

如需了解更多有关表单的信息，请阅读与创建和填写表单相关的文档。