ONLYOFFICE 文档是一款开源办公套件，其是包含文本文档、电子表格、演示文稿、数字表单、PDF 查看器和转换工具的协作性编辑工具。要在 Alfresco 中使用 ONLYOFFICE 协作功能，可以将他们连接集成。阅读本文，了解这如何实现。

关于 ONLYOFFICE 和 Alfresco 集成

ONLYOFFICE 文档编辑器可与多种云服务进行集成，如：CMS 框架（WordPress/Strapi/Drupal）、协作与内容平台（ONLYOFFICE 工作区 / Nextcloud/Seafile/Confluence/Alfresco）、问题跟踪工具（Jira/Redmine）、线上教育解决方案（Moodle/Chamilo/HumHub）等等。您还可将编辑器嵌入至自建 Web 服务中。

ONLYOFFICE 推出的一款官方连接器有助于实现 ONLYOFFICE 文档与 Alfresco 集成，让用户可以在文档库中创建、编辑和转换办公文档。您可以从官方 Alfresco 插件目录或 ONLYOFFICE GitHub 页面下载这款 ONLYOFFICE 连接器。

如要详细了解 ONLYOFFICE 与 Alfresco 模块及其使用方式，请访问我们的 API 文档。

主要功能

创建、编辑、查看文本文档、电子表格及演示文稿。
转换文件。
实时协作编辑文档：支持两种协作编辑模式（快速和严格）、跟踪更改模式，有评论和内置聊天功能。
JWT 支持，保护您的流量安全，除具有相应权限的用户外，任何人都无法访问您的文档。

支持的格式

创建、编辑和查看：DOCX、PPTX、XLSX
处理表单：OFORM、DOCXF
转换：ODT、ODP、ODS、DOC、XLS、PPT、RTF
通过转换到 OOXML 进行编辑：ODP、ODS、ODT、RTF、CSV、TXT
仅查看：PDF

将 ONLYOFFICE 文档连接到 Alfresco Share

开始前，请确认您的软件符合以下要求：

ONLYOFFICE 文档服务器 v7.1 或更高版本
您需要一个 ONLYOFFICE 文档的实例，该实例可从 Alfresco 和任意最终客户端解析和连接；此外，必须能够直接发布到 Alfresco。

如要详细了解如何安装 ONLYOFFICE 文档，请参阅官方文档页面。

您还可以使用 ONLYOFFICE 文档云（SaaS版）。
Alfresco v.5.2 - 7.2
Alfresco 用的 ONLYOFFICE 连接器 6.0.0

安装 ONLYOFFICE 和 Alfresco 模块包

如需最新编译的包文件，可在 GitHub 获取；您会需要 onlyoffice-integration-repo.jar 和 onlyoffice-integration-share.jar 文件。如果您由于某种原因打算自行编译 ONLYOFFICE 和 Alfresco 模块包（例如编辑源代码、随后编译），请按照开发人员说明进行操作。

1. 在 repo 和 share 下载编译好的模块包：

cd onlyoffice-alfresco/
mvn clean install

2. 将编译好的 *.jar 包上传到 Alfresco 安装的相应目录中：

Alfresco 代码库：从 onlyoffice-alfresco/repo/target/ 到 /webapps/alfresco/WEB-INF/lib/。
Share：从 onlyoffice-alfresco/share/target/ 到 /webapps/share/WEB-INF/lib/。

3. （可选）编辑 alfresco-global.properties 文件，指定正确的主机名、开放端口和协议，因为 alfresco 和 share 要被部署为两个单独的服务。

alfresco.host=<hostname>
alfresco.port=443
alfresco.protocol=https

share.host=<hostname>
share.port=443
share.protocol=https

4. 重新启动 Alfresco

sudo ./alfresco.sh stop
sudo ./alfresco.sh start

检查模块是否在 /share/page/console/admin-console/module-package 列表中。

配置 ONLYOFFICE 和 Alfresco 模块包

前往 Alfresco 管理控制台。打开 http://<alfrescohost>/alfresco/s/onlyoffice/onlyoffice-config，指定以下参数。

文档服务器设置：

文档编辑服务地址：指定安装文档编辑服务的网址。

重要提示：ONLYOFFICE 文档的地址必须可从 Alfresco 访问，Alfresco 的地址也必须可从 ONLYOFFICE 文档访问。

密钥：指定用于签署数据的密钥。

从ONLYOFFICE 文档 v7.2 开始，JWT 为默认启用，并会自动生成密钥。您也需要在 Alfresco 端启用：在 ONLYOFFICE 文档配置文件中找到您的密钥，然后在连接器设置中指定相同的密钥。如要了解更多详细信息，请参阅本文的为 ONLYOFFICE 和 Alfresco 集成启用 JWT 部分。

高级服务器设置：

Alfresco 服务器中的内部请求的文档编辑服务地址：指定用于从 Alfresco 服务器访问文档编辑服务的地址。
文档编辑服务中的内部请求的 Alfresco 服务器地址：指定用于从文档编辑服务访问 Alfresco 服务器的地址。

通用设置：

忽略 SSL 证书：关闭 SSL。
启用强制保存：点击“保存”按钮后，可以将文档更改直接保存到 Alfresco 存储中（如果此设置被禁用，文档会被保存在文档编辑器的缓存中，直至文档被关闭）。
转换后将 docx、xlsx、pptx 保存为原始文件的新版本：如果此设置被禁用，系统会创建一个单独的文件，并将其放置在同一文件夹中。
打开文件进行编辑：允许管理员通过转换到 OOXML 格式来选择要编辑的文档格式。

Settings_menu

为 ONLYOFFICE 和 Alfresco 集成启用 JWT

为了保护文档免遭未经授权的访问，ONLYOFFICE 编辑器使用 JSON 网络令牌 (JWT)。在文档编辑器初始化时，以及在内部 ONLYOFFICE 文档服务之间交换命令时，令牌会被添加到配置中。密钥是被用于向 ONLYOFFICE 文档发出的请求时，对 JSON 网络令牌进行签名和验证。

从 ONLYOFFICE 文档 v7.2 开始，JWT 默认启用，并自动生成密钥。您需要在 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

或者，您可以使用如下命令，找到默认密钥，无需打开 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"
        }
      }
    }
  }
}

2. true 值会在 3 个地方被指定。这表示令牌验证被启用。