Files
mtusi2026lab2/docs/DEFENSE.md
T

6.8 KiB

Защита лабораторной 2

Целевая оценка — 4. Основа первой работы сохранена: пользователи, чаты, участники, сообщения, проверки доступа и cursor-пагинация. Изменилось хранение и подтверждение личности.

Суть решения за минуту

В первой работе всё лежало в RAM одного процесса и исчезало после рестарта. Теперь бизнес-данные хранятся в PostgreSQL на именованном volume. Redis хранит серверные сессии с TTL и AOF. Регистрация принимает пароль, scrypt сохраняет его хеш. Вход с Basic выдаёт случайный Bearer-токен. По токену сервер находит пользователя, затем отдельно проверяет его участие в чате.

Демонстрация

Из папки проекта:

python scripts/init_local.py
docker compose --env-file .env up -d --build --wait
docker compose --env-file .env build checks
python scripts/verify.py --skip-build

Команда проверки создаёт только синтетические данные. Она временно останавливает хранилища этого Compose-проекта, восстанавливает их и оставляет основной стенд запущенным. Её выполняют на учебном стенде.

  1. Открыть docs/DATABASE.md: показать таблицы, FK, уникальный username и транзакцию создания чата.
  2. Открыть evidence/smoke.txt и evidence/student-tests.txt: публичный сценарий, гонка регистрации, rollback, 100 сообщений из 10 клиентов.
  3. Открыть scripts/restart.sh, evidence/persistence.txt, evidence/restart.json: перезапущены API, PostgreSQL и Redis; StartedAt изменился у всех трёх, имена volumes сохранились. Публичный тест использовал старый токен без повторного входа.
  4. Показать infra/redis.conf: appendonly yes, appendfsync always. В тесте Redis выдерживает также SIGKILL; срок сессии не продлевается.
  5. Показать evidence/expiry.json: отдельный API с TTL=2 возвращает 200 сразу и 401 после 2.3 s. Logout и неверный пароль покрыты интеграционными тестами.
  6. Показать evidence/failures.json: readiness и защищённый запрос дают 503 при отказе каждого хранилища; liveness остаётся 200, X-User-Id не даёт доступ.
  7. Показать evidence/explain.txt: 10 000 сообщений, индекс истории, начало/середина/конец. SQL читает 51 строку, API отдаёт 50 и формирует следующий cursor.

Что понимать в коде

app/api.py обрабатывает HTTP, аутентификацию, валидацию, request ID и ошибки. app/store.py выполняет SQL и операции Redis. app/security.py содержит KDF, разбор Basic/Bearer и подпись курсоров. app/migrate.py применяет миграции; migrations/001_initial.sql задаёт схему.

  • COMMIT: операция PostgreSQL завершена до HTTP 201. В стенде включены synchronous_commit и fsync; потеря самого диска или volume этим не покрывается.
  • Образ, контейнер, volume: образ содержит код, контейнер запускает процесс, volume хранит данные независимо от жизни контейнера. down сохраняет volumes, down --volumes удаляет учебные данные.
  • Сессии: Redis — источник истины для них. TTL отвечает за время жизни, AOF — за восстановление после рестарта. Flush/удаление volume уничтожит сессии; одного TTL недостаточно.
  • Basic и Bearer: Basic передаёт username:password в base64 при входе. Bearer — случайный ключ действующей серверной сессии для остальных запросов. Base64 не шифрует пароль.
  • Аутентификация и доступ: действительная сессия определяет пользователя, членство определяет доступ к конкретному чату. Чужой чат возвращает 404.
  • Хеш пароля: scrypt использует соль и затраты CPU/RAM. SHA-256 токена допустим для уже случайного 256-битного значения, но быстрый SHA-256 не заменяет password KDF.
  • Гонка username: проверка SELECT перед INSERT не гарантирует уникальность. Нужен UNIQUE в PostgreSQL; проигравший INSERT превращается в 409.
  • Rollback: INSERT чата и участников выполняются вместе. Ошибка второго участника отменяет первый INSERT, что проверяется прямым подсчётом строк.
  • Keyset: cursor хранит подписанную границу (created_at, id) и область чата. B-tree сразу переходит к нужному диапазону. OFFSET заставил бы пропускать предыдущие строки.
  • Конкурентная история: блокировка одной строки чата упорядочивает записи этого чата; разные чаты пишут независимо. Между страницами общего snapshot нет.
  • Отказы: ошибка зависимости даёт ограниченный 503, а не анонимный вход. Один Docker-host и одиночные хранилища не дают высокой доступности.

Остановка после защиты

docker compose --env-file .env stop
# Повторный запуск с прежними данными:
docker compose --env-file .env up -d --wait