Alfresco

主要功能

• 创建、编辑和查看文本文件、电子表格和演示文稿。
• 文件转换。
• 实时协作编辑文档：两种协作模式（快速和严格）、修订模式、评论及内置聊天功能。
• 支持 JWT，保障您的数据传输安全，只有拥有相应权限的用户才能访问您的文档。

支持的格式

• 用于创建、编辑和查看：DOCX、PPTX、XLSX
• 用于表单处理：PDF
• 用于转换：ODT、ODP、ODS、DOC、XLS、PPT、RTF
• 通过转换为 OOXML 格式进行编辑：ODP、ODS、ODT、RTF、CSV、TXT
• 仅供查看：PDF

8.1.0 版本新功能

新增

• 编辑器中新增事件支持：onRequestReferenceData、onRequestReferenceSource、onRequestOpen

变更

• 修复忽略 SSL 证书设置的错误

完整更新日志请见 这里。

要求

• ONLYOFFICE Document Server v7.1（服务器或云端版本）或更高版本

  您需要一个 ONLYOFFICE文档 实例，该实例必须能被 Alfresco 和任何终端客户端访问并连接，且必须能够直接向 Alfresco 发送 POST 请求。

  请参考官方 文档页面 了解有关 ONLYOFFICE文档 安装的更多信息。
• Alfresco 版本：7.4、23、25
• ONLYOFFICE Connector 7.0.0 for Alfresco

编译 ONLYOFFICE Alfresco 模块包

如果您计划自行编译 ONLYOFFICE Alfresco 模块包（例如，编辑源码后再编译），请按以下步骤操作：

1. 需要最新稳定版的 Oracle Java 以成功构建。如果尚未安装，请使用以下命令安装 Oracle Java 8：

   sudo apt-get update 
                                    sudo apt-get install openjdk-8-jdk

2. 安装最新版 Maven。安装过程请参阅 官方 Maven 指南。
3. 下载 ONLYOFFICE Alfresco 模块包源码：

   git clone https://github.com/ONLYOFFICE/onlyoffice-alfresco.git

4. 获取子模块：

   git submodule update --init --recursive

5. 在 repo 和 share 目录中编译包：

   cd onlyoffice-alfresco && mvn clean install

另一种构建 ONLYOFFICE Alfresco 模块包的方法是使用 docker-compose 文件。

在项目目录下运行以下命令：

docker-compose up

配置 ONLYOFFICE 与 Alfresco 模块包

进入 Alfresco 管理控制台。打开 http://<alfrescohost>/alfresco/s/onlyoffice/onlyoffice-config 并填写以下参数。

设置项：

• 文档编辑服务地址 - 指定文档编辑服务安装的 URL 地址。
  重要 ONLYOFFICE文档 的地址必须能被 Alfresco 访问，同时 Alfresco 的地址也必须能被 ONLYOFFICE文档 访问。
• 密钥 - 指定用于签名数据的密钥。
  从 ONLYOFFICE文档 v7.2 开始，JWT 默认启用，且密钥自动生成。您需要在 Alfresco 端也启用此功能：在 ONLYOFFICE文档 配置文件中找到您的密钥，并在连接器设置中填写相同的密钥。详情请参见本文的 为 ONLYOFFICE 与 Alfresco 集成启用 JWT 部分。

高级服务器设置：

• Alfresco 服务器内部请求的文档编辑服务地址 - 指定 Alfresco 服务器访问文档编辑服务时使用的地址。
• 文档编辑服务内部请求的 Alfresco 服务器地址 - 指定文档编辑服务访问 Alfresco 服务器时使用的地址。
• 授权头（留空则使用默认头） - ONLYOFFICE 使用的 JWT 授权头为 Authorization。如果该头与您的环境冲突，可更改为自定义头。

常规设置：

• 忽略 SSL 证书 - 关闭 SSL。
• 启用强制保存 - 点击保存按钮后，直接将文档更改保存到 Alfresco 存储（若禁用，文档将保存在编辑器缓存中，直到关闭文档）。
• 转换后以新版本保存 docx、xlsx、pptx - 若禁用，将创建单独文件并放置于同一文件夹。
• 打开文件时通过转换为 OOXML 格式进行编辑 - 允许管理员选择通过转换为 OOXML 格式编辑的文档格式。
• 关闭编辑器后将文档保存为次要版本 - 决定关闭时文档版本是保存为主要版本（2.0、3.0）还是编辑中保存为次要版本（1.1、1.2），初始版本为 1.0。

工作原理

ONLYOFFICE 集成遵循此处文档化的 API：链接。

1. 用户在 Alfresco Share 中导航至文档并选择 在 ONLYOFFICE 中编辑 菜单选项。
2. Alfresco Share 向仓库端发送请求（URL 格式为：/parashift/onlyoffice/prepare?nodeRef={nodeRef}）。
3. Alfresco 仓库端为 Share 准备一个包含以下属性的 JSON 对象：
   • url - ONLYOFFICE文档 用于下载文档的 URL（包含当前用户的 alf_ticket）；
   • callbackUrl - ONLYOFFICE文档 用于通知文档编辑状态的 URL；
   • onlyofficeUrl - 客户端响应 ONLYOFFICE文档 的 URL（由 onlyoffice.url 属性提供）；
   • key - UUID+修改时间戳，指示 ONLYOFFICE文档 是否需要重新下载文档；
   • title - 文档标题（名称）。
4. Alfresco Share 使用该对象并从 freemarker 模板构建页面，填充所有值以便客户端浏览器加载编辑器。
5. 客户端浏览器请求 ONLYOFFICE文档 的 JavaScript 库，并向 ONLYOFFICE文档 发送带有上述属性的 DocEditor 配置。
6. 随后 ONLYOFFICE文档 从 Alfresco 下载文档，用户开始编辑。
7. ONLYOFFICE文档 向 callbackUrl 发送 POST 请求，通知 Alfresco 用户正在编辑文档。
8. Alfresco 锁定文档，但仍允许具有写权限的其他用户通过保留操作与 ONLYOFFICE文档 实时协作。
9. 所有用户和客户端浏览器完成编辑后，关闭编辑窗口。
10. 经过 10 秒 无操作后，ONLYOFFICE文档 向 callbackUrl 发送 POST，通知 Alfresco 客户端已完成编辑并关闭文档。
11. Alfresco 下载文档新版本，替换旧版本。

为 ONLYOFFICE 与 Alfresco 集成启用 JWT

为防止文档被未授权访问，ONLYOFFICE 编辑器使用 JSON Web Token (JWT)。令牌 在文档编辑器初始化时及 ONLYOFFICE文档 内部服务间命令交换时添加。密钥 用于签名 JWT 并在请求 ONLYOFFICE文档 时验证令牌。

从 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 值表示启用令牌验证。
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. 自动生成的密钥在三个部分中指定。您可以用自己的密钥替换默认值，且三个部分的密钥必须相同。
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. 修改后保存并重启服务以使配置生效。

   supervisorctl restart all

步骤 2：在连接器设置中填写相同的密钥

在连接器设置中，将相同的密钥填写到 密钥 字段，并保存设置。