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

120 lines
6.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Шпаргалка для защиты — лабораторная 2
Команды по порядку сценария защиты из README. Подробности решения — в [REPORT.md](REPORT.md).
Shell: **Git Bash** в Windows или обычный терминал в Linux/macOS (в Linux вместо `python` — `python3`).
Адрес — `127.0.0.1`, а не `localhost`: в Windows `localhost` сначала пробует IPv6, и каждый запрос идёт около двух секунд.
## 0. Подготовка (один раз)
```sh
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, пользователи, вход, сообщение
```sh
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:
```sh
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 остаются:
```sh
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:
```sh
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`):
```sh
python scripts/lab2_checks.py --only expiry
```
## 4. Уровень «4»
Роль Valkey — хранилище сессий с TTL и AOF:
```sh
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+ сообщениях:
```sh
python scripts/explain_history.py # Index Scan, ~5 буферов; без индекса — Seq Scan по всей таблице
```
Ошибка зависимости, пул и таймауты, гонка регистрации, откат создания чата:
```sh
python scripts/lab2_checks.py --only valkey-down postgres-down
python scripts/lab2_checks.py --only pool timeouts race rollback
```
Собственные тесты и конкурентный тест:
```sh
BASE_URL=$URL python -m unittest discover -s student-tests -v # make student-test
BASE_URL=$URL python student-tests/race.py # make race
```
## Остановка и уборка
```sh
docker compose stop # безопасная остановка, данные остаются в volumes
docker compose down # удалить контейнеры, volumes остаются
docker compose down -v # удалить ещё и все данные
```