Что такое…

Что такое presigned URL — ссылка, которая живёт час и работает от твоего имени

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

Вот неожиданная штука. Подписанная ссылка на файл — не секретный адрес, который «никто не угадает». Это временный пропуск, выписанный от твоего имени: в документации Amazon S3 сказано прямо — права у ссылки те же, что у того, кто её подписал. Кто получил ссылку, тот на эти минуты стал тобой.

И вторая неожиданность, на которой спотыкаются почти все: такая ссылка не одноразовая. Ею можно пользоваться сколько угодно раз, пока не вышел срок.

Разберёмся, как она устроена — и почему это самый удобный способ отдать приватный файл.

Что такое presigned URL простыми словами

Presigned URL (предподписанная ссылка) — это обычный адрес файла в объектном хранилище, к которому дописана подпись и срок годности.

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

  • браузер просит у твоего сервера: «дай мне договор номер 42»;
  • сервер проверяет, что этот пользователь имеет право на договор, и подписывает ссылку своим ключом;
  • браузер идёт по ссылке прямо в хранилище, минуя твой сервер;
  • через 15 минут ссылка превращается в тыкву.

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

Что зашито внутри ссылки

Открой такую ссылку глазами — после знака вопроса там висит несколько параметров. Главные:

  • X-Amz-Expires — сколько секунд ссылка живёт;
  • X-Amz-Date — момент подписи, от него отсчитывается срок;
  • X-Amz-Signature — сама подпись;
  • X-Amz-Credential — чьим ключом подписано.

Хранилище на входе пересчитывает подпись и сверяет. Совпало и срок не вышел — отдаёт файл. Поменял в ссылке хоть один символ (например, попробовал подставить чужое имя файла) — подпись не сходится, и приходит отказ.

Максимальный срок — 604 800 секунд, то есть 7 дней. Не потому что кто-то так решил из вредности: сам ключ подписи живёт до семи дней, дольше подписать физически нечем.

Главное недоразумение: это не «секретная ссылка»

Раз ссылку можно открывать многократно, относись к ней как к ключу от квартиры, а не как к одноразовому коду из СМС.

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

Отсюда правило: срок ставь по сценарию, а не «на всякий случай побольше». Аватарка на странице — минуты. Экспорт отчёта, который человек скачает прямо сейчас, — 5–15 минут. Ссылка в письме, которое читают вечером, — час. Семь дней — почти всегда лишнее.

Загрузка работает так же — и вот где грабли

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

Но есть подвох, о котором AWS предупреждает отдельно: если объект с таким ключом уже есть, загрузка его перезапишет. Молча, без вопросов.

Отсюда два правила для ссылок на запись:

  • ключ придумывает сервер, а не браузер — иначе пользователь пришлёт users/1/avatar.jpg и затрёт чужую аватарку;
  • в ключ добавляй что-то случайное или идентификатор пользователя, чтобы два человека не столкнулись на одном имени.

Почему ссылка умерла раньше срока

Классическая загадка: поставил семь дней, а через час всё отвалилось.

Причина почти всегда одна: ссылку подписали временными ключами. Если код работает под ролью — на сервере в облаке, в serverless-функции, — у него не постоянный ключ, а временный, со своим сроком жизни. Ссылка не может пережить креды, которыми её подписали: сессия роли кончилась — подпись мертва, что бы ты ни написал в X-Amz-Expires.

Что делать: либо подписывать долгие ссылки постоянным ключом, который лежит в переменных окружения, либо принять короткий срок и выдавать ссылку заново по запросу. Второе честнее и почти всегда проще.

Можно ли отозвать выданную ссылку?

Точечно — нет. Живут только грубые способы: удалить объект, переименовать его (то есть скопировать под новым ключом) или забрать права у ключа, которым подписывали, — тогда отвалятся все ссылки, подписанные им. Поэтому короткий срок надёжнее любой кнопки «отозвать».

Можно ли подписывать ссылку прямо в браузере?

Нет. Для подписи нужен секретный ключ, а всё, что попало в браузер, считается публичным. Подпись живёт на сервере: в бэкенде, serverless-функции или edge-функции. Отдельная приятная деталь у Supabase Storage: подписи там делаются собственным внутренним ключом, отдельным от ключа, которым подписываются токены сессии.

Чем это отличается от публичного бакета?

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

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

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

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

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

Все статьи →