From 8c9ec653ed9d0722bccecd4690def220a803c969 Mon Sep 17 00:00:00 2001 From: Artyom Date: Fri, 6 Nov 2026 02:20:30 +0300 Subject: [PATCH] Archive the non-ASCII Basic rejection change --- evidence/README.md | 7 +- evidence/review-non-ascii-basic/README.md | 71 +++++++++++++++++++ .../review-non-ascii-basic/archive-checks.txt | 52 ++++++++++++++ .../.openspec.yaml | 2 + .../design.md | 0 .../proposal.md | 0 .../specs/lab2-auth-sessions/spec.md | 0 .../tasks.md | 2 +- openspec/specs/lab2-auth-sessions/spec.md | 8 ++- 9 files changed, 139 insertions(+), 3 deletions(-) create mode 100644 evidence/review-non-ascii-basic/README.md create mode 100644 evidence/review-non-ascii-basic/archive-checks.txt rename openspec/changes/{reject-non-ascii-basic => archive/2026-11-06-reject-non-ascii-basic}/.openspec.yaml (58%) rename openspec/changes/{reject-non-ascii-basic => archive/2026-11-06-reject-non-ascii-basic}/design.md (100%) rename openspec/changes/{reject-non-ascii-basic => archive/2026-11-06-reject-non-ascii-basic}/proposal.md (100%) rename openspec/changes/{reject-non-ascii-basic => archive/2026-11-06-reject-non-ascii-basic}/specs/lab2-auth-sessions/spec.md (100%) rename openspec/changes/{reject-non-ascii-basic => archive/2026-11-06-reject-non-ascii-basic}/tasks.md (94%) diff --git a/evidence/README.md b/evidence/README.md index 4d45e705..4e74617f 100644 --- a/evidence/README.md +++ b/evidence/README.md @@ -1,7 +1,12 @@ -date: 2026-11-05T22:28:57.204523+00:00 commit: f591fa64e525679a31c9db7f942d36c789e1a12f (report documentation worktree) +date: 2026-11-06 commit: 7e19d4e33ee817bca0649f47c75bb0ff42972e52 (evidence index update) # Доказательства +Не-ASCII в Basic после третьего ревью — [review-non-ascii-basic/README.md](review-non-ascii-basic/README.md), +код `7e19d4e33ee817bca0649f47c75bb0ff42972e52`: 144 unit-теста offline, +четыре HTTP-регрессии только собраны. Обязательный прогон с PostgreSQL и через LB +передан финальному агенту; новых нагрузочных результатов этот этап не содержит. + NUL во входных строках после повторного ревью — [review-nul-inputs/README.md](review-nul-inputs/README.md), код `e66e2d7d685ef8cdef74b3104bd6b5550b01c0af`: 136 unit-тестов и 18 архитектурных проверок offline, 17 HTTP-регрессий только собраны. Там же обязательные проверки финального агента; diff --git a/evidence/review-non-ascii-basic/README.md b/evidence/review-non-ascii-basic/README.md new file mode 100644 index 00000000..8b4a7186 --- /dev/null +++ b/evidence/review-non-ascii-basic/README.md @@ -0,0 +1,71 @@ +date: 2026-11-06 commit: 7e19d4e33ee817bca0649f47c75bb0ff42972e52 + +# Не-ASCII в Basic — исправление третьего ревью + +Исходный snapshot: `d60e29221a553c62ee5dc27615c17fdaa6d27895`. +Исправление и регрессии: `7e19d4e33ee817bca0649f47c75bb0ff42972e52`. +Использовано существующее окружение Python 3.14.5. Docker, серверы, нагрузка, +установка окружений и публикация на этом этапе не выполнялись. + +## Причина и результат + +`Authorization: Basic` с байтом `0xff` превращается в Latin-1 строку; +`b64decode` требует ASCII и выбрасывает ValueError, который прежний обработчик +не перехватывал. Ограничение входа сверено через Context7 `/python/cpython` +с [документацией CPython](https://github.com/python/cpython/blob/main/Doc/library/base64.rst) +и воспроизведено в установленном Python 3.14.5. + +Парсер identity теперь проверяет ASCII закодированной части перед Base64. +Невалидный заголовок получает стандартный отказ; VerifyCredentials и endpoint +не вызываются. UTF-8 пароля внутри корректного Base64 сохраняется. + +- [На старом коде](baseline-regression.txt): 8 ожидаемых падений ValueError — + четыре варианта байтов в парсере и те же варианты через guard/RequestPipeline. + SHA `f7bfd1d4731baf70eef18d3f95a4a655128990ba` содержит только proposal поверх + исходного snapshot; новые тесты находились в рабочем дереве. +- [После исправления](offline-checks.txt): 144 unit-теста прошли. Восемь новых + регрессий проверяют `401`, Basic challenge, точное тело ошибки, X-заголовки и + отсутствие проверки credentials. Это прямой ASGI-вызов с подставными портами, + без HAProxy, Uvicorn, реального PostgreSQL или сетевого HTTP. +- Четыре новых API-сценария собраны через `--collect-only`, но не исполнены. + Они сравнивают ответ с неверным паролем и проверяют число сессий пользователя. +- `make check`, `make validate`, итоговый `make lint` и OpenSpec strict — PASS. + Первый lint потребовал форматирования SQLAlchemy-выражения в новом тесте; + исходный неуспех сохранён в журнале, затем Ruff/format/ty прошли. +- [Архивация и итоговая проверка](archive-checks.txt): спецификация синхронизирована, + OpenSpec strict — 14/14, активных changes нет; нормативные файлы и runner/state + не изменены. + +Журнал offline-проверок привязан к proposal SHA с явно обозначенным рабочим +деревом; последующий коммит исправления содержит проверенный код. Перед +коммитом тестовый SQLAlchemy-запрос был только переформатирован Ruff. +Схема, миграции, адаптеры SQL, зависимости и инфраструктура не менялись. + +## Обязательный финальный прогон + +Следующие проверки здесь **не выполнялись**. Финальный агент запускает их из +чистого clone итогового SHA в разрешённом собственном compose project, со +свободным HTTP-портом 18083, прочими host-портами 23000–23999 и +NO_PROXY/no_proxy для localhost,127.0.0.1,::1. + +1. `make student-test PYTEST_ARGS='-v student-tests/api/test_sessions.py'` — + все сценарии входа и сессий, включая четыре `test_non_ascii_basic_matches_wrong_password`: + байты `0x80`, `0xff`, UTF-8 `c3 a9` и `0xff` после корректного Base64; + одинаковые `401 unauthorized`, Basic challenge, JSON, X-заголовки, отсутствие новой сессии. +2. Через LB повторить байтовые заголовки `b'Basic \xff'` и остальные варианты + на `POST /api/v1/auth/sessions`; передавать их байтами, без предварительной + ASCII-валидации клиента. Сравнить тело с неверным паролем при одинаковом + `X-Request-Id`, зафиксировать обслужившие реплики и отсутствие `500`. + Корректный вход с UTF-8 паролем должен по-прежнему давать `201`. +3. `make student-test`, `make test`, + `make test-persistence ACTION_SCRIPT=scripts/restart.sh`, + `make test-failover ACTION_SCRIPT=scripts/stop-one.sh`, `make lb-check`, + `make retry-check` и `make test-faults` — общая регрессия финальной версии. +4. Сохраняются обязательства из [NUL-исправления](../review-nul-inputs/README.md) + и [исправлений кэша и HAProxy](../review-fixes/README.md), включая реальные + PostgreSQL/Valkey, HAProxy, rolling/failover и нагрузочные измерения трека «5». + +Секреты и сессионные токены в evidence не сохранять. После Docker-этапа +остановить только свои стенды без удаления постоянных volumes. Финальный +отчёт оформляет отдельный агент. Этот change исправляет ошибку минимума +уровня «3»; динамические критерии «3»/«4»/«5» повторно не подтверждены. diff --git a/evidence/review-non-ascii-basic/archive-checks.txt b/evidence/review-non-ascii-basic/archive-checks.txt new file mode 100644 index 00000000..51bb42a5 --- /dev/null +++ b/evidence/review-non-ascii-basic/archive-checks.txt @@ -0,0 +1,52 @@ +date: 2026-11-05T23:20:01.363146+00:00 commit: 7e19d4e33ee817bca0649f47c75bb0ff42972e52 +Documentation-only worktree; main spec manually synced and validated before archive. + +$ openspec archive reject-non-ascii-basic --yes --skip-specs +Task status: ✓ Complete +Skipping spec updates (--skip-specs flag provided). +Change 'reject-non-ascii-basic' archived as '2026-11-06-reject-non-ascii-basic'. +exit_code: 0 + +$ openspec validate --all --strict +- Validating... +✓ spec/lab1-event-publication +✓ spec/lab1-messenger-chats +✓ spec/lab1-messenger-history +✓ spec/lab1-messenger-identity +✓ spec/lab1-service-operability +✓ spec/lab2-auth-sessions +✓ spec/lab2-dependency-failures +✓ spec/lab2-history-index +✓ spec/lab2-persistent-storage +✓ spec/lab2-session-cache +✓ spec/lab3-failover-operations +✓ spec/lab3-idempotent-messages +✓ spec/lab3-load-balancing +✓ spec/lab3-scaling-cost +Totals: 14 passed, 0 failed (14 items) +exit_code: 0 + +$ openspec list --json +{ + "changes": [], + "root": { + "path": "", + "source": "nearest" + } +} +exit_code: 0 + +$ make lint +.venv/bin/ruff check src student-tests alembic scripts/probe.py scripts/limits.py scripts/scaling.py tools +All checks passed! +.venv/bin/ruff format --check src student-tests alembic scripts/probe.py scripts/limits.py scripts/scaling.py tools +113 files already formatted +.venv/bin/ty check src student-tests alembic +All checks passed! +exit_code: 0 + +$ git diff --check +exit_code: 0 + +$ git diff --exit-code d60e29221a553c62ee5dc27615c17fdaa6d27895 -- contracts tests README.md COURSE.md CONTRIBUTING.md .pipeline REPORT.md pyproject.toml uv.lock alembic infra compose.yaml +exit_code: 0 diff --git a/openspec/changes/reject-non-ascii-basic/.openspec.yaml b/openspec/changes/archive/2026-11-06-reject-non-ascii-basic/.openspec.yaml similarity index 58% rename from openspec/changes/reject-non-ascii-basic/.openspec.yaml rename to openspec/changes/archive/2026-11-06-reject-non-ascii-basic/.openspec.yaml index 8a94d769..c4b41703 100644 --- a/openspec/changes/reject-non-ascii-basic/.openspec.yaml +++ b/openspec/changes/archive/2026-11-06-reject-non-ascii-basic/.openspec.yaml @@ -1,2 +1,4 @@ schema: spec-driven created: 2026-11-06 +archived: 2026-11-06 +lab: 3 diff --git a/openspec/changes/reject-non-ascii-basic/design.md b/openspec/changes/archive/2026-11-06-reject-non-ascii-basic/design.md similarity index 100% rename from openspec/changes/reject-non-ascii-basic/design.md rename to openspec/changes/archive/2026-11-06-reject-non-ascii-basic/design.md diff --git a/openspec/changes/reject-non-ascii-basic/proposal.md b/openspec/changes/archive/2026-11-06-reject-non-ascii-basic/proposal.md similarity index 100% rename from openspec/changes/reject-non-ascii-basic/proposal.md rename to openspec/changes/archive/2026-11-06-reject-non-ascii-basic/proposal.md diff --git a/openspec/changes/reject-non-ascii-basic/specs/lab2-auth-sessions/spec.md b/openspec/changes/archive/2026-11-06-reject-non-ascii-basic/specs/lab2-auth-sessions/spec.md similarity index 100% rename from openspec/changes/reject-non-ascii-basic/specs/lab2-auth-sessions/spec.md rename to openspec/changes/archive/2026-11-06-reject-non-ascii-basic/specs/lab2-auth-sessions/spec.md diff --git a/openspec/changes/reject-non-ascii-basic/tasks.md b/openspec/changes/archive/2026-11-06-reject-non-ascii-basic/tasks.md similarity index 94% rename from openspec/changes/reject-non-ascii-basic/tasks.md rename to openspec/changes/archive/2026-11-06-reject-non-ascii-basic/tasks.md index e0f59526..72ea9d59 100644 --- a/openspec/changes/reject-non-ascii-basic/tasks.md +++ b/openspec/changes/archive/2026-11-06-reject-non-ascii-basic/tasks.md @@ -7,4 +7,4 @@ - [x] 2.1 Добавить HTTP-регрессию одинакового 401 с неверным паролем и отсутствия новой сессии; собрать её через pytest --collect-only без Docker. - [x] 2.2 Выполнить offline unit-тесты, make check, make validate, make lint и OpenSpec strict; сохранить evidence с SHA и командами. -- [ ] 2.3 Перечислить обязательные динамические проверки финального агента в evidence, синхронизировать спецификацию и архивировать change. +- [x] 2.3 Перечислить обязательные динамические проверки финального агента в evidence, синхронизировать спецификацию и архивировать change. diff --git a/openspec/specs/lab2-auth-sessions/spec.md b/openspec/specs/lab2-auth-sessions/spec.md index e379f907..e980acd7 100644 --- a/openspec/specs/lab2-auth-sessions/spec.md +++ b/openspec/specs/lab2-auth-sessions/spec.md @@ -31,7 +31,7 @@ Сервис 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 SHALL приводить к тому же `401 unauthorized`. +В соответствии с разделом «Идентификация и сессии» `contracts/README.md`, NUL в Basic username и не-ASCII символы в закодированной части Basic SHALL приводить к тому же `401 unauthorized`. #### Scenario: Успешный вход @@ -66,6 +66,12 @@ - **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`; сессия не создаётся + ### Requirement: Защищённые endpoint принимают только Bearer Все `/api/v1/*`, кроме `POST /api/v1/users` и `POST /api/v1/auth/sessions`, SHALL требовать `Authorization: Bearer `; схема сравнивается без учёта регистра. Отсутствующий, неизвестный, истёкший и отозванный токен, а также `Basic` на этих endpoint SHALL давать `401` с кодом `unauthorized` и `WWW-Authenticate: Bearer realm="messenger"`. Заголовок `X-User-Id` SHALL игнорироваться: он не даёт доступа и не меняет владельца сессии. Аутентификация SHALL выполняться раньше проверки доступа к ресурсу и раньше валидации пути, параметров и тела.