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>
6.5 KiB
Шпаргалка для защиты — лабораторная 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 # удалить ещё и все данные