Обзор

Print Friendly, PDF & EmailРаспечатать/сохранить в PDF

Начиная с версии 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.enable в конфигурации Сервера документов значение true:

Параметры

НазваниеОписаниеТипПример
wopi.enableОпределяет, включен WOPI или нет. Значение по умолчанию false.логическийtrue
Пример
{
    "wopi": {
        "enable": true
    }
}

Р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
}
  1. Измените следующие настройки по умолчанию. Введите свой «ip_address», который может содержать:
    • IP в формате X.X.X.X для ipv4,
      IP в формате хххх.хххх.хххх.хххх.хххх.хххх.хххх.хххх для ipv6,
      DNS-имя,
      * подстановочный знак для замены любого символа/символов.
  2. Изменить «разрешенное» правило, которое может быть true или false.
  3. Перезапустите службы, чтобы изменения конфигурации вступили в силу:
    supervisorctl restart all