Files
mtusi2026lab2/DEMO.md
ChernikovandClaude Opus 5.5 921ae002d6 ЛР 2 — БВТ2304 — Черников
PostgreSQL с версионируемыми миграциями, вход по Basic и Bearer-сессии в Valkey
(AOF), Argon2id, compose-стенд с секретами в файлах. Собственные тесты в
student-tests/, проверки инфраструктуры и EXPLAIN в scripts/, отчёт в REPORT.md,
результаты в evidence/, команды для показа в DEMO.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 12:58:54 +03:00

6.5 KiB
Raw Permalink Blame History

Шпаргалка для защиты — лабораторная 2

Команды по порядку сценария защиты из README. Подробности решения — в REPORT.md.

Shell: Git Bash в Windows или обычный терминал в Linux/macOS (в Linux вместо python — python3). Адрес — 127.0.0.1, а не localhost: в Windows localhost сначала пробует IPv6, и каждый запрос идёт около двух секунд.

0. Подготовка (один раз)

python scripts/init_secrets.py      # случайные пароли в secrets/, в Git не попадают
cp .env.example .env
URL=http://127.0.0.1:8080

# post <путь> [токен] — JSON со стандартного ввода: так кириллица уходит в UTF-8 и из Git Bash
post() { curl -s -X POST "$URL$1" -H 'Content-Type: application/json' ${2:+-H "Authorization: Bearer $2"} --data-binary @- -w '\nHTTP %{http_code}\n'; }
# get <путь> [токен]
get() { curl -s "$URL$1" ${2:+-H "Authorization: Bearer $2"} -w '\nHTTP %{http_code}\n'; }
# new <ПЕРЕМЕННАЯ> <путь> [токен] — как post, но ещё сохраняет id созданного объекта
new() { local r; r=$(post "$2" "$3"); echo "$r"; printf -v "$1" %s "$(echo "$r" | sed -nE 's/.*"id":"([^"]+)".*/\1/p' | head -1)"; }
# signin <ПЕРЕМЕННАЯ> <username> <password> — вход по Basic, токен сохраняется в переменную
signin() { local r; r=$(curl -s -X POST "$URL/api/v1/auth/sessions" -u "$2:$3" -w '\nHTTP %{http_code}\n'); echo "$r" | tail -1; printf -v "$1" %s "$(echo "$r" | sed -nE 's/.*"token":"([^"]+)".*/\1/p')"; }

1. Миграции на пустом volume, пользователи, вход, сообщение

docker compose down -v                    # ВНИМАНИЕ: удаляет все учебные данные (volumes)
docker compose up -d --build --wait       # сборка, миграции, ожидание healthy
docker compose logs migrate               # migration_applied 0001_schema, 0002_..., applied_now=2

new ALICE /api/v1/users <<< '{"username":"alice","display_name":"Алиса","password":"Alice-password-123"}'
new BOB   /api/v1/users <<< '{"username":"bob","display_name":"Боб","password":"Bob-password-12345"}'
new EVE   /api/v1/users <<< '{"username":"eve","display_name":"Ева","password":"Eve-password-12345"}'

signin TA alice Alice-password-123        # HTTP 201
signin TB bob Bob-password-12345
signin TE eve Eve-password-12345
curl -s -X POST "$URL/api/v1/auth/sessions" -u alice:wrong-password-1 -i | head -1   # 401: неверный пароль

new CHAT /api/v1/chats "$TA" <<< "{\"title\":\"Проект по ВНП\",\"member_ids\":[\"$ALICE\",\"$BOB\"]}"
post /api/v1/chats/$CHAT/messages "$TA" <<< '{"text":"Привет, Боб! 👋"}'
post /api/v1/chats/$CHAT/messages "$TB" <<< '{"text":"Привет, Алиса!"}'
get /api/v1/chats/$CHAT/messages "$TB"    # два сообщения, HTTP 200
get /api/v1/chats/$CHAT/messages "$TE"    # Ева не участник: HTTP 404
get /api/v1/users/me                      # без токена: HTTP 401
curl -s "$URL/api/v1/users/me" -H "X-User-Id: $ALICE" -w '\nHTTP %{http_code}\n'   # X-User-Id из lab1 больше не работает: 401

Данные в PostgreSQL:

docker compose exec postgres psql -U messenger -d messenger -c "SELECT username, left(password_hash, 30) FROM users"
docker compose exec postgres psql -U messenger -d messenger -c "SELECT * FROM schema_migrations"

2–3. Перезапуск API и всех хранилищ: тот же токен, те же данные

Публичный тест сохранности. Токен живёт только в памяти теста; хук перезапускает api, postgres и valkey, volumes остаются:

python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url $URL   # Windows
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=$URL                               # Linux/macOS

То же руками, с токеном Алисы из шага 1:

scripts/restart.cmd                       # в Linux: scripts/restart.sh
docker compose ps                         # STATUS «Up N seconds»: контейнеры действительно перезапущены
get /api/v1/chats/$CHAT/messages "$TA"    # те же два сообщения, тот же токен: HTTP 200
curl -s -X DELETE "$URL/api/v1/auth/sessions/current" -H "Authorization: Bearer $TA" -w 'HTTP %{http_code}\n'   # выход: 204
get /api/v1/users/me "$TA"                # после выхода: HTTP 401

Истечение сессии с коротким TTL (отдельная копия API с SESSION_TTL_SECONDS=2):

python scripts/lab2_checks.py --only expiry

4. Уровень «4»

Роль Valkey — хранилище сессий с TTL и AOF:

VK='valkey-cli --no-auth-warning -a "$(sed -n "s/^requirepass //p" /run/secrets/valkey_auth)"'
docker compose exec valkey sh -c "$VK --scan --pattern 'session:*' | head -3"    # ключи — sha256 от токенов
docker compose exec valkey sh -c "$VK CONFIG GET appendonly"                      # yes
docker compose exec valkey sh -c "$VK CONFIG GET appendfsync"                     # always

План SQL-запроса истории на 10 000+ сообщениях:

python scripts/explain_history.py         # Index Scan, ~5 буферов; без индекса — Seq Scan по всей таблице

Ошибка зависимости, пул и таймауты, гонка регистрации, откат создания чата:

python scripts/lab2_checks.py --only valkey-down postgres-down
python scripts/lab2_checks.py --only pool timeouts race rollback

Собственные тесты и конкурентный тест:

BASE_URL=$URL python -m unittest discover -s student-tests -v    # make student-test
BASE_URL=$URL python student-tests/race.py                       # make race

Остановка и уборка

docker compose stop                       # безопасная остановка, данные остаются в volumes
docker compose down                       # удалить контейнеры, volumes остаются
docker compose down -v                    # удалить ещё и все данные