Alfresco

关于 ONLYOFFICE 和 Alfresco 的集成

ONLYOFFICE 提供了一个官方的连接器，用于将 ONLYOFFICE 文档与 Alfresco 集成，以在文档库中创建、编辑和转换办公文档。您可以从官方的 Alfresco Add-ons 目录或 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

6.0.0 版本的新增功能

新增

在文档编辑器创建新文件
在文档编辑器的文档模板中创建新文件
在文档管理器添加操作“下载为”
比较存储中的文件
合并存储中的邮件
插入存储中的图像
添加文件更改历史记录，突出显示版本之间的更改
自定义文档编辑器视图
在文档编辑器中收藏
为文档编辑器添加返回 url
按文档类型更改编辑器中的图标
检测手机浏览器
加利西亚语空文件模板

修复

在文档详细信息页面上加载预览
贡献者角色用户加入编辑时发生错误
不再支持文档服务器 v6.0 及更早版本

完整的变更日志可在此处获取。

将 ONLYOFFICE 文档连接到 Alfresco Share

要求

ONLYOFFICE 文档服务器 v7.1(服务器或云端版本)或更高版本
您需要一个可解析且可连接到 Alfresco 和任何终端客户端的 ONLYOFFICE 文档实例。它必须能够直接向 Alfresco 发送 POST 请求。
请参阅官方文档页面，了解有关安装 ONLYOFFICE 文档的更多信息。
Alfresco v.6.2 - 7.2
适用于 Alfresco 的 ONLYOFFICE 连接器 6.0.0

安装 ONLYOFFICE 和 Alfresco 模块包

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

在 repo 和 share 目录中下载编译好的包：
```
cd onlyoffice-alfresco/
mvn clean install
```
将编译好的 *.jar 包上传到相应的 Alfresco 安装目录中：
- 从 onlyoffice-alfresco/repo/target/ 到 Alfresco 存储库的 /webapps/alfresco/WEB-INF/lib/。
- 从 onlyoffice-alfresco/share/target/ 到 Share 的/webapps/share/WEB-INF/lib/。
（可选）编辑 alfresco-global.properties 文件以指定正确的主机名、开放端口和协议，因为 alfresco 和 share 是作为两个单独的服务部署的。
```
alfresco.host=<hostname>
alfresco.port=443
alfresco.protocol=https

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

重启 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 并指定以下参数。

文档服务器设置：

文档编辑服务地址 - 指定安装了文档编辑服务的 URL 地址。
重要提示 ONLYOFFICE 文档的地址必须可从 Alfresco 访问，并且 Alfresco 的地址也必须可从 ONLYOFFICE 文档访问。
密钥 - 指定用于签名数据的密钥
从 ONLYOFFICE 文档v7.2开始，默认启用 JWT，并自动生成密钥。您还需要在 Alfresco 端启用它：在 ONLYOFFICE 文档配置文件中找到您的密钥，然后在连接器设置中指定相同的密钥。有关更多详细信息，请参阅本文的为 ONLYOFFICE 和 Alfresco 集成启用 JWT 部分。

高级服务器设置：

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

常用设置：

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

启用 JWT 进行 ONLYOFFICE 和 Alfresco 集成

为了保护文档免遭未经授权的访问，ONLYOFFICE 编辑器使用 JSON Web 令牌 (JWT)。当初始化文档编辑器时，令牌被添加到配置中，在内部 ONLYOFFICE 文档服务之间的命令交换期间使用。密钥用于签署 JSON Web 令牌并在向 ONLYOFFICE 文档发出请求时验证令牌。

从 ONLYOFFICE 文档v7.2开始，默认启用 JWT，并自动生成密钥。您需要在 ONLYOFFICE 文档配置文件中找到您的密钥，然后在连接器设置中指定相同的密钥。

第 1 步：在 ONLYOFFICE 文档配置文件中找到您的密钥

使用任何可用的文本编辑器打开 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"}}}}}
```
true 由三个部分指定。这意味着令牌验证已启用。
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
自动生成的密钥由三个部分指定。您可以用您自己的密钥替换默认密钥值。三个部分的密钥必须相同。
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
如果进行了更改，请保存并重新启动服务以使配置更改生效。
```
supervisorctl restart all
```