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