Files
mtusi2026lab2/openspec/changes/reject-non-ascii-basic/design.md
T

2.9 KiB
Raw Blame History

Context

См. proposal.md. HTTP-заголовки преобразуются из байтов через Latin-1; b64decode принимает строку только из ASCII. Context7 /python/cpython подтверждает это ограничение; существующий Python 3.14.5 воспроизводит ValueError на Basic \xff до VerifyCredentials.

Goals / Non-Goals

Получать стандартный отказ до проверки credentials. Сохранить строгий Base64, UTF-8 пароля, первое двоеточие как разделитель и прежнюю проверку username. Схема заголовка остаётся регистронезависимой.

Decisions

  1. HTTP-граница identity проверяет encoded.isascii() вместе со схемой. Явная проверка выражает ограничение входа и не требует расширять перехват исключений на весь ValueError. Она выполняется до strip, чтобы парсер не принимал не-ASCII пробел как часть Base64. Общая нормализация HTTP-заголовков не меняется.
  2. Guard и RequestPipeline сохраняют существующий путь 401 unauthorized с Basic challenge, телом ошибки и обоими X-заголовками. Проверки используют байтовые заголовки и подставной VerifyCredentials, подтверждая отсутствие его вызова. Полный HTTP-тест сравнивает ответ с неверным паролем и передаётся финальному агенту.
  3. Новых портов и зависимостей между зонами нет. UserDirectory, IdentityUnitOfWork, PostgreSQL-адаптеры, Valkey и сборка DI прежние. shared, SQL, миграции и инфраструктура не требуют изменений.

Risks / Trade-offs

  • Offline ASGI-вызов не проверяет HAProxy/Uvicorn и реальную БД → отдельный обязательный прогон через LB и интеграционные тесты перечисляются в evidence.
  • Проверка ASCII могла бы ошибочно запретить Unicode-пароль → существующая регрессия UTF-8 пароля остаётся в unit-наборе; ограничивается только Base64-представление.

Migration Plan

Замена кода без миграции данных. Прежние измерения сохраняют свой SHA, динамические результаты новой версии не заявляются. Откат коммита возвращает прежний дефект.