ownCloud

Об интеграции ONLYOFFICE и ownCloud

ONLYOFFICE предлагает официальный коннектор для интеграции ONLYOFFICE Docs с ownCloud, который позволяет редактировать офисные документы в облачном хранилище. Коннектор ONLYOFFICE можно скачать из Marketplace ownCloud или со страницы ONLYOFFICE на GitHub. Коннектор распространяется по лицензии Apache-2.0.

примечание

Чтобы узнать больше о коннекторе интеграции ONLYOFFICE и ownCloud и подробностях его работы, посетите страницу нашей документации по API.

Основные возможности

Создание, редактирование и просмотр документов, электронных таблиц и презентаций.
Предоставление доступа к файлам с разными правами — просмотр и редактирование, рецензирование, заполнение форм и комментирование с упоминаниями пользователей. Также можно запретить скачивание (во всех редакторах) и изменение фильтров (в электронных таблицах). Доступно и предоставление доступа по публичным ссылкам.
Совместное редактирование документов в реальном времени: два режима совместного редактирования (Быстрый и Строгий), Отслеживание изменений, комментарии и встроенный чат.
Совместное редактирование между несколькими федеративными экземплярами ownCloud, подключенными к одному Document Server.
Поддержка JWT для защиты передаваемых данных: доступ к документам есть только у пользователей с соответствующими правами.

Поддерживаемые форматы

Для редактирования: DOCM, DOCX, DOTM, DOTX, XLSB, XLSM, XLSX, XLTM, XLTX, POTM, POTX, PPSM, PPSX, PPTM, PPTX, PDF
Для просмотра:
- WORD: DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTM, HTML, HWP, HWPX, MD, MHT, MHTML, ODT, OTT, PAGES, RTF, STW, SXW, TXT, WPS, WPT, XML
- CELL: CSV, ET, ETT, FODS, NUMBERS, ODS, OTS, SXC, XLS, XLSM, XLSX, XLT, XLTM, XLTX
- SLIDE: DPS, DPT, FODP, KEY, ODG, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, SXI
- PDF: DJVU, DOCXF, OFORM, OXPS, PDF, XPS
- DIAGRAM: VSDM, VSDX, VSSM, VSSX, VSTM, VSTX
Для конвертации в форматы Office Open XML с помощью пункта Convert with ONLYOFFICE: DOC, DOCM, DOT, DOTX, EPUB, HTM, HTML, ODP, ODT, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, RTF, XLS, XLSM, XLT, XLTM, XLTX.

примечание
ODT, ODS и ODP также доступны для мгновенной конвертации. После включения соответствующего параметра в настройках администратора документы в формате ODF сразу конвертируются в редакторе и открываются после нажатия на них.

Что нового в версии 9.12.1

Добавлено

Описание плагина и полезные ссылки в настройках администратора

Изменено

Исправлено открытие общей ссылки, когда доступ к приложению ограничен для групп
Общее сообщение Save success заменено отдельными сообщениями для каждого раздела настроек
Цвет кнопки сохранения настроек изменен на основной
Перед очисткой метаданных версий показывается окно подтверждения
При конвертации в типы изображений методом Download As скачиваются все страницы документа

Полный список изменений доступен здесь.

Подключение ONLYOFFICE Docs к ownCloud

Требования

ONLYOFFICE Document Server v7.0 (серверная или облачная версия) или более поздней версии

Вам нужен экземпляр ONLYOFFICE Docs, который доступен для разрешения имени и подключения как из ownCloud, так и с любых клиентских устройств. ONLYOFFICE Docs должен иметь возможность отправлять POST-запросы напрямую в ownCloud.

Начиная с версии 4.3.0, ONLYOFFICE Docs и ownCloud можно установить на разные компьютеры или на один и тот же. Если вы выберете второй вариант, для ONLYOFFICE Docs потребуется настроить другой порт, так как по умолчанию и ONLYOFFICE Docs, и ownCloud работают на порту 80.

примечание
Подробнее об установке ONLYOFFICE Docs читайте на официальной странице документации.
ownCloud v10.0.0 и более поздних версий
Коннектор ONLYOFFICE v8.2.3 и более поздних версий для ownCloud

Установка коннектора ONLYOFFICE для ownCloud

Администратор ownCloud может установить приложение интеграции из встроенного магазина приложений. Для этого выполните следующие действия:

Нажмите на меню-гамбургер в левом верхнем углу.
Выберите Market.
Перейдите в категорию Tools.
Найдите ONLYOFFICE в списке доступных приложений.
Нажмите кнопку Install.

Также администратор может установить приложение вручную:

Получите приложение ONLYOFFICE для ownCloud. Это можно сделать несколькими способами:
- Скачайте последнюю подписанную версию из официального магазина ownCloud.
- Или скачайте последнюю подписанную версию со страницы релизов приложения на GitHub. Например:
```
tar -xvzf vX.X.X.tar.gz
```
  Здесь vX.X.X — нужная версия коннектора.
  
  Распакуйте архив:
```
tar -xvzf vX.X.X.tar.gz
```
  Переименуйте папку в onlyoffice:
```
mv onlyoffice-owncloud-X.X.X onlyoffice
```
- Или клонируйте исходный код приложения и скомпилируйте его самостоятельно:
```
git clone https://github.com/ONLYOFFICE/onlyoffice-owncloud.git onlyoffice
cd onlyoffice
git submodule update --init --recursive
```
примечание
ownCloud не работает с неподписанными приложениями и показывает предупреждение, поэтому для рабочей среды нужно использовать вариант a или b, чтобы получить приложение.
Переместите папку onlyoffice в каталог apps/ сервера ownCloud (или в другой каталог, используемый для подключения приложений):
```
cp -r /root/onlyoffice/ /var/www/owncloud/apps/
```
Перейдите в каталог apps/:
```
cd /var/www/owncloud/apps
```
Измените владельца, чтобы обновлять приложение прямо из веб-интерфейса ownCloud:
```
chown -R www-data:www-data onlyoffice
```
В ownCloud перейдите в раздел Settings > Admin > Apps, нажмите Show disabled apps и нажмите Enable для приложения ONLYOFFICE.

Настройка коннектора ONLYOFFICE для ownCloud

Чтобы настроить приложение ONLYOFFICE, перейдите в раздел Settings > Admin > Additional.

В разделе Server settings укажите следующие параметры:

ONLYOFFICE Docs address — укажите URL-адрес, по которому установлена служба редактирования документов. Это поле обязательно для заполнения. Если вы устанавливаете ONLYOFFICE Docs на нестандартном порту, его нужно указать, например: http://127.0.0.1:8081/

примечание
Адрес ONLYOFFICE Docs должен быть доступен из ownCloud, а адрес ownCloud — из ONLYOFFICE Docs.
Disable certificate verification (insecure) — установите этот флажок, чтобы отключить проверку сертификата и позволить ownCloud подключаться к ONLYOFFICE Docs, если для ONLYOFFICE Docs используется самоподписанный сертификат (в противном случае ownCloud не будет проверять самоподписанный сертификат и не разрешит подключение к ONLYOFFICE Docs и от него). Это небезопасное решение, и мы настоятельно рекомендуем заменить сертификат на выданный центром сертификации.
Secret key — укажите секретный ключ, используемый для подписи данных.

примечание
Начиная с ONLYOFFICE Docs v7.2, JWT включен по умолчанию, а секретный ключ генерируется автоматически. Его нужно включить и на стороне ownCloud: найдите секретный ключ в файле конфигурации ONLYOFFICE Docs, а затем укажите тот же ключ в настройках коннектора. Подробнее см. в разделе Включение JWT для интеграции ONLYOFFICE и ownCloud этой статьи.
Раздел Advanced server settings можно использовать, если конфигурация вашей сети не позволяет отправлять запросы между установленным ownCloud и ONLYOFFICE Docs по общедоступным адресам. В этом случае укажите адреса для внутренних запросов в соответствующих полях:
- В поле ONLYOFFICE Docs address for internal requests from the server укажите адрес, по которому ownCloud обращается к службе редактирования документов.
- В поле Server address for internal requests from ONLYOFFICE Docs укажите адрес, по которому служба редактирования документов обращается к ownCloud.

Settings

Нажмите кнопку Save. После сохранения Server settings появятся разделы Common settings, Editor customization settings и Common templates.

В разделе Common settings можно задать следующие параметры:

Restrict access to the editors to following groups — установите этот флажок и выберите группы пользователей, которым не будет разрешено использовать редакторы ONLYOFFICE в ownCloud.
Use ONLYOFFICE to generate a document preview — установите этот флажок, чтобы создавать миниатюры с помощью ONLYOFFICE. Они будут занимать место на диске.
Open file in the same tab — установите этот флажок, чтобы открывать файл на текущей вкладке браузера. Если флажок снят, файл будет открываться на новой вкладке браузера.
Функция Keep metadata for each version once the document is edited позволяет сохранять метаданные и показывать изменения для каждой версии документа в истории версий. Метаданные будут занимать место на диске. Чтобы удалить метаданные и освободить место на диске, можно использовать кнопку Clear.
The default application for opening the format — позволяет отметить форматы, которые нужно связать с редакторами ONLYOFFICE. По умолчанию выбраны форматы docx, xlsx и pptx.

примечание
В редакторах ONLYOFFICE будут открываться только файлы тех форматов, которые выбраны в этом разделе.
Open the file for editing — позволяет администраторам выбрать форматы документов, которые можно редактировать, конвертируя их в форматы OOXML. По умолчанию выбраны форматы csv и txt.

Важно
Из-за ограничений форматов при сохранении в форматы из списка (csv, odp, ods, odt, rtf, txt) часть данных может быть потеряна.

После включения соответствующего параметра документы указанных форматов будут сразу конвертироваться и открываться для редактирования в редакторе ONLYOFFICE после нажатия на них и выбора пункта меню Open in ONLYOFFICE. Если формат не отмечен, файл будет открыт для просмотра.

В разделе Editor customization settings можно задать следующие параметры:

Функция Keep intermediate versions when editing (forcesave) позволяет отправлять все изменения непосредственно в хранилище при нажатии кнопки Save в интерфейсе редакторов ONLYOFFICE, чтобы предотвратить потерю данных. Если этот параметр отключен, изменения автоматически сохраняются в кеше редакторов.
Выберите элементы интерфейса редакторов, которые нужно скрыть или показать (Chat, More compact header, Feedback & Support, Help, Monochrome toolbar header).
Функция Review mode for viewing позволяет задать режим отображения рецензирования документа по умолчанию:
- Markup — выделять предлагаемые изменения,
- Final — показывать документ с принятыми изменениями,
- Original — показывать исходный документ без изменений.

Settings

После изменения Common settings и (или) Editor customization settings нажмите расположенную ниже кнопку Save, чтобы сохранить изменения.

В разделе Common templates можно нажать значок и загрузить шаблоны docx, xlsx или pptx для создания новых документов.

Шаблон из этого списка можно скачать или удалить с помощью соответствующих значков.

Settings

После добавления шаблонов в настройках администратора пользователи смогут выбирать шаблон при создании нового документа с помощью кнопки add в интерфейсе ownCloud или через меню Файл > Создать новый в интерфейсе редакторов ONLYOFFICE.

Проверка подключения

Проверить подключение к ONLYOFFICE Docs можно с помощью следующей команды occ:

occ onlyoffice:documentserver --check

Вы увидите текст с информацией об успешном подключении или о причине ошибки.

Как это работает

Интеграция ONLYOFFICE использует API, описанный здесь.

При создании нового файла пользователь переходит в папку с документами в ownCloud и выбирает пункт Document, Spreadsheet или Presentation в меню new (+).
Браузер вызывает метод create в контроллере /lib/Controller/EditorController.php. Этот метод добавляет копию файла из папки assets в папку, в которой сейчас находится пользователь.
При открытии существующего файла пользователь переходит к нему в ownCloud и выбирает пункт меню Open in ONLYOFFICE.
Открывается новая вкладка браузера, и вызывается метод index контроллера /lib/Controller/EditorController.php.
Приложение готовит JSON-объект со следующими свойствами:
- url — URL-адрес, по которому ONLYOFFICE Docs скачивает документ;
- callbackUrl — URL-адрес, по которому ONLYOFFICE Docs сообщает о статусе редактирования документа;
- documentServerUrl — URL-адрес, по которому клиент должен обращаться к ONLYOFFICE Document Server (задается на странице административных настроек);
- key — значение UUID+Modified Timestamp, по которому ONLYOFFICE Docs определяет, нужно ли снова скачивать документ.
ownCloud берет этот объект и создает страницу из шаблона templates/editor.php, подставляя все необходимые значения, чтобы браузер клиента мог успешно загрузить редактор.
Браузер клиента обращается к JavaScript-библиотеке ONLYOFFICE Docs и отправляет в ONLYOFFICE Docs конфигурацию DocEditor с перечисленными выше свойствами.
Затем ONLYOFFICE Docs скачивает документ из ownCloud, и пользователь начинает редактирование.
ONLYOFFICE Docs отправляет POST-запрос на callbackUrl, чтобы сообщить ownCloud, что пользователь редактирует документ.
Когда все пользователи и клиентские браузеры заканчивают редактирование, они закрывают окно редактирования.
Через 10 секунд бездействия ONLYOFFICE Docs отправляет POST-запрос на callbackUrl, сообщая ownCloud, что клиенты завершили редактирование документа и закрыли его.
ownCloud скачивает новую версию документа, заменяя старую.

Включение JWT для интеграции ONLYOFFICE и ownCloud

Чтобы защитить документы от несанкционированного доступа, редакторы ONLYOFFICE используют JSON Web Token (JWT). Токен добавляется в конфигурацию при инициализации редактора документов и при обмене командами между внутренними службами ONLYOFFICE Docs. Секретный ключ используется для подписи JSON Web Token и проверки токена при запросе к ONLYOFFICE Docs.

Начиная с ONLYOFFICE Docs v7.2, JWT включен по умолчанию, а секретный ключ генерируется автоматически. Вам нужно найти секретный ключ в файле конфигурации ONLYOFFICE Docs, а затем указать тот же ключ в настройках коннектора.

Шаг 1. Найдите секретный ключ в файле конфигурации ONLYOFFICE Docs

Откройте файл local.json в любом текстовом редакторе.

Для Linux — /etc/onlyoffice/documentserver/local.json
Для Windows — %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
Для Docker — войдите в контейнер ONLYOFFICE Docs с помощью команды docker exec -it <containerID> bash и откройте /etc/onlyoffice/documentserver/local.json

Также можно найти секретный ключ по умолчанию, не открывая local.json, с помощью следующей команды:
```
sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'
```

Файл local.json должен выглядеть так:

{
  "services": {
    "CoAuthoring": {
      "token": {
        "enable": {
          "request": {
            "inbox": true,
            "outbox": true
          },
          "browser": true
        }
      },
      "secret": {
        "inbox": {
          "string": "yoursecret"
        },
        "outbox": {
          "string": "yoursecret"
        },
        "session": {
          "string": "yoursecret"
        }
      }
    }
  }
}

Значение true указано в трех разделах. Это означает, что проверка токена включена.
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
Автоматически сгенерированный секретный ключ указан в трех разделах. Вы можете заменить секретное значение по умолчанию на собственный ключ. Ключ должен быть одинаковым во всех трех разделах.
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
Если вы внесли изменения, сохраните их и перезапустите службы, чтобы изменения конфигурации вступили в силу.
```
supervisorctl restart all
```

Шаг 2. Укажите тот же секретный ключ в настройках коннектора

В настройках коннектора укажите тот же ключ в поле Secret key и сохраните настройки.

Подключение к демонстрационному ONLYOFFICE Docs

Начиная с версии 3.0.1 коннектора ONLYOFFICE, вы можете опробовать онлайн-редакторы ONLYOFFICE в ownCloud, не устанавливая ONLYOFFICE Docs.

Чтобы включить подключение, установите флажок Connect to demo ONLYOFFICE Docs server и нажмите кнопку Save.

Важно

Это общедоступный тестовый сервер, который будет доступен в течение 30 дней. Не размещайте на нем конфиденциальные данные.

Установка ONLYOFFICE Docs с ownCloud через Docker Compose

С помощью Docker Compose можно быстро и просто развернуть предварительно настроенную версию ONLYOFFICE Docs, подключенную к ownCloud, со всеми необходимыми зависимостями в контейнерах Docker.

Установка Docker и Docker Compose

Следуйте этой инструкции, чтобы скачать и установить Docker на компьютер. Docker — это программа для автоматизации разработки приложений и управления ими в средах с поддержкой контейнеров.
Затем следуйте этой инструкции, чтобы скачать и установить менеджер пакетов Docker Compose, который позволяет описывать и запускать многоконтейнерные приложения.

Установка серверов ONLYOFFICE Docs и ownCloud

Скачайте последнюю версию репозитория docker-onlyoffice-owncloud. Для этого введите в командной строке следующую команду:
```
git clone --recursive https://github.com/ONLYOFFICE/docker-onlyoffice-owncloud
```
После загрузки репозитория перейдите в папку docker-onlyoffice-owncloud:
```
cd docker-onlyoffice-owncloud
```
Обновите подмодули в репозитории:
```
git submodule update --remote
```
Запустите Docker Compose:
```
sudo docker-compose up -d
```
примечание
После выполнения этой команды может потребоваться подождать пару минут, пока все контейнеры будут запущены и начнут работать.

Введите в адресной строке браузера http://localhost, чтобы открыть страницу настройки ownCloud и создать учетную запись администратора. Введите Login и Password (по умолчанию в обоих полях используется admin).

Теперь вы можете создавать и редактировать документы в ownCloud с помощью ONLYOFFICE Docs, не настраивая никакие параметры.

Параметры сервера задаются при развертывании, но вы можете изменить Common settings, Editor customization settings и Common templates. Подробнее о доступных настройках коннектора см. в разделе Настройка коннектора ONLYOFFICE для ownCloud.

Установка ONLYOFFICE Docs с ownCloud на виртуальной машине с помощью UCS

Виртуальные устройства (app appliances), предложенные компанией Univention, — это формат распространения, позволяющий устанавливать системы, в которые уже включены такие компоненты, как ONLYOFFICE Docs и ownCloud.

Univention, разработчик корпоративной инфраструктуры с открытым исходным кодом, предложил удобный способ установки систем, уже оснащенных сторонними компонентами, — виртуальные устройства приложений. Это образы VirtualBox или VMware, которые включают приложение, систему управления UCS и среду выполнения UCS.

Следующие виртуальные образы содержат Univention Corporate Server, ownCloud и ONLYOFFICE. Приложения работают сразу после установки благодаря дополнительно созданной автоматической настройке, которая обеспечивает правильную настройку необходимого дополнения ONLYOFFICE в ownCloud. Процесс установки гораздо проще классического ручного способа: администратору не нужно выполнять никаких действий вручную.

Скачайте необходимые компоненты

Сначала нужно установить гипервизор для виртуальной машины. Выберите VMware Workstation Pro или VirtualBox и следуйте документации, чтобы узнать подробности установки.

Затем скачайте ONLYOFFICE-ownCloud VM для выбранного гипервизора.

UCS step 1

Импортируйте виртуальное устройство

Теперь откройте гипервизор и импортируйте виртуальное устройство ONLYOFFICE-ownCloud. Как это сделать в обеих платформах, описано в этом руководстве.

Установите приложение

После успешного импорта образа запустите виртуальную машину. Пройдите процесс загрузки в мастере установки, выполнив следующие шаги.

Выберите язык и введите ближайший город.

Мастер определит язык системы, часовой пояс и раскладку клавиатуры по умолчанию.
Настройте домен и параметры сети. По умолчанию IP-адрес назначается автоматически. Также можно вручную указать IP-адрес, маску сети и шлюз. Введите адрес предпочтительного DNS-сервера.
Выберите параметры домена. По умолчанию выбран вариант Manage users and permissions directly on this system. Он позволяет создать новый домен в этой системе. Также можно подключиться к существующему домену UCS или Microsoft Active Directory.
Введите название компании, адрес электронной почты администратора для активации ONLYOFFICE (на этот адрес будет отправлен файл лицензии), создайте и подтвердите новый пароль для учетной записи администратора.
Укажите полное доменное имя этой системы и базу LDAP:
Проверьте параметры и убедитесь, что все заполнено правильно. Затем нажмите кнопку Configure System.
После завершения настройки ONLYOFFICE готов к запуску на созданной платформе UCS.
Введите свой IP-адрес в адресной строке браузера и загрузите файл ucs.license, полученный по электронной почте.
Чтобы войти в виртуальное устройство с ONLYOFFICE Docs и ownCloud, нажмите ownCloud в разделе Applications и введите имя пользователя и пароль по умолчанию (owncloud, owncloud).

Чтобы войти в Univention Management Console, нажмите LOGIN вверху или System and domain settings в разделе Administration и введите адрес электронной почты администратора и пароль, указанный при регистрации (см. шаг 4).

Включение редактирования в ownCloud Web

Чтобы работать в ownCloud Web, зарегистрируйте коннектор в файле config.json ownCloud Web:

Если вы установили ownCloud Web из официального маркетплейса, путь такой:
```
owncloud-root-catalog
```
Если вы скомпилировали его из исходного кода самостоятельно по этой инструкции, путь такой:
```
owncloud-web-root-catalog/config/config.json
```

Чтобы зарегистрировать коннектор, используйте эти строки:

"external_apps": [
    {
    "id": "onlyoffice",
    "path": "http(s):///custom/onlyoffice/js/web/onlyoffice.js"
    }
    ]

В зависимости от конфигурации вашего веб-сервера из пути в URL-адресе можно убрать сегмент index.php.

Начало работы с ONLYOFFICE Docs в ownCloud

Чтобы создать документ:

Откройте нужную папку в ownCloud.
Нажмите кнопку add.
Выберите нужный тип файла: Document, Spreadsheet или Presentation.
Введите название документа и нажмите Enter.
Необязательно. Если администратор добавил шаблоны, выберите нужный шаблон и нажмите Create.

Чтобы открыть документ для редактирования или просмотра:

Откройте папку с нужным документом.
Нажмите кнопку more или название документа.
Выберите пункт Open in ONLYOFFICE.

Чтобы конвертировать документ в формат Office Open XML:

Откройте папку с нужным документом.
Нажмите кнопку more или название документа.
Выберите пункт Convert with ONLYOFFICE.

примечание
Полный список форматов, которые можно конвертировать в OOXML, см. выше.

Форматы ODT, ODS, ODP и RTF также доступны для мгновенной конвертации. Если соответствующий параметр включен в настройках администратора, документы указанных форматов будут сразу конвертироваться и открываться для редактирования в редакторе ONLYOFFICE после нажатия на них и выбора пункта меню Open in ONLYOFFICE.

Подключение десктопных редакторов ONLYOFFICE к ownCloud

ONLYOFFICE позволяет редактировать файлы, хранящиеся в вашей учетной записи ownCloud, и совместно работать над ними как в онлайн-редакторах, так и в десктопных редакторах. Таким образом, можно использовать не только онлайн-инструменты для совместной работы, но и функции, доступные только в десктопном приложении:

защита документов паролем или цифровой подписью,
отправка редактируемого файла прямо из редактора с помощью плагина Send,
вставка аудио и видео в Редакторе презентаций.

примечание

Предполагается, что у вас уже установлены и настроены сервер ownCloud, ONLYOFFICE Docs и приложение интеграции.

Запустите десктопные редакторы ONLYOFFICE. Чтобы подключить десктопные редакторы к серверу ownCloud, выполните следующие действия:

Перейдите в раздел Подключиться к облаку на левой боковой панели.
Нажмите кнопку облачного сервиса ownCloud. Также можно воспользоваться ссылкой Подключить внизу.
Если вы нажали кнопку сервиса ownCloud, откроется окно Подключиться к облачному офису с выбранным ownCloud. Если вы воспользовались ссылкой Подключить, выберите облачное хранилище ownCloud в раскрывающемся списке.
- в поле Адрес облачного офиса введите доменное имя или IP-адрес вашего сервера ownCloud. Когда все будет готово, нажмите кнопку Подключить.
- Страница входа в ownCloud откроется на новой вкладке интерфейса десктопных редакторов.
  - Укажите Username or email и Password, которые вы используете для доступа к учетной записи ownCloud.
  - Нажмите кнопку Log in.

Откроется раздел Files вашей учетной записи ownCloud. Теперь вы можете редактировать существующие файлы и создавать новые, предоставлять доступ к документам и совместно работать над ними с пользователями ownCloud с помощью редакторов ONLYOFFICE.

Подробнее об управлении подключенными учетными записями см. в этой инструкции.

Подключение ONLYOFFICE Documents к ownCloud на iOS или Android

Вы можете подключить ownCloud к мобильному приложению ONLYOFFICE Documents, чтобы работать с документами, электронными таблицами и презентациями ownCloud и совместно редактировать их на ходу.

примечание

Предполагается, что у вас уже установлены и настроены сервер ownCloud, ONLYOFFICE Docs и приложение интеграции.

Чтобы подключить ONLYOFFICE к ownCloud на мобильном устройстве, скачайте и установите последнюю версию приложения ONLYOFFICE Documents для iOS или приложения ONLYOFFICE Documents для Android и выполните следующие действия:

Перейдите в раздел Облака.
Выберите ownCloud.
Введите URL-адрес вашего сервера ownCloud в поле Connection URL.
Введите логин и пароль своей учетной записи ownCloud.
Нажмите Далее.

Чтобы редактировать документы из ownCloud с помощью ONLYOFFICE Docs на мобильном устройстве, коснитесь нужного имени файла в списке.

Известные проблемы

Подключение внешних хранилищ. Добавление хранилища с помощью приложения External storages в некоторых случаях вызывает проблемы с совместным редактированием. Если подключение выполнено с одними и теми же ключами авторизации (выбран тип аутентификации Username and password или Global credentials), совместное редактирование доступно пользователям. Если используются разные ключи авторизации (варианты аутентификации Log-in credentials, save in database или User entered, store in database), совместное редактирование недоступно. Если используется тип аутентификации Log-in credentials, save in session, файлы нельзя открыть в редакторе.
Шифрование файлового хранилища. ownCloud предоставляет возможность шифрования файлового хранилища. Но если включено шифрование с ключами шифрования для каждого пользователя (используется по умолчанию в приложении Default encryption module ownCloud), ONLYOFFICE Docs не может открывать зашифрованные файлы для редактирования и сохранять их после редактирования. В разделе ONLYOFFICE страницы административных настроек будет показано уведомление об этом. Однако если настроить шифрование с мастер-ключом, приложение ONLYOFFICE будет работать как положено. Инструкция по включению шифрования на основе мастер-ключа есть в официальной документации на сайтах ownCloud.

Важно
ownCloud рекомендует использовать мастер-ключ шифрования только при новых установках без существующих данных или в системах, где шифрование еще не было включено, так как файлы, ранее зашифрованные с помощью ключей шифрования для каждого пользователя, могут быть безвозвратно потеряны после включения шифрования на основе мастер-ключа.
Проверка сертификата. Если для вашего Document Server используется самоподписанный сертификат, ownCloud не будет проверять такой сертификат и не разрешит подключение к Document Server и от него. Эту проблему можно решить двумя способами:
1. Установите флажок Disable certificate verification (insecure) на странице администрирования ONLYOFFICE в разделе Server settings в ownCloud.
2. Вручную измените файл конфигурации ownCloud. Найдите файл конфигурации ownCloud (/owncloud/config/config.php) и откройте его. Вставьте в него следующий раздел:
```
'onlyoffice' => array (     'verify_peer_off' => true )
```
  Это отключит проверку сертификата и позволит ownCloud подключаться к Document Server.
  
  примечание
  Помните, что это временное небезопасное решение, и мы настоятельно рекомендуем заменить сертификат на выданный центром сертификации. После этого не забудьте снять соответствующий флажок или удалить указанный выше раздел из файла конфигурации ownCloud.
Федеративный общий доступ к облаку. Если доступ к документу предоставлен с помощью приложения Federated Cloud Sharing, совместное редактирование между экземплярами ownCloud, подключенными к разным серверам ONLYOFFICE, будет недоступно. Пользователи одного и того же Document Server могут редактировать документ в режиме совместного редактирования, а пользователи двух (или более) разных Document Server совместно работать над одним документом в реальном времени не смогут.
Конвертация файлов. ONLYOFFICE Docs использует формат Office Open XML как основу при открытии и редактировании файлов. Если формат файла отличается от OOXML, он все равно будет конвертирован в соответствующий формат OOXML для корректной и быстрой работы Document Server. После этого вы можете редактировать файл, вносить любые изменения, доступные для базового формата OOXML, и сохранять файл в этом базовом формате OOXML.

Если исходный формат файла ownCloud отличался от базового, а вы все же хотите сохранить его в исходном формате, файл будет конвертирован в этот формат из OOXML. Так как форматы принципиально различаются, часть данных (например, диаграммы, таблицы, автофигуры или изображения) и форматирования может быть потеряна просто потому, что некоторые форматы (csv, txt и другие) не поддерживают их или обрабатывают иначе, чем стандарт OOXML. Поэтому все файлы не в формате OOXML по умолчанию открываются только для просмотра, хотя в контекстном меню есть возможность конвертировать файл. Если вы осознаете риски потери данных и форматирования после конвертации, но все же хотите открывать файлы не в формате OOXML для редактирования, можно отметить их в списке в настройках. Редактирование файлов csv и txt доступно по умолчанию.
При доступе к документу без разрешения на скачивание печать файла и использование системного буфера обмена недоступны. Копирование и вставка в редакторе доступны с помощью кнопок на панели инструментов редактора и в контекстном меню.

примечание

Чтобы узнать о наиболее распространенных проблемах и способах их решения, посетите наше руководство по устранению неполадок.

Об интеграции ONLYOFFICE и ownCloud​

Основные возможности​

Поддерживаемые форматы​

Что нового в версии 9.12.1​

Подключение ONLYOFFICE Docs к ownCloud​

Требования​

Установка коннектора ONLYOFFICE для ownCloud​

Настройка коннектора ONLYOFFICE для ownCloud​

Проверка подключения​

Как это работает​

Включение JWT для интеграции ONLYOFFICE и ownCloud​

Подключение к демонстрационному ONLYOFFICE Docs​

Установка ONLYOFFICE Docs с ownCloud через Docker Compose​

Установка Docker и Docker Compose​

Установка серверов ONLYOFFICE Docs и ownCloud​

Установка ONLYOFFICE Docs с ownCloud на виртуальной машине с помощью UCS​

Скачайте необходимые компоненты​

Импортируйте виртуальное устройство​

Установите приложение​

Включение редактирования в ownCloud Web​

Начало работы с ONLYOFFICE Docs в ownCloud​

Подключение десктопных редакторов ONLYOFFICE к ownCloud​

Подключение ONLYOFFICE Documents к ownCloud на iOS или Android​

Известные проблемы​

Об интеграции ONLYOFFICE и ownCloud

Основные возможности

Поддерживаемые форматы

Что нового в версии 9.12.1

Подключение ONLYOFFICE Docs к ownCloud

Требования

Установка коннектора ONLYOFFICE для ownCloud

Настройка коннектора ONLYOFFICE для ownCloud

Проверка подключения

Как это работает

Включение JWT для интеграции ONLYOFFICE и ownCloud

Подключение к демонстрационному ONLYOFFICE Docs

Установка ONLYOFFICE Docs с ownCloud через Docker Compose

Установка Docker и Docker Compose

Установка серверов ONLYOFFICE Docs и ownCloud

Установка ONLYOFFICE Docs с ownCloud на виртуальной машине с помощью UCS

Скачайте необходимые компоненты

Импортируйте виртуальное устройство

Установите приложение

Включение редактирования в ownCloud Web

Начало работы с ONLYOFFICE Docs в ownCloud

Подключение десктопных редакторов ONLYOFFICE к ownCloud

Подключение ONLYOFFICE Documents к ownCloud на iOS или Android

Известные проблемы