Обзор

Начиная с версии 6.4, Р7 Document Server предлагает поддержку Web Application Open Platform Interface Protocol (WOPI) — протокола на основе REST, который используется для интеграции вашего приложения с онлайн-офисом. Операции WOPI позволяют открывать файлы, хранящиеся на сервере, редактировать и сохранять их.

В этой документации описаны:

• свойства файла, которые можно указать с помощью WOPI discovery;
• хост-страница, которая должна быть построена для создания элемента iframe в онлайн-офисе;
• ключи проверки, которые используются для проверки того, что запрос получен из онлайн-офиса;
• поддерживаемые функции WOPI REST API;
• доступные сообщения, которые можно публиковать через PostMessage;
• различия между Р7 Document Server API и WOPI;
• Дополнительные сведения о протоколе WOPI см. в WOPI документации.

Все необходимые WOPI настройки вы можете найти и изменить в конфигурационном файле, который можно найти (или создать) по следующему пути:

• Для Linux — /etc/Р7/documentserver/local.json
• Для Windows — %ProgramFiles%\Р7\DocumentServer\config\local.json

Значения по умолчанию доступны в файле конфигурации default.json, который доступен в папках выше (для Linux и Windows). Пожалуйста, не редактируйте содержимое файла default.json напрямую. Значения по умолчанию будут восстанавливаться каждый раз, когда вы перезапускаете контейнер Docker или обновляете Сервер документов до новой версии, и все ваши изменения будут потеряны.

Включение WOPI

Чтобы включить WOPI, установите для параметра wopi.enable в конфигурации Сервера документов значение true:

Параметры:

Пример:

{
  "wopi": {
    "enable": true
  }
}

IP-фильтр

Р7 Document Server может принимать запросы WOPI только от доверенного интегратора. IP-адрес такого интегратора должен быть включен в Белый список домена WOPI. При этом доступ для всех остальных интеграторов должен быть закрыт.

По умолчанию все IP-адреса считаются доверенными.

Выполните следующие действия, чтобы настроить IP фильтр: Сервера документов:

1. Откройте файл /etc/Р7/documentserver/local.json с помощью любого доступного текстового редактора:

"ipfilter": {
  "rules": [
    {
      "address": "ip_address",
      "allowed": true
    },
    {
      "address": "*",
      "allowed": false
    }
  ],
  "useforrequest": true,
  "errorcode": 403
}

2. Измените следующие настройки по умолчанию. Введите свой «ip_address», который может содержать:

• IP в формате X.X.X.X для ipv4;
• IP в формате хххх.хххх.хххх.хххх.хххх.хххх.хххх.хххх для ipv6;
• DNS-имя.

3. Изменить «разрешенное» правило, которое может быть true или false.

4. Перезапустите службы, чтобы изменения конфигурации вступили в силу:

supervisorctl restart all