Гайды

Как сделать файлы пользователей приватными — 5 шагов и одна дыра

Иллюстрация: закрытый ящик с именной биркой, рядом выдают бумажный пропуск

Первая версия приватности почти у всех выглядит так: файл называется a7f3c9e1-2b8d.pdf, ссылку никто не знает — значит, безопасно. Так вот, это не приватность, а надежда. Ссылка утекает через историю браузера, пересылку в чат, логи сервера и расширение, которое «просто читает страницу».

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

Шаг 1. Заведи отдельный приватный бакет

Не переключай существующий публичный — заведи второй. Пусть будет так:

  • public — обложки, иконки, логотипы: отдаются всем и кэшируются на CDN;
  • user-files — документы, чеки, аватарки, экспорт: приватный, наружу сам по себе не отдаёт ничего.

Смысл разделения простой: у этих двух групп разная судьба. Публичное можно раздавать вечно, приватное — только по пропуску. Если всё в одном ведре, однажды ты перепутаешь. Как устроены бакеты и ключи — в что такое объектное хранилище.

Шаг 2. Заложи владельца прямо в путь файла

Ключ придумывает сервер, и первым сегментом ставь идентификатор пользователя:

user-files/9f1c.../invoices/2026-09-04.pdf

Это не косметика. Через шаг ты будешь писать правило доступа, и ему нужен признак «чей файл» — брать его из пути дешевле всего. Заодно пропадает целый класс аварий, когда двое загрузили photo.jpg и один затёр другого.

Шаг 3. Включи правила доступа

В Supabase Storage приятная отправная точка: по умолчанию заливать в бакет нельзя вообще ничего, пока не написана политика. Не «можно всем» — а «нельзя никому». Дальше ты открываешь ровно то, что нужно.

Минимальный набор правил на таблицу storage.objects:

create policy "own files: upload"
on storage.objects for insert to authenticated
with check (
  bucket_id = 'user-files'
  and (storage.foldername(name))[1] = auth.uid()::text
);

Читается почти по-русски: залогиненный пользователь может положить файл в бакет user-files, если первая папка в пути — это его собственный идентификатор. Такое же правило на select даёт ему читать только своё.

Одна тонкость, на которой спотыкаются: если приложение перезаписывает файл (загрузка с заменой), одного insert мало — нужны ещё select и update, иначе замена аватарки будет молча падать.

Шаг 4. Отдавай не файл, а временный пропуск

Приватный бакет не отдаст объект по прямой ссылке — и правильно. Схема выдачи такая:

  • браузер просит у твоего сервера конкретный документ;
  • сервер подписывает временную ссылку на 10–15 минут;
  • браузер идёт по ней прямо в хранилище, минуя твой код.

Подписывать надо на сервере — в бэкенде или edge-функции. Механика подписи, сроки и почему такая ссылка живёт своей жизнью, разобраны в что такое presigned URL.

Шаг 5. Проверь право до подписи — это и есть та самая дыра

Вот главное место, где всё разваливается. Подпись не проверяет, кому принадлежит файл. Она подтверждает только одно: «эту ссылку выписал тот, у кого есть ключ». Если твой обработчик берёт путь из запроса и подписывает что дали, любой залогиненный пользователь попросит чужой путь — и получит чужой документ. С валидной подписью.

Порядок должен быть строго такой:

  1. понять, кто пришёл (сессия, токен) — база для этого закладывается в как добавить вход в приложение;
  2. проверить в базе, что запрошенный файл принадлежит именно ему;
  3. и только теперь подписывать ссылку.

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

Что получится

Пользователь жмёт «Скачать» и видит свой файл за долю секунды. Что изменилось под капотом:

  • прямая ссылка на объект не работает ни у кого, включая тебя;
  • утёкшая ссылка протухает за четверть часа;
  • чужой путь не подписывается — приходит отказ, а не документ;
  • файлы не текут через твой сервер, так что размер перестаёт упираться в лимиты приложения.

Три ошибки, которые видно в любом первом проекте

  • «Мы же нигде не публикуем эту ссылку». Публикует браузер, чат и логи. Считай любую выданную ссылку публичной с момента выдачи.
  • Один публичный бакет на всё. Один невнимательный getPublicUrl — и чек с адресом доставки лежит в открытом доступе.
  • Оригинал фото как есть. В снимке едут координаты съёмки — почисти метаданные на входе, см. что такое EXIF. Пошаговая загрузка картинок разобрана в как добавить загрузку картинок.

Какой срок жизни ставить ссылке?

По сценарию, а не «побольше». Показ картинки на странице — 5–15 минут. Ссылка в письме, которое откроют вечером, — час. Всё, что дольше суток, почти всегда означает, что ты решил не ту задачу: надёжнее выдавать свежую ссылку по запросу.

А если файл должен быть доступен по ссылке без входа?

Бывает: приглашение, публичный отчёт, «поделиться». Тогда это осознанно публичный файл — и вести себя надо соответственно: отдельный бакет, никаких персональных данных внутри и возможность отозвать доступ, удалив объект.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →