Files
mtusi2026lab5/openspec/changes/pipeline-reliability/specs/object-storage/spec.md
T
2026-10-31 10:08:03 +03:00

5.9 KiB

Spec Delta

MODIFIED Requirements

Requirement: Ограниченные учётные данные уборщика

У уборщика (capability storage-consistency) SHALL быть свои учётные данные S3, отдельные от учётных данных API и административных. Пользователю уборщика SHALL быть разрешены только:

  • чтение и удаление объектов своего bucket;
  • список объектов своего bucket с префиксами вложений и staging своей базы, <имя базы>/attachments/ и <имя базы>/staging/, — для сверки bucket и БД.

Префиксы задаёт bootstrap по имени базы стенда.

Пользователю уборщика MUST NOT быть разрешены:

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

Ключи уборщика MUST NOT передаваться репликам API. Уборщик MUST NOT получать ключи API, административные ключи S3 и ключ подписи.

Scenario: Работа уборщика с объектами

  • WHEN ключом API записан объект, а ключом уборщика он прочитан, удалён и удалён ещё раз, и запрошен список объектов с префиксом вложений базы и с префиксом staging базы
  • THEN чтение отдаёт те же байты, оба удаления успешны, объекта после них нет, а оба списка отвечают 200

Scenario: Запрещённые операции уборщика

  • WHEN ключом уборщика запрашиваются:
    • запись объекта;
    • список объектов всего bucket, с общим префиксом базы и с префиксом, не принадлежащим его базе;
    • создание и удаление bucket, политика и ACL bucket;
    • публичный ACL объекта;
    • объект другого bucket и его список
  • THEN каждый запрос получает 403, а bucket и его доступ не меняются

Requirement: Проверка приватности вне API

Приватность bucket и права ключей API, уборщика и worker SHALL проверяться без участия приложения двумя способами.

  1. Каждый запуск bootstrap:

    • ключ API записывает и читает проверочный объект и получает отказ на список и на создание bucket;
    • ключ worker записывает и читает проверочный объект и получает отказ на удаление, на список и на создание bucket;
    • ключ уборщика читает и удаляет проверочный объект. Он получает отказ на запись и на список всего bucket, а списки с префиксами вложений и staging своей базы у него проходят;
    • аноним получает отказ на чтение существующего объекта и на список.

    При нарушении bootstrap завершается с ненулевым кодом, и реплики API не стартуют.

  2. Отдельная команда make s3_check на запущенном стенде. Она повторяет проверки bootstrap и добавляет:

    • анонимные запросы с хоста и из сети стенда;
    • запросы ключей API, уборщика и worker к чужому bucket;
    • административные запросы ключей API, уборщика и worker;
    • запись ключом уборщика;
    • его список всего bucket и с чужим префиксом — отказ, с префиксами вложений и staging своей базы — 200.

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

Scenario: Проверка командой

  • WHEN на запущенном стенде выполняется make s3_check
  • THEN каждая проверка напечатана с полученным кодом ответа, в том числе проверки списка ключом уборщика по своим и чужому префиксу и отказ ключу worker на удаление и список, код выхода 0, а проверочных объектов и bucket после команды нет

Scenario: Bucket стал публичным

  • WHEN на bucket открыт анонимный доступ на чтение, например административной командой мимо bootstrap
  • THEN make s3_check завершается с ненулевым кодом и называет нарушенную проверку, а следующий запуск bootstrap снова закрывает доступ