Экспорт блочных файлов в Collabora CODE через WOPI

Чтобы запретить пользователям экспортировать открытый документ в Collabora Online CODE, настройте ваш WOPI-хост так, чтобы он возвращал значение "DisableExport": trueв ответе этого документа CheckFileInfo. В документации по интеграции Collabora это описывается как отключение функции экспорта; при установке этого параметра пункт меню «Скачать как» также скрывается. Это изменение затрагивает только интерфейс, поэтому оно не подходит, если цель — запретить экспорт. См. расширенные свойства ответа CheckFileInfoHideExportOption в Collabora .

Используйте разрешение WOPI, а не настройку, доступную только через меню.

CODE — это компонент редактирования в интеграции WOPI. Ваша служба хранения или приложения выступает в качестве хоста WOPI и предоставляет информацию по каждому файлу, когда Collabora открывает документ. Таким образом, хост является подходящим местом для принятия решения о том, может ли конкретный пользователь экспортировать конкретный файл.

В JSON-объект, возвращаемый конечной точкой хоста CheckFileInfo, добавьте логическое свойство:

{
  "BaseFileName": "quarterly-plan.docx",
  "Size": 24576,
  "UserCanWrite": true,
  "DisableExport": true
}

Это иллюстративный фрагмент, а не полный ответ CheckFileInfo. Сохраните остальные обязательные поля и любые существующие свойства интеграции, которые уже возвращает ваш хост. Ключевое значение должно быть логическим значением JSON, а не текстовой строкой "true". Установите его, используя тот же способ авторизации, который ваше приложение использует для файла и текущего пользователя.

Например, организация может разрешить сотрудникам редактировать конфиденциальную бюджетную книгу, но запретить им использовать функции экспорта Collabora. Когда хост WOPI открывает эту книгу для сотрудника, он возвращает значение DisableExport: true. Для общедоступного шаблона или обычного документа хост может вернуть значение falseв соответствии со своей политикой. Статическое значение, применяемое ко всем документам, уместно только в том случае, если каждый пользователь и каждый документ должны получать одинаковые ограничения.

Обновите хост WOPI, который предоставляет доступ к файлу.

1. Определите конечную точку интеграции. Найдите маршрут хоста, который отвечает на WOPI-запрос Collabora CheckFileInfoк файлу. В Nextcloud, ownCloud или другом продукте хранения данных это обычно означает изменение уровня интеграции или политики, генерирующего ответ; редактирование глобальной конфигурации контейнера Collabora не заменяет права доступа к файлу на хосте.
2. Примените правило в нужной области видимости. Получите значение из данных аутентифицированного пользователя, классификации файлов, прав доступа или другого правила в вашем приложении. Для простой политики, действующей для всех пользователей, верните значение true для каждого соответствующего документа. Избегайте использования настроек меню браузера или значений, предоставляемых клиентом.
3. Верните логическое значение в CheckFileInfo. Убедитесь, что ответ является допустимым JSON и включает свойство, полученное Collabora. Изменение политики на уровне кода может потребовать развертывания или перезапуска хост-приложения WOPI в зависимости от его фреймворка; сам код может не нуждаться в изменении конфигурации, если хост динамически предоставляет это поле.
4. Откройте документ заново. Закройте текущую сессию редактора и откройте файл снова под соответствующей учетной записью. В процессе открытия документа используется проверка CheckFileInfo, поэтому в уже открытой сессии изменения разрешений могут не отражаться.

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

Когда также следует устанавливать параметр HideExportOption?

Установите HideExportOptionэто значение, trueесли хотите скрыть элемент управления «Загрузить как», не применяя запрет на экспорт. Для фактического ограничения предпочтительнее использовать значение DisableExport: true; в руководстве по интеграции Collabora говорится, что это также подразумевает поведение скрытия меню. Возврат обоих полей в значение true может явно указать намерение в интеграции, но это не должно быть необходимым для описанного поведения.

Не путайте это с extra_export_formatsзаписями в coolwsd.xml. Текущий шаблон конфигурации Collabora явно указывает, что отключение этих дополнительных форматов только визуально скрывает их и не отключает экспорт на стороне сервера. Эти параметры определяют, какие дополнительные форматы предлагаются, а не имеет ли пользователь права экспортировать документ. Перед изменением глобальных настроек ознакомьтесь с текущим шаблоном конфигурации Collabora Online .

Что это ограничение защищает, а что нет.

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

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

Существует также различие между скрытием элемента интерфейса и отключением операции. Шаблон конфигурации Collabora делает это различие для своих необязательных настроек формата экспорта, в то время как поле ответа WOPI является ограничением на уровне интеграции. Первое действие полезно для упрощения меню; второе — это настройка, предназначенная для блокировки экспорта через Collabora. Если существующая интеграция ведет себя иначе, проверьте ее версию Collabora и изучите фактический ответ CheckFileInfo, а не предполагайте, что конкретный продукт-хост сопоставляет свой собственный флажок «отключить загрузку» с обоими полями.

Проверьте ограничение с помощью тестовой учетной записи.

1. Используйте учетную запись, не являющуюся учетной записью администратора, которая соответствует политике ограничений, и откройте тестовый документ в новой сессии.
2. Убедитесь, что опция «Скачать как» в редакторе больше недоступна. Если она по-прежнему отображается, проверьте ответ CheckFileInfo, полученный для этого пользователя и файла; убедитесь, что поле имеет логическое значение trueи что отображается новый ответ.
3. Проверьте действие экспорта через стандартный интерфейс Collabora. Политика хоста должна отражаться в поведении редактора. Не следует делать вывод о том, что контроль применяется только потому, что пункт меню скрыт.
4. Проверьте приложение для хранения данных отдельно: попробуйте использовать его собственный способ загрузки только в том случае, если ваш план тестирования это позволяет. Успешная загрузка означает, что политика доступа к исходным файлам по-прежнему разрешает её, даже если Collabora блокирует экспорт.
5. Откройте документ для пользователя, которому разрешен экспорт, и убедитесь, что ваш хостинг возвращает необходимые разрешения для данного случая. Это позволит выявить правила, которые были ошибочно применены глобально.

Для получения подробной информации о реализации используйте справочник по интеграции WOPI от Collabora и шаблон конфигурации проекта . Поддерживаемое поведение CODE может различаться в зависимости от версии и интеграции с хостом, поэтому проверьте ответ и результат на той версии, которую вы используете. Здесь не утверждается, что была протестирована конкретная версия хоста или пример развертывания.