Документооборот для BPMSoft

  1. Главная
  2. Документы
  3. Документооборот для BPMSoft
  4. Установка продукта Документооборот для BPMSoft
  5. Дополнительные подключения
  6. Онлайн-редакторы и хранилища файлов
  7. Р7 Офис Сервер документов

Р7 Офис Сервер документов

Разверните Р7 Офис Сервер документов EE из APT-репозитория Р7 на выделенном сервере Debian или Ubuntu. До установки уточните поддерживаемый выпуск ОС, версию пакета Р7 и профиль JWT для вашей версии коннектора Документооборота. Подготовьте DNS-имя сервера, сертификат HTTPS с цепочкой доверия и закрытый ключ. Команды с sudo выполняет администратор Linux.

Подключите репозиторий Р7

Обновите списки пакетов и установите curl и gpg для загрузки и подготовки ключа подписи.

sudo apt update
sudo apt install curl gnupg ca-certificates
curl --fail --show-error --location \
  --output /tmp/r7-office-signing-key.asc \
  https://download.r7-office.ru/repos/RPM-GPG-KEY-R7-OFFICE.public
gpg --show-keys --fingerprint /tmp/r7-office-signing-key.asc

Сверьте отпечаток с данными поставки. После сверки сохраните ключ в отдельном файле, используемом только репозиторием Р7.

sudo install -d -m 0755 /etc/apt/keyrings
sudo gpg --dearmor --output /etc/apt/keyrings/r7-office.gpg /tmp/r7-office-signing-key.asc
sudo chmod 644 /etc/apt/keyrings/r7-office.gpg
printf '%s\n' 'deb [signed-by=/etc/apt/keyrings/r7-office.gpg] https://downloads.r7-office.ru/repository/r7-server-apt/ r7 main' \
  | sudo tee /etc/apt/sources.list.d/r7server.list >/dev/null

Создайте файл авторизации с доступом только для root. Выполняйте этот шаг на новом сервере. Если файл уже существует, откройте его для редактирования, сохранив действующие параметры других подключений.

sudo install -m 0600 /dev/null /etc/apt/auth.conf.d/r7server.conf
sudoedit /etc/apt/auth.conf.d/r7server.conf

Впишите учётные данные репозитория, полученные с поставкой Р7.

machine downloads.r7-office.ru
login REPOSITORY_LOGIN
password REPOSITORY_PASSWORD

Выполните sudo apt update. При ошибке 401 или 403 проверьте учётные данные и имя репозитория.

Подготовьте зависимости и базу Р7

Установите PostgreSQL, RabbitMQ, NGINX и Redis на сервере редактора. Эти экземпляры обслуживают Р7.

sudo apt install postgresql rabbitmq-server nginx-extras redis-server
sudo systemctl is-active postgresql rabbitmq-server nginx redis-server

Ожидается состояние active для каждой службы. Создайте отдельную роль и БД Р7. Команда \password запрашивает пароль интерактивно. Задайте сгенерированный пароль и сохраните его для установщика.

sudo -u postgres psql
CREATE ROLE r7office LOGIN;
\password r7office
CREATE DATABASE r7office OWNER r7office;
\q

Проверьте подключение по TCP командой psql -h localhost -U r7office -d r7office -W -c 'SELECT current_database();'. После ввода пароля команда должна вывести r7office.

Перед установкой передайте установщику имя БД, пользователя и пароль через debconf. Введите тот же пароль, который задали роли PostgreSQL. Команды ниже рассчитаны на Bash. Пароль вводится без отображения и передаётся через стандартный ввод.

sudo -v
read -r -s -p 'Пароль PostgreSQL для Р7: ' r7_db_password
printf '\n'
{
  printf '%s\n' 'r7-office-documentserver-ee ds/db-name select r7office'
  printf '%s\n' 'r7-office-documentserver-ee ds/db-user select r7office'
  printf 'r7-office-documentserver-ee ds/db-pwd select %s\n' "$r7_db_password"
} | sudo debconf-set-selections
unset r7_db_password

Установите сервер документов

Выведите доступные версии. В следующей команде замените VERSION номером версии из первого вывода, согласованным для вашего подключения.

apt-cache policy r7-office-documentserver-ee
sudo apt install r7-office-documentserver-ee=VERSION
sudo systemctl status ds-docservice.service ds-converter.service ds-metrics.service

Если редакция требует лицензию, примените её по параметрам поставки до проверки редактирования. При сбое службы откройте её журнал, например sudo journalctl -u ds-docservice.service -n 100 --no-pager.

Настройте HTTPS в NGINX

Поместите сертификат с цепочкой и закрытый ключ по указанным ниже путям. Для тестового контура подойдёт сертификат внутреннего центра сертификации с DNS-именем Р7. Установите доверие к этому центру на рабочих местах и сервере BPMSoft. На сервере Р7 также должно быть настроено доверие к сертификату BPMSoft.

sudo install -d -m 0750 /var/www/r7-office/Data/ssl
sudo install -m 0644 /path/to/fullchain.pem /var/www/r7-office/Data/ssl/cert.pem
sudo install -m 0600 /path/to/private.key /var/www/r7-office/Data/ssl/privkey.pem
sudo cp -a /etc/r7-office/documentserver/nginx/ds.conf /etc/r7-office/documentserver/nginx/ds.conf.bak
sudo cp /etc/r7-office/documentserver/nginx/ds-ssl.conf.tmpl /etc/r7-office/documentserver/nginx/ds.conf
sudoedit /etc/r7-office/documentserver/nginx/ds.conf

Подставьте пути своих исходных файлов в команды install. В TLS-блоке конфигурации укажите DNS-имя сервера вместо r7.example.org и проверьте параметры.

server_name r7.example.org;
ssl_certificate /var/www/r7-office/Data/ssl/cert.pem;
ssl_certificate_key /var/www/r7-office/Data/ssl/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;

Если шаблон содержит устаревшую директиву ssl on;, используйте listen 443 ssl; в HTTPS-блоке. Проверьте синтаксис, перезапустите NGINX и обновите подпись ссылок Р7.

sudo nginx -t && sudo systemctl restart nginx && sudo bash /usr/bin/documentserver-update-securelink.sh

Настройте local.json

Файл /etc/r7-office/documentserver/local.json создаётся при установке Р7. Сохраните его копию и откройте исходный файл для редактирования. Обе команды выполняются с правами администратора. Копия хранится в каталоге /root. При повторном копировании предыдущая резервная копия сохраняется под номером.

sudo cp --backup=numbered --preserve=all /etc/r7-office/documentserver/local.json /root/r7-documentserver-local.json.bak
sudoedit /etc/r7-office/documentserver/local.json

Ниже показано, как выглядит конфигурация для Р7 с локальными PostgreSQL и RabbitMQ. Настройки JWT в примере относятся к проверке подключения в изолированном тестовом контуре.

{
  "services": {
    "CoAuthoring": {
      "sql": {
        "type": "postgres",
        "dbHost": "localhost",
        "dbPort": "5432",
        "dbName": "r7office",
        "dbUser": "r7office",
        "dbPass": "REPLACE_WITH_DATABASE_PASSWORD"
      },
      "token": {
        "enable": {
          "request": {
            "inbox": true,
            "outbox": false
          },
          "browser": false
        },
        "inbox": {
          "header": "AuthorizationJwt"
        },
        "outbox": {
          "header": "Authorization"
        }
      },
      "secret": {
        "inbox": {
          "string": "REPLACE_WITH_JWT_SECRET"
        },
        "outbox": {
          "string": "REPLACE_WITH_JWT_SECRET"
        },
        "session": {
          "string": "REPLACE_WITH_JWT_SECRET"
        }
      }
    }
  },
  "rabbitmq": {
    "url": "amqp://guest:guest@localhost"
  },
  "storage": {
    "fs": {
      "secretString": "KEEP_EXISTING_STORAGE_SECRET"
    }
  }
}
  1. В открытом файле найдите блок "services", внутри него — "CoAuthoring". В нём расположены блоки "sql", "token" и "secret". Меняйте поля в этих блоках. Например, если "dbName" уже есть, исправьте его значение в существующей строке. Сохраните остальные параметры установщика.
  2. В поле "dbPass" должен стоять пароль роли PostgreSQL r7office, заданный на этапе подготовки базы. Если установщик уже записал этот пароль, оставьте значение. Адрес RabbitMQ из примера подходит для локального брокера с учётной записью по умолчанию. Если установщик записал рабочий адрес RabbitMQ, сохраните его.
  3. В терминале выполните openssl rand -hex 32. Скопируйте полученную строку в три поля "string" внутри "secret". Сохраните её в защищённом хранилище. Эту же строку затем укажите в системной настройке BPMSoft R7JwtToken.
  4. В блоке "storage" → "fs" оставьте значение "secretString" из файла установщика. Это отдельный ключ подписи файловых ссылок.
  5. Сохраните файл. Если добавляли поле, проверьте запятые между соседними полями. Значения true и false записываются без кавычек.

Для рабочего контура согласуйте с поставкой коннектора заголовки JWT и режимы проверки входящих, исходящих и браузерных запросов. Проверьте защиту обработчика сохранения в BPMSoft перед передачей рабочих файлов.

Проверьте файл перед перезапуском

Выполните команду ниже. Она проверяет синтаксис JSON и скрывает содержимое файла, где хранятся пароли. Если python3 отсутствует, установите его командой sudo apt install python3.

sudo python3 -m json.tool /etc/r7-office/documentserver/local.json >/dev/null

При успехе команда завершится без вывода. Если появится ошибка, откройте файл через sudoedit, исправьте строку и столбец, указанные в сообщении, и повторите проверку. Чтобы вернуться к конфигурации до редактирования, выполните:

sudo cp --preserve=all /root/r7-documentserver-local.json.bak /etc/r7-office/documentserver/local.json

После успешной проверки JSON перезапустите компоненты Р7 и убедитесь, что все три службы выводят active.

sudo systemctl restart ds-docservice.service ds-converter.service ds-metrics.service
sudo systemctl is-active ds-docservice.service ds-converter.service ds-metrics.service

Откройте HTTPS-адрес Р7 в браузере. Должна загрузиться страница сервера документов без ошибки сертификата. Если служба завершилась с ошибкой, проверьте её журнал командой sudo journalctl -u ds-docservice.service -n 100 --no-pager.

Подключите BPMSoft

В Дизайнере системы → Системные настройки найдите настройки по коду.

Код Значение
R7ServerUrl Корневой HTTPS-адрес редактора, например https://r7.example.org.
R7JwtToken Общий секрет из конфигурации сервера документов.
OnlineEditService R7Office. Выберите после сохранения адреса и секрета.

Проверьте обмен по сетевой схеме. Браузер загружает интерфейс редактора. Сервер документов получает исходник из BPMSoft и отправляет запрос сохранения. BPMSoft скачивает результат и записывает версию вложения. Адреса исходника и обратного вызова должны быть доступны с сервера Р7 по DNS и HTTPS. Используйте предусмотренные поставкой обработчики с проверкой запросов.

Проверьте сохранение и перезапуск служб

Выполните проверку контрольного файла. Если редактор не открывается, проверьте HTTPS, JavaScript и WebSocket. Если исходник не загружается, проверьте доступ с сервера Р7 к BPMSoft и способ авторизации запроса. Если новая версия не появляется, проверьте завершение всех сеансов, приём обратного вызова и доступ BPMSoft к адресу результата.

После согласованного перезапуска служб Р7 повторите проверку сохранения. В резервную копию включите конфигурацию, базу и данные сервера Р7, сертификаты и секреты подключения.

Был ли данный материал полезен вам? Да Нет