Если два пользователя загружают invoice.pdf, имя не должно становиться общим ключом хранения. Сервер назначает внутренний ID файла и связывает его с владельцем; пользовательское название остаётся подписью. Разделение по папкам удобно для учёта, но само по себе не запрещает одному аккаунту читать или перезаписывать данные другого.
Начните с двух тестовых аккаунтов и одинаковых безопасных файлов. Проверьте не только скачивание, но и замену вложения, создание миниатюры, удаление и повтор фоновой задачи. Коллизия часто появляется в производных: оригиналы разделены правильно, а уменьшенные версии сохраняются под общим именем.
Что хранится в записи файла
Условная запись приложения:
file_id: demo-file-a
owner_scope: demo-account-a
storage_key: accounts/demo-account-a/files/demo-file-a/original
original_name: invoice.pdf
state: readyВсе значения демонстрационные. owner_scope назначается из проверенного сервером контекста, а не из поля, присланного клиентом. Для организации с несколькими сотрудниками заранее определите владельца: отдельный человек, компания или общий ресурс. Не выводите это решение из названия папки при каждом запросе. Перенос файла между владельцами оформляется отдельной разрешённой операцией.
Матрица операций шире ссылки на скачивание
| Операция | Обязательная связь | Типичный пропуск |
|---|---|---|
| Новая загрузка | Текущий субъект и допустимый владелец | Клиент выбирает чужой префикс |
| Замена | ID файла и право изменять его | Проверяется только имя |
| Производная | Родительский файл и его scope | Worker теряет контекст |
| Удаление | Конкретный объект и право удаления | Удаляется всё с общим названием |
OWASP в рекомендациях для многопользовательского хранения предлагает отделять общие, организационные и пользовательские объекты, использовать разделённые ключи и проверять конкретный объект и действие. Имена помогают организации данных, а разрешение определяет сервер. Это распространяется и на служебные обработчики, не только на страницу личного кабинета.
Общедоступные логотипы и приватные документы не должны случайно наследовать одинаковую политику. Выделите намеренно общий набор отдельно. Если приложению нужен публичный просмотр изображения, согласуйте публикацию именно этого объекта; отсутствие запрета на прямой URL не является подтверждением того, что пользователь хотел сделать файл общим.
Одинаковые имена не требуют одинакового содержимого
Не заменяйте файл по original_name. Два документа с одним названием могут иметь разный смысл и владельца. Даже если вы объединяете одинаковые байты для экономии, права остаются связаны с каждой записью отдельно. Удаление одной ссылки не должно уничтожать содержимое, которое ещё требуется другому разрешённому объекту. Для такой оптимизации нужен отдельный протокол ссылок и очистки.
Для первой версии системы проще хранить независимые внутренние ключи, чем вводить сложное объединение без проверок. Производные стройте от file_id и профиля обработки. Повторная задача не должна выбирать путь по имени, переданному в старом сообщении очереди. Исполнитель проверяет актуальную запись и допустимость действия до записи результата.
Испытание на двух владельцах
- Загрузить одинаковое имя у А и Б: внутренние ключи различаются.
- Заменить файл А: файл Б сохраняет прежнее содержимое.
- Создать производные обоих: карточки остаются связаны со своими ID.
- Отправить ID Б от аккаунта А на стенде: операция отклоняется.
- Удалить тестовый файл А: разрешённый файл Б продолжает читаться.
Проверяйте список, карточку, API и фоновую обработку в одном сценарии. Ответ отказа не должен раскрывать содержимое чужого документа. При миграции из общего каталога сначала построите соответствие старых файлов и владельцев; неоднозначные записи остаются в разборе, а не автоматически приписываются последнему загрузившему. Сохраните журнал сопоставления для возврата.
Для проектирования подготовьте модель владельцев, перечень операций и обезличенный набор коллизий имён. По нему можно назначить ключи и проверить изоляцию записи, не ограничиваясь красивой раскладкой каталогов. Если принадлежность старого файла не доказана, новая структура папок не исправит эту неопределённость.