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

原创
2022/12/30 16:05
阅读数 478

在本文中,我们来解释如何将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 连接器 >> 配置

高级服务器设置:

  • 文档编辑服务内部请求服务器地址 - 用于从文档编辑服务访问 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
  1. 在以下 3 个位置将 false 修改为 true 以启用 Token 验证功能:
  • services.CoAuthoring.token.enable.browser
  • services.CoAuthoring.token.enable.request.inbox
  • services.CoAuthoring.token.enable.request.outbox
  1. 在以下 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"
        }
      }
    }
  }
}
  1. 保存更改。
  2. 重启服务以使配置更改生效:
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 中填写链接。
  1. 表单将在 ONLYOFFICE 文档编辑器中打开。

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

展开阅读全文
加载中
点击引领话题📣 发布并加入讨论🔥
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部