Что такое 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 коротких урока на телефоне.





