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 проверяться без участия приложения двумя способами.
-
Каждый запуск bootstrap:
- ключ API записывает и читает проверочный объект и получает отказ на список и на создание bucket;
- ключ worker записывает и читает проверочный объект и получает отказ на удаление, на список и на создание bucket;
- ключ уборщика читает и удаляет проверочный объект. Он получает отказ на запись и на список всего bucket, а списки с префиксами вложений и staging своей базы у него проходят;
- аноним получает отказ на чтение существующего объекта и на список.
При нарушении bootstrap завершается с ненулевым кодом, и реплики API не стартуют.
-
Отдельная команда
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 снова закрывает доступ