Перейти к основному содержимому
Открыть Markdown

Безопасность и жизненный цикл данных

Хранилище защищает пространство объектов на уровне аккаунта. Аутентификация выбирает аккаунт, валидация ключа удерживает операции внутри его внутреннего префикса, а тип учетных данных определяет право песочницы на запись. Эти механизмы контроля не заменяют классификацию данных, хранение, версионирование и восстановление на уровне приложения.

Граница доступа​

КлиентПолномочия в хранилище
Аутентифицированная пользовательская сессия или JWTЧтение и запись в пространстве активного аккаунта
Принятый персональный токенЧтение и запись в хранилище своего аккаунта через текущий отдельный путь аутентификации хранилища
Токен песочницы с roСписок, просмотр и скачивание во всем пространстве аккаунта песочницы
Токен песочницы с rwЧтение, загрузка, перезапись и удаление во всем этом пространстве
Нет действующих bearer-учетных данныхНет доступа к API хранилища

Шлюз получает внутренний префикс объектов из аутентифицированного аккаунта; клиент не может выбрать его через ключ. Недопустимые начальные, пустые, . и .. сегменты отклоняются до вызова лежащего в основе хранилища.

Доступ песочницы включается явно и связан с песочницей, аккаунтом, режимом и поколением учетных данных. Смена или отзыв доступа делает старое поколение недействительным после распространения изменения. Повторная выдача создает новое поколение и не оживляет ранее утекший токен.

Прав доступа по префиксам нет. Песочница с rw может перезаписать или удалить любой объект в хранилище своего аккаунта, а не только ключи под соглашением вроде pipelines/worker-a/. Выдавайте потребителям режим ro, а rw оставляйте доверенным производителям.

Персональный токен только для чтения не является границей хранилища

Хранилище использует отдельный путь аутентификации для поддержки токенов песочниц. Текущий путь разрешает обычный персональный токен без применения общей для REST проверки безопасных методов. Поэтому персональный токен с правами read_only нельзя использовать как читателя хранилища с минимальными правами: принятый персональный токен получает доступ на чтение и запись. Используйте доступ ro, выданный песочнице, если нужно технически запретить коду изменять хранилище аккаунта.

Учетные данные и presigned URL​

Токены пользователей, персональные токены и JR_STORAGE_TOKEN — bearer-учетные данные. Получивший учетные данные может использовать их фактические полномочия, пока они не истекли, не отозваны или не ротированы. Передавайте учетные данные в заголовке Authorization; не помещайте их в ключи, строки запроса, исходный код, логи и вывод команд.

Presigned URL — более узкий, но все еще чувствительный bearer-доступ:

  • он разрешает один ключ объекта и один метод HTTP до expires_at;
  • presigned PUT также фиксирует заявленный content_length;
  • байты передаются напрямую между клиентом и лежащим в основе объектным хранилищем;
  • bearer-токен Just Run для него не нужен, и передавать его нельзя;
  • любой владелец URL может использовать его до истечения.

Отзыв персонального токена или доступа песочницы не отменяет уже выданный presigned URL. Публичного эндпоинта для отзыва отдельного URL нет. Используйте короткоживущий URL сразу, не допускайте его в историю браузера и логи и запрашивайте только перед готовой передачей. CORS ограничивает адреса, с которых обращается браузер, но не является границей авторизации для клиентов вне браузера.

Текущий PUT URL разрешает загрузить только неопубликованную часть. Публикация требует отдельного запроса завершения с действующим правом записи. Отзыв этого права запрещает новый запрос завершения, даже если URL части еще работает. Уже допущенное завершение может закончиться. GET URL по-прежнему разрешают прямое чтение; отзыв учетных данных шлюза не отзывает такие URL.

Для чувствительных данных требуйте HTTPS и для шлюза, и для адреса presigned URL, а также отклоняйте неожиданный хост или неожиданную схему. Внешние URL являются конфигурацией инсталляции, а не универсальным свойством API.

Жизненный цикл объекта​

С точки зрения публичного API объект проходит небольшой набор наблюдаемых состояний:

СобытиеРезультат
Загрузка по новому ключуКлюч становится доступен
Загрузка существующего ключаПрежние байты заменяются
Скачивание в песочницу или на клиентСоздается независимая копия вне хранилища аккаунта
Отзыв доступа к хранилищуБудущие запросы теряют доступ после распространения; объекты остаются
Удаление песочницыЕе учетные данные хранилища становятся недействительными; загруженные объекты аккаунта остаются
Удаление объектаКлюч перестает быть доступен через публичный API

Перезапись и удаление — необратимые операции. Публичный API хранилища не предоставляет версии объектов, мягкое удаление, отмену удаления, восстановление, юридическое удержание, срок жизни отдельных объектов и рекурсивное удаление префикса. Не рассчитывайте, что платформа восстановит прежние байты после перезаписи или удаления ключа.

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

Проектирование хранения и восстановления​

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

  1. Классифицируйте данные до загрузки и не помещайте секреты или персональные данные в ключи.
  2. Используйте неизменяемые или версионированные ключи для важных артефактов.
  3. Поддерживайте манифест с владельцем, контрольной суммой, временем создания и планируемым сроком удаления.
  4. Обходите полный постраничный список при выборе объектов для очистки.
  5. Перед удалением отдельного объекта сверяйте каждый целевой объект с манифестом.
  6. Храните копии для восстановления столько, сколько требует ваша политика, и проверяйте восстановление до того, как начнете на них полагаться.

Удаление песочницы или отзыв ее доступа не очищает опубликованные ею объекты. Удаление объекта аккаунта также не стирает копии, уже скачанные в песочницы, на компьютеры разработчиков, в кэши CI или в другую систему. Учитывайте эти копии как отдельные субъекты жизненного цикла.

Шифрование при хранении, версионирование объектного хранилища, резервные копии, блокировка объектов, срок физического стирания и место размещения данных зависят от инсталляции или провайдера. Публичный API хранилища не выбирает и не сообщает эти свойства. До обязательств по безопасности, соответствию требованиям или восстановлению получите подтверждение для конкретной инсталляции.

Удаление и проверка​

DELETE /v1/storage/objects/{key} идемпотентен и возвращает 204, даже если ключ уже отсутствует. 204 подтверждает завершение публичного запроса на удаление, но не является доказательством физического стирания из реплик провайдера или резервных копий за ограниченное время.

Для проверки на уровне приложения:

  1. сохраните точный ключ и ожидаемую контрольную сумму в записи об удалении;
  2. удалите объект;
  3. убедитесь, что HEAD или GET возвращает 404;
  4. обойдите страницы соответствующего префикса и убедитесь, что ключ отсутствует;
  5. дождитесь сверки потребления, прежде чем считать метрики квоты окончательными.

Если проверка удаления прервалась, безопасно повторите ее: и удаление объекта, и проверки отсутствия идемпотентны.

Граница аудита​

Когда журналирование аудита включено в инсталляции, хранилище без гарантий создает события управляющей части платформы для запросов presigned URL и удаления найденного объекта. Событие запроса presigned URL фиксирует выдачу URL, а не успех последующей прямой передачи.

Текущий поток аудита приложения не является полным журналом доступа к объектам: загрузка в теле запроса, получение списка, HEAD и скачивание в теле ответа не представлены все вместе как события аудита на уровне объектов, прямой трафик по presigned URL обходит шлюз, а асинхронный канал аудита может терять события под нагрузкой. Если нужна полная цепочка подтверждений, используйте манифесты приложения и настроенное для инсталляции журналирование доступа объектного хранилища.

Действия при утечке учетных данных​

  1. Отзовите или ротируйте скомпрометированный персональный токен либо установите для затронутой песочницы доступ none.
  2. Считайте уже выданные presigned URL действующими до истечения их собственного срока.
  3. После смены доступа запускайте новые процессы песочницы, чтобы они получили актуальное окружение.
  4. Получите список объектов аккаунта и сравните ключи, размеры и контрольные суммы приложения с заведомо исправным манифестом.
  5. Публикуйте восстановленные данные под новыми версионированными ключами до изменения указателей приложения.
  6. Проверяйте копии вне хранилища отдельно: отзыв не стирает уже скачанные байты.