diff --git a/openspec/changes/reject-non-ascii-basic/.openspec.yaml b/openspec/changes/reject-non-ascii-basic/.openspec.yaml new file mode 100644 index 00000000..8a94d769 --- /dev/null +++ b/openspec/changes/reject-non-ascii-basic/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-11-06 diff --git a/openspec/changes/reject-non-ascii-basic/design.md b/openspec/changes/reject-non-ascii-basic/design.md new file mode 100644 index 00000000..659afff1 --- /dev/null +++ b/openspec/changes/reject-non-ascii-basic/design.md @@ -0,0 +1,22 @@ +## 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, динамические результаты новой версии не заявляются. Откат коммита возвращает прежний дефект. diff --git a/openspec/changes/reject-non-ascii-basic/proposal.md b/openspec/changes/reject-non-ascii-basic/proposal.md new file mode 100644 index 00000000..3f16a9c9 --- /dev/null +++ b/openspec/changes/reject-non-ascii-basic/proposal.md @@ -0,0 +1,27 @@ +## Why + +Ревью snapshot `d60e29221a553c62ee5dc27615c17fdaa6d27895` выявило необработанный ValueError при `Authorization: Basic` с не-ASCII байтами. Offline-вызовы парсера и guard подтвердили исключение вместо контрактного одинакового `401`. + +## What Changes + +- Проверять ASCII закодированной части Basic перед декодированием Base64. +- Добавить регрессии для не-ASCII заголовков, стандартного отказа и отсутствия вызова VerifyCredentials. +- Подготовить HTTP-регрессию для финального агента и сохранить offline-доказательства отдельно от нагрузочных результатов. + +## Capabilities + +### New Capabilities + +Нет. + +### Modified Capabilities + +- `lab2-auth-sessions`: не-ASCII в закодированной части Basic получает одинаковый `401 unauthorized` с Basic challenge. + +## Impact + +Уровень «3»: сохранение минимума lab2 из `README.md`, раздел «Идентификация и сессии» `contracts/README.md`, строка «Негативные случаи и заголовки, гонки, миграции» в `REPORT.md`. Затронуты только HTTP-граница identity, собственные тесты, OpenSpec и evidence. Динамические проверки выполняет финальный агент; этот этап использует существующее окружение и offline-проверки. + +## Non-goals + +Возможности лаб 4–7 из Out of scope в `openspec/config.yaml`, изменение SQLAlchemy/Alembic, инфраструктуры, зависимостей, нормативных файлов, итогового отчёта и публикация. diff --git a/openspec/changes/reject-non-ascii-basic/specs/lab2-auth-sessions/spec.md b/openspec/changes/reject-non-ascii-basic/specs/lab2-auth-sessions/spec.md new file mode 100644 index 00000000..757bca84 --- /dev/null +++ b/openspec/changes/reject-non-ascii-basic/specs/lab2-auth-sessions/spec.md @@ -0,0 +1,46 @@ +## MODIFIED Requirements + +### Requirement: Вход по Basic выдаёт сессию + +Сервис SHALL принимать `POST /api/v1/auth/sessions` только с заголовком `Authorization: Basic ` и без тела. Декодирование base64 SHALL быть строгим, разделителем SHALL служить первое двоеточие, пароль SHALL декодироваться как UTF-8. При верных учётных данных ответ SHALL быть `201` с телом `{"token","token_type":"Bearer","expires_at","user"}`, где `token` — непрозрачная случайная строка не короче 32 символов с энтропией не менее 256 бит, `expires_at` — RFC 3339 UTC с `Z`, а `user` совпадает с ответом регистрации. Неверный пароль, неизвестный `username`, отсутствующий и испорченный заголовок SHALL давать одинаковый `401` с кодом `unauthorized` и заголовком `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"`. + +В соответствии с разделом «Идентификация и сессии» `contracts/README.md`, NUL в Basic username и не-ASCII символы в закодированной части Basic SHALL приводить к тому же `401 unauthorized`. + +#### Scenario: Успешный вход + +- **WHEN** зарегистрированный пользователь отправляет верные `username:password` в `Basic` +- **THEN** ответ `201`, тело соответствует схеме `Session`, `token_type` равен `Bearer` +- **AND** `user` побайтно равен телу ответа его регистрации, `expires_at` в будущем + +#### Scenario: Неверный пароль и неизвестный пользователь неразличимы + +- **WHEN** приходит `Basic` с неверным паролем существующего пользователя или с несуществующим `username` +- **THEN** оба ответа — `401` с кодом `unauthorized` и `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"` +- **AND** тела ответов различаются только `request_id` + +#### Scenario: Испорченный заголовок Basic + +- **WHEN** заголовок отсутствует, содержит другую схему, невалидный base64 или строку без двоеточия +- **THEN** ответ `401` с тем же заголовком `WWW-Authenticate: Basic ...` + +#### Scenario: Двоеточие в пароле + +- **WHEN** пароль пользователя содержит двоеточие и он входит по `Basic` +- **THEN** ответ `201`: разделителем служит первое двоеточие + +#### Scenario: Тело запроса при входе + +- **WHEN** запрос с верным `Basic` содержит тело +- **THEN** ответ `400` с кодом `invalid_request`, сессия не создаётся + +#### Scenario: Username с NUL + +- **WHEN** в `POST /api/v1/auth/sessions` передан корректный Base64 от username с NUL и пароля +- **THEN** ответ `401` с `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"`; тело `{"error":{"code":"unauthorized","message":...,"request_id":...}}` совпадает с ошибкой неверного пароля, кроме `request_id` +- **AND** ответ содержит непустые `X-Instance-Id` и `X-Request-Id`, совпадающий с `error.request_id` + +#### Scenario: Не-ASCII в закодированной части Basic + +- **WHEN** `POST /api/v1/auth/sessions` получает `Authorization` с не-ASCII байтами после `Basic `, в том числе `0xff` +- **THEN** ответ `401` с `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"`; тело `{"error":{"code":"unauthorized","message":...,"request_id":...}}` совпадает с ошибкой неверного пароля, кроме `request_id` +- **AND** ответ содержит непустой `X-Instance-Id` и `X-Request-Id`, совпадающий с `error.request_id`; сессия не создаётся diff --git a/openspec/changes/reject-non-ascii-basic/tasks.md b/openspec/changes/reject-non-ascii-basic/tasks.md new file mode 100644 index 00000000..5f797ea2 --- /dev/null +++ b/openspec/changes/reject-non-ascii-basic/tasks.md @@ -0,0 +1,10 @@ +## 1. Identity — минимум уровня «3» + +- [ ] 1.1 Добавить offline-регрессии не-ASCII Basic для парсера и ASGI-конвейера; сохранить ожидаемые падения старого кода. +- [ ] 1.2 Отклонять не-ASCII до декодирования Base64; проверить стандартный 401, заголовки, тело и отсутствие вызова VerifyCredentials через unit-тесты. + +## 2. Проверки и передача + +- [ ] 2.1 Добавить HTTP-регрессию одинакового 401 с неверным паролем и отсутствия новой сессии; собрать её через pytest --collect-only без Docker. +- [ ] 2.2 Выполнить offline unit-тесты, make check, make validate, make lint и OpenSpec strict; сохранить evidence с SHA и командами. +- [ ] 2.3 Перечислить обязательные динамические проверки финального агента в evidence, синхронизировать спецификацию и архивировать change.