Как передать права собственности на общие файлы на сервере ownCloud

Коллега уходит, проект переходит в другую команду, или общая папка по-прежнему принадлежит учетной записи, которая вот-вот будет отключена. Файлы могут отображаться в представлении ownCloud получателя, но доступ к ним может быть только через общий доступ. Если исходная учетная запись удалена, это различие может стать проблемой.

В ownCloud Server 10.x администратор может передать права собственности с помощью инструмента командной строки occ files:transfer-ownership. В документации Server 10.16 отсутствует кнопка «Сделать меня владельцем», доступная пользователю. Команда перемещает файлы, принадлежащие одной учетной записи, и ее исходящие общие ресурсы в другую учетную запись; входящие ресурсы не передаются. Приведенные ниже шаги используют текущий справочник команд ownCloud Server 10.16. Перед выполнением изменения прав собственности проверьте документацию, чтобы узнать точную версию и конфигурацию хранилища, которые вы используете.

Для начала определите, что нужно переместить.

«Предоставлено мне» не обязательно означает «принадлежит мне». В ownCloud учетная запись, создавшая файл или владеющая им, может предоставлять к нему доступ другим пользователям. Получатель может читать или редактировать предоставленный файл, не являясь его владельцем. Если вы являетесь получателем, обычно следующим шагом будет обращение к первоначальному владельцу или администратору с просьбой переместить файл.

Команда transfer — это операция администратора на хосте ownCloud Server. Она может переместить все файлы, принадлежащие пользователю-источнику, или выбранную папку и её содержимое. Выбранный путь должен находиться внутри каталога файлов этого пользователя. Она не переносит входящие общие папки, содержимое корзины или старые версии файлов. Официальная справочная информация по командам ownCloud Server 10.16 OCC описывает эту команду и её параметры.

Данное руководство описывает ownCloud Server (классический продукт версии 10.x). ownCloud Infinite Scale — это другой продукт с другой архитектурой и пользовательским интерфейсом. Не следует предполагать, что эта команда Server или её результаты применимы к развертыванию Infinite Scale; ознакомьтесь с документацией для установленного вами продукта.

Выберите правильный диапазон передачи

Перед выполнением команды

1. Подтвердите продукт и версию. Убедитесь, что это ownCloud Server 10.x, а не ownCloud Infinite Scale, и ознакомьтесь со справочником команд для установленной версии.
2. Подтвердите оба идентификатора учетных записей. Используйте фактические идентификаторы пользователей ownCloud, а не имена пользователей или адреса электронной почты, если это не те идентификаторы. Внимательно проверьте орфографию: source и destination — позиционные аргументы.
3. Проверьте влияние на общие ресурсы. Команда может перемещать исходящие общие ресурсы, принадлежащие исходной учетной записи. Входящие общие ресурсы исключаются. Сообщите коллегам о любых ожидаемых изменениях в правах собственности или доступе.
4. Создайте и проверьте резервную копию. Следуйте стандартной процедуре резервного копирования базы данных и хранилища данных вашего сайта. Передача файлов изменяет права собственности и отношения доступа; восстанавливаемая резервная копия — более безопасный вариант отката.
5. Проверьте сведения о хранилище и развертывании. Подтвердите каталог установки ownCloud и правильную учетную запись веб-сервера. В стандартной установке Linux эта учетная запись часто называется www-data, но в пакетах и ​​контейнерах она может отличаться.

Если вы используете S3-совместимое основное хранилище с несколькими сегментами, остановите его и ознакомьтесь с предупреждением, специфичным для данного хранилища, в официальной документации ownCloud по S3-совместимому основному хранилищу . В нем говорится, что передача прав собственности в такой конфигурации не рекомендуется, поскольку может привести к потере долей.

Перенести выбранную общую папку

Используйте выборочную передачу, когда в целевую папку нужно передать проект или небольшой набор файлов, а не всю коллекцию файлов пользователя-источника. В приведенном ниже примере передается папка с именем Projects/Proposalот пользователя с ID aliceк пользователю с ID bob.

1. Откройте командную строку на хосте ownCloud Server и перейдите в каталог, содержащий occскрипт. Используйте путь, соответствующий вашей установке.
2. Перед запуском команды проверьте её параметры:

sudo -u www-data ./occ files:transfer-ownership --help

3. Выполните выборочную передачу. Пример пути указан относительно aliceкаталога файлов ownCloud; это не путь к файловой системе сервера:

sudo -u www-data ./occ files:transfer-ownership \
  --path="Projects/Proposal" \
  alice \
  bob

Замените команду www-data, если в вашей установке используется другая учетная запись службы. При развертывании в контейнере используйте описанную в документации форму команды контейнера, а не копируйте команду хоста дословно. Например, в документации для разработчиков ownCloud показана форма Docker Compose, например, такая: docker compose exec owncloud occ ...; имена служб различаются в зависимости от развертывания.

Эта команда помещает выбранную папку и ее содержимое в файловую область целевого пользователя в папку, имя которой указано в шаблоне transferred from alice on [timestamp]. Она не сохраняет исходное расположение папки верхнего уровня в неизменном виде. После завершения выполнения команды проверьте целевую учетную запись для этой папки.

Переведите все данные, принадлежащие одному аккаунту.

Если пользователь уходит, и цель состоит в перемещении всех принадлежащих ему файлов и исходящих общих ресурсов, опустите --path:

sudo -u www-data ./occ files:transfer-ownership \
  alice \
  bob

Перед принятием команды ознакомьтесь с подтверждающим сообщением. Команда может сообщить о невозможности передачи ресурсов. Эта --accept-skipped-sharesопция указывает ownCloud продолжить выполнение, если ресурсы пропущены; используйте её только в том случае, если вы понимаете и принимаете такой исход. Не добавляйте её просто для подавления запроса.

Также существует --destination-use-user-folderвариант для конкретного случая миграции всех пользователей. Целевой пользователь должен быть создан, но никогда не должен был входить в систему; ownCloud рекомендует использовать режим обслуживания для этой операции. Поскольку он имеет более строгие предварительные условия и изменяет место сохранения данных, не используйте его для обычной передачи или выборочного перемещения.

Проверьте результат и укажите пропущенные ресурсы.

1. Войдите в систему как целевой пользователь или попросите его проверить раздел «Файлы». Для выборочной передачи подтвердите transferred from …папку с меткой времени и откройте соответствующие файлы.
2. Убедитесь, что присутствует ожидаемая структура папок и актуальное содержимое файлов. В справочнике команд Server 10.16 указано, что версии файлов не передаются; в целевой учетной записи отображается только последняя версия.
3. Проведите проверку важных ресурсов с теми, кто от них зависит. Поскольку исходящие ресурсы перемещаются, а входящие — нет, перевод не делает целевой аккаунт получателем всех ресурсов, которые были переданы источнику.
4. Сохраняйте доступ к исходной учетной записи до тех пор, пока владелец целевой учетной записи и затронутые участники не подтвердят доступ. Деактивацию учетной записи следует завершать только после этой проверки и стандартного анализа сроков хранения данных.

Если при передаче возникает ошибка или она преждевременно завершается, ownCloud предоставляет документацию files:troubleshoot-transfer-ownershipпо проверке проблем, связанных с передачей. По умолчанию выполняется пробный запуск, в ходе которого сообщается о результатах. Например:

sudo -u www-data ./occ files:troubleshoot-transfer-ownership --uid bob

Сначала проверьте вывод команды. Команда также имеет --fixопцию попытки исправления, поэтому не добавляйте эту опцию, не проверив сообщенные проблемы и не имея актуальной резервной копии. Доступные проверки и параметры перечислены в том же официальном справочнике OCC .

Итоговая самопроверка

• Вы использовали правильные данные об экземпляре сервера ownCloud, его версии, идентификаторе источника и идентификаторе назначения?
• Вы выбрали желаемую область действия: путь или все файлы, принадлежащие источнику?
• Учли ли вы пропущенные исходящие и входящие запросы, содержимое корзины и старые версии?
• Сможет ли пользователь, которому будет передан файл, найти и открыть его, и смогут ли затронутые им участники проекта по-прежнему получить доступ к необходимым им файлам?
• Вы сохранили проверенную резервную копию и отложили удаление учетной записи до подтверждения передачи?

Успешная команда — это только начало процесса передачи. Перед тем как считать передачу прав собственности завершенной, подтвердите новое местоположение, содержимое файлов и права доступа для совместной работы.