Продукты Р7
Корпоративный сервер 2024
Корпоративный сервер 2024
Сервер документов
Сервер документов
Редакторы
Редакторы
Корпоративный сервер 2019
Корпоративный сервер 2019
Графика
Графика
Команда
Команда
Мобильные редакторы
Мобильные редакторы
Облачный офис
Облачный офис
Почта
Почта
Органайзер
Органайзер
Дополнительно
Часто задаваемые вопросы
Разработчикам
Интеграции
Новые возможности
Главная
/Сервер документов
/API
/Использование WOPI

Обзор

Обновлено: 25.12.25

Содержание

  1. Включение WOPI
  2. IP-фильтр

Начиная с версии 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