Интеграция ONLYOFFICE с Nuxeo Platform

Краткие определения

• ONLYOFFICE Document Server — свободный пакет веб‑редакторов (текст, таблицы, презентации) под лицензией GNU AGPL v3.0. Поддерживает интеграцию с облачными хранилищами и платформами через API.
• Nuxeo Platform — open‑source платформа управления содержимым предприятия (ECM) на Java.

Что вы получите после интеграции

• Возможность открывать и редактировать .docx, .xlsx, .pptx внутри Nuxeo.
• Просмотр множества форматов (.pdf, .odt, .ods, .odp, .doc, .xls, .ppt, .csv, .rtf).
• Совместная работа в реальном времени: два режима соавторства, история изменений, комментарии и встроенный чат.
• Централизованное управление файлами без необходимости выгружать их локально.

Установка плагина интеграции ONLYOFFICE для Nuxeo

Запустите скрипт nuxeoctl на сервере Nuxeo:

nuxeoctl mp-install /path/to/onlyoffice-nuxeo-package-x.x.zip

Также можно установить приложение из официального Nuxeo Marketplace.

После установки сделайте контейнер ONLYOFFICE доступным для инстанса Nuxeo: настройте сетевые параметры контейнера или используйте публичный URL/локальное имя машины. В последнем случае обновите параметр nuxeo.url в файле nuxeo.conf.

Альтернативный вариант установки: сборка плагина из исходников

Если вы предпочитаете собрать плагин самостоятельно, потребуется стабильная версия Java. Пример установки OpenJDK 8 на Debian/Ubuntu:

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

Установите Maven:

sudo apt-get install maven

Склонируйте репозиторий с исходниками:

git clone https://github.com/onlyoffice/onlyoffice-nuxeo.git

Соберите плагин:

cd onlyoffice-nuxeo/
mvn clean install

Готовый пакет появится по пути:

./onlyoffice-nuxeo-package/target/onlyoffice-nuxeo-package-x.x.zip

Настройка плагина интеграции

Откройте файл nuxeo.conf и укажите URL сервера с установленным ONLYOFFICE Document Server:

onlyoffice.docserv.url=http://documentserver/

Задайте секрет JWT для подписи запросов:

onlyoffice.jwt.secret=YOURSECRET

Тот же ключ JWT нужно прописать в конфигурационном файле ONLYOFFICE на стороне Document Server.

Работа с документами в Nuxeo через ONLYOFFICE

Войдите в Nuxeo Platform. Перейдите Обзор -> Домен -> Рабочие области -> ONLYOFFICE-Nuxeo и создайте документ, таблицу или презентацию.

Вы также можете открыть интерфейс редакторов, нажав иконку ONLYOFFICE в меню документа:

После подключения вы получите интерфейс редактирования прямо в Nuxeo:

Практические советы по безопасности и сетевым настройкам

• Размещайте ONLYOFFICE Document Server в той же подсети или в сети с низкой латентностью относительно Nuxeo, чтобы снизить задержки редактирования.
• Всегда используйте HTTPS в продакшене. Для локальной отладки допускается HTTP.
• Храните секрет JWT в защищённом хранилище и не распространяйте его публично.

Критерии приёмки

• Редактор открывается из карточки документа в Nuxeo без ошибок авторизации.
• Изменения, внесённые в редакторе, успешно сохраняются и видны другим пользователям Nuxeo.
• Совместное редактирование работает в реальном времени в двух режимах соавторства.
• JWT подпись совпадает на стороне Nuxeo и Document Server.

Роль‑ориентированные чеклисты

Администратор платформы:

• Установить пакет плагина или собрать из исходников.
• Настроить onlyoffice.docserv.url и onlyoffice.jwt.secret в nuxeo.conf.
• Обеспечить сетевой доступ между серверами (порты, firewall).

Разработчик/интегратор:

• Проверить версии API и совместимость плагина с версией Nuxeo.
• Настроить обратный прокси и сертификаты HTTPS.
• Подготовить тесты приёмки и автоматические сценарии.

Пользователь:

• Открыть документ через интерфейс Nuxeo.
• Проверить сохранение и историю изменений.

Мини‑методология интеграции (порядок шагов)

1. Подготовить окружение: Nuxeo и ONLYOFFICE должны быть доступны по сети.
2. Установить плагин через nuxeoctl или собрать пакет из исходников.
3. Настроить URL Document Server и JWT ключ в nuxeo.conf.
4. Проверить открытие и сохранение простого .docx.
5. Прогнать сценарии совместного редактирования и утилитарные тесты.

Раздел отладки и сценарий инцидента

Типичные симптомы и действия:

• Не открывается редактор в Nuxeo:

  • Проверить доступность onlyoffice.docserv.url (curl/пинг).
  • Проверить логи Nuxeo и ONLYOFFICE на предмет ошибок CORS или 401/403.

• Документы не сохраняются:

  • Убедиться, что JWT секрет совпадает на обеих сторонах.
  • Проверить права на запись в хранилище Nuxeo.

• Очень высокая задержка редактирования:

  • Оценить сетевую задержку между Nuxeo и Document Server.
  • Рассмотреть размещение Document Server ближе к Nuxeo или увеличение ресурсов.

Инцидентный план отката:

1. Отключить плагин в Nuxeo (nuxeoctl mp-uninstall или через UI Marketplace).
2. Вернуть конфигурацию nuxeo.conf к предыдущему стабильному состоянию.
3. При необходимости восстановить резервную копию документов.

Совместимость и нюансы миграции

• Проверяйте совместимость версии плагина ONLYOFFICE с текущей версией Nuxeo перед установкой.
• При обновлении Nuxeo сначала тестируйте интеграцию в staging окружении.

Краткий факт‑бокс

• Лицензия ONLYOFFICE: GNU AGPL v3.0.
• Основные поддерживаемые форматы для редактирования: .docx, .xlsx, .pptx.
• Просмотр: множество форматов включая .pdf и .odt.

Глоссарий в одну строку

• JWT — JSON Web Token, механизм подписи и проверки авторизации запросов между Nuxeo и ONLYOFFICE.

Краткое резюме

• Установка плагина и настройка URL и JWT позволяют использовать ONLYOFFICE редакторы прямо в Nuxeo.
• Тестируйте интеграцию в staging, используйте HTTPS и храните секреты безопасно.
• При возникновении проблем проверьте сетевой доступ, соответствие JWT и логи обеих систем.

Важные заметки

• В продакшене всегда обеспечьте защищённый канал связи (HTTPS) и централизованное управление секретами.