23 lines
2.9 KiB
Markdown
23 lines
2.9 KiB
Markdown
## 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, динамические результаты новой версии не заявляются. Откат коммита возвращает прежний дефект.
|