Archive the non-ASCII Basic rejection change
This commit is contained in:
+6
-1
@@ -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-регрессий только собраны. Там же обязательные проверки финального агента;
|
||||
|
||||
@@ -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» повторно не подтверждены.
|
||||
@@ -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": "<repo>",
|
||||
"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
|
||||
+2
@@ -1,2 +1,4 @@
|
||||
schema: spec-driven
|
||||
created: 2026-11-06
|
||||
archived: 2026-11-06
|
||||
lab: 3
|
||||
+1
-1
@@ -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.
|
||||
@@ -31,7 +31,7 @@
|
||||
|
||||
Сервис SHALL принимать `POST /api/v1/auth/sessions` только с заголовком `Authorization: Basic <base64(username:password)>` и без тела. Декодирование 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 <token>`; схема сравнивается без учёта регистра. Отсутствующий, неизвестный, истёкший и отозванный токен, а также `Basic` на этих endpoint SHALL давать `401` с кодом `unauthorized` и `WWW-Authenticate: Bearer realm="messenger"`. Заголовок `X-User-Id` SHALL игнорироваться: он не даёт доступа и не меняет владельца сессии. Аутентификация SHALL выполняться раньше проверки доступа к ресурсу и раньше валидации пути, параметров и тела.
|
||||
|
||||
Reference in New Issue
Block a user