Files
mtusi2026lab2/REPORT.md
T
PoRATL ebd2e4a6a7 Добавить PostgreSQL и сессии для лабораторной 2.
Пароли хранятся как Argon2id, сессии переживают перезапуск базы.
2026-11-13 07:02:23 +03:00

5.6 KiB
Raw Blame History

Отчёт — лабораторная 2

  • Автор, группа: Лобашов Валентин, БПИ2303
  • Целевая оценка; выбранный трек 5, если нужен: 3
  • Commit/PR: ветка solution/БПИ2303-lobashov, https://gitea.privcloud.tech/PoRATL/mtusi2026lab2
  • Использованные источники, библиотеки и помощь ИИ: ASP.NET Core, Npgsql 9.0.4, Konscious.Security.Cryptography.Argon2 1.3.1, PostgreSQL 16.11, контракт репозитория. Реализацию и черновик отчёта подготовил ассистент Cursor.

Запуск из чистого clone

Нужны Docker Desktop и интернет для первой сборки. Образы: mcr.microsoft.com/dotnet/sdk:10.0.401, mcr.microsoft.com/dotnet/aspnet:10.0.12, postgres:16.11.

copy .env.example .env

В .env замените POSTGRES_PASSWORD на локальный пароль. Файл не коммитится. Затем:

docker compose --env-file .env up -d --build

Миграция src/Messenger/Migrations/001_init.sql применяется при старте API и повторно ничего не создаёт. Готовность: GET http://127.0.0.1:8080/health/ready возвращает {"status":"ok"}.

python tests/smoke.py --base-url http://127.0.0.1:8080
dotnet test src/Messenger.slnx

Перезапуск API и PostgreSQL без удаления volume:

sh scripts/restart.sh

На Windows этот .sh напрямую не запускается. Та же команда: docker compose --env-file .env restart postgres api.

Остановка без удаления данных: docker compose --env-file .env stop. Удаление учебных данных: docker compose --env-file .env down -v.

Архитектура и решения

Из lab1 перенесены пользователи, чаты, членство, сообщения, cursor и формат ошибок. Хранилище в памяти заменено на PostgreSQL. Redis не используется: для оценки 3 сессии лежат в PostgreSQL.

SESSION_STORE=postgres. DATABASE_URL задаёт Npgsql-строку внутри compose. DATABASE_URL_FILE из .env.example тоже читается, если переменной нет. SESSION_TTL_SECONDS по умолчанию 3600. APP_HOST, APP_PORT, APP_ENV те же, что в lab1.

Пароль хешируется Argon2id (память 19 МиБ, 2 итерации, parallelism 1). В ответе пользователя пароля нет. Токен сессии — 32 случайных байта. В базе хранится только SHA-256 токена, срок expires_at и revoked_at. Перезапуск срок не продлевает.

POST /auth/sessions принимает только Basic. Остальные защищённые маршруты принимают только Bearer. X-User-Id не даёт доступ и не подменяет сессию. Создание чата — одна транзакция: проверка участников, вставка чата и членства. Повторный username ловится уникальным ограничением и возвращает 409.

Доказательства критериев

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke python tests/smoke.py --base-url http://127.0.0.1:8080 PASS evidence/smoke.txt
Свои проверки входа, logout и пустого сообщения dotnet test src/Messenger.slnx 3 пройдено, 0 провалено evidence/dotnet-test.txt
Рестарт API и PostgreSQL сохраняет сессию и сообщение docker compose --env-file .env restart postgres api, затем тот же Bearer PASS, 1.558 с, сообщение на месте evidence/persistence.txt
Миграция при старте, логи без текста сообщений и пароля docker logs контейнера API migrations=True, утечек нет evidence/logs.txt

Проверялось 2026-11-13, Docker Desktop, compose-проект 2.

Эксперименты и отказы

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
docker compose restart postgres api тот же токен читает те же данные, volume не стирается /health/ready = 200, /users/me тот же пользователь, сообщение на месте около 1.6 с; подтверждённые данные сохранены

Ограничения и следующие шаги

Оценка 3 не включает Redis/Valkey, EXPLAIN и отдельную проверку недоступности кэша. Если PostgreSQL не отвечает, /health/ready и запросы к данным возвращают 503. Два процесса API в этой работе не запускаются: одна база уже общая, но горизонтальное масштабирование — лабораторная 3. scripts/restart.sh рассчитан на sh; на Windows его выполняет docker compose restart.