diff --git a/REPORT.md b/REPORT.md index 7c35e97..13448a7 100644 --- a/REPORT.md +++ b/REPORT.md @@ -161,13 +161,16 @@ Cursor — base64 от JSON `[область, created_at, id]` последне Перенесены: структура `src/`, формат ошибок и `X-Request-Id`, валидация JSON, cursor-пагинация, логирование без содержимого, Dockerfile (непривилегированный пользователь, healthcheck, корректная остановка по SIGTERM), собственные тесты. -Исправлено по замечанию к lab1: некорректный cursor мог вернуть 200 (посторонние символы в base64, неканоничные время и UUID); теперь он всегда даёт 400, проверка — тест `test_cursor_format_is_checked`. +Исправлено по замечаниям: + +- (к lab1) Некорректный cursor мог вернуть 200 (посторонние символы в base64, неканоничные время и UUID); теперь он всегда даёт 400, проверка — тест `test_cursor_format_is_checked`. +- (к lab2) `POST /api/v1/auth/sessions` с заголовком `Authorization: Basic é` возвращал 500: при не-ASCII символах `b64decode` бросает обычный `ValueError`, а перехватывались только `binascii.Error` и `UnicodeDecodeError`. Теперь в `parse_basic` (`src/security.py`) перехватывается `ValueError`, который покрывает все три случая, и ответ — 401 с `WWW-Authenticate: Basic`. Негативные тесты: `test_garbage_after_basic_is_401_not_500` (11 вариантов значения после `Basic`) и `test_garbage_token_is_401_not_500` (то же для Bearer). Изменено: хранилище в памяти заменено на PostgreSQL; `X-User-Id` заменён на пароль, Basic и Bearer; добавлены миграции, Redis, compose, проверка зависимостей в `/health/ready` и ответ 503. Строки теперь проверяются ещё и на символ NUL, который PostgreSQL не хранит. Контракт и публичные тесты не менялись. ## Доказательства критериев -Стенд: Apple M3 Pro, 11 CPU, 18 ГБ RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0, без ограничений CPU/RAM для контейнеров. Все файлы получены из чистого clone на пустых volumes, commit `6473fd0`. Файл `evidence/02-student-tests.txt` получен заново на commit `31530fc` после ужесточения проверки cursor. +Стенд: Apple M3 Pro, 11 CPU, 18 ГБ RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0, без ограничений CPU/RAM для контейнеров. Все файлы получены из чистого clone на пустых volumes, commit `6473fd0`. Файл `evidence/02-student-tests.txt` получен заново после исправлений по замечаниям (проверка cursor, разбор заголовка Basic). | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | @@ -175,7 +178,7 @@ Cursor — base64 от JSON `[область, created_at, id]` последне | 3: данные и сессии переживают рестарт API и хранилищ | `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | `PASS`; у контейнеров `postgres`, `redis`, `api` новое время старта, volumes те же | `evidence/03-persistence.txt` | | 3: таблицы, ключи, уникальность username, миграции с нуля | `make up` на пустом volume | `применена: 0001_init.sql`, smoke проходит | `evidence/01-up-and-smoke.txt`, `migrations/0001_init.sql` | | 3: создание чата атомарно | `make test-failures` (`test_transactions.py`) | после неудачного создания в `chats` 0 строк, после удачного — чат и 2 участника | `evidence/05-failures.txt` | -| 3: Basic только на входе, Bearer на остальном, срок жизни, отзыв, `X-User-Id` не даёт доступ | `make student-test` (`test_auth.py`) | 15 тестов `ok` | `evidence/02-student-tests.txt` | +| 3: Basic только на входе, Bearer на остальном, срок жизни, отзыв, `X-User-Id` не даёт доступ | `make student-test` (`test_auth.py`) | 17 тестов `ok` | `evidence/02-student-tests.txt` | | 3: пароли хешируются KDF | `test_password_is_stored_as_argon2id_hash` | hash в БД начинается с `$argon2id$` | `evidence/05-failures.txt` | | 3: миграции повторяются без дублирования | `docker compose run --rm migrate` | `уже применена: 0001_init.sql`, в `schema_migrations` одна строка, число строк в таблицах не изменилось | `evidence/03-persistence.txt`, `evidence/05-failures.txt` | | 3: secrets и volumes не в Git | `git ls-files \| grep -E "^\.env$\|secrets"` | пусто | `evidence/07-containers.txt` | diff --git a/evidence/02-student-tests.txt b/evidence/02-student-tests.txt index d75ee2d..43ae990 100644 --- a/evidence/02-student-tests.txt +++ b/evidence/02-student-tests.txt @@ -1,5 +1,5 @@ # Собственные тесты API -# дата: 2026-10-09T10:55Z, commit: 31530fc (после исправления проверки cursor) +# дата: 2026-10-09T21:41Z, после исправлений по замечаниям (проверка cursor, разбор заголовка Basic) # стенд: Apple M3 Pro, 11 CPU, 18 GB RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0 $ make student-test @@ -17,12 +17,14 @@ test_members_can_read_and_write (test_access.ForeignChatTest.test_members_can_re test_outsider_gets_404_everywhere (test_access.ForeignChatTest.test_outsider_gets_404_everywhere) ... ok test_outsider_message_is_not_saved (test_access.ForeignChatTest.test_outsider_message_is_not_saved) ... ok test_basic_is_not_accepted_on_business_endpoints (test_auth.BearerTest.test_basic_is_not_accepted_on_business_endpoints) ... ok +test_garbage_token_is_401_not_500 (test_auth.BearerTest.test_garbage_token_is_401_not_500) ... ok test_no_token (test_auth.BearerTest.test_no_token) ... ok test_token_is_checked_before_anything_else (test_auth.BearerTest.test_token_is_checked_before_anything_else) ... ok test_unknown_tokens (test_auth.BearerTest.test_unknown_tokens) ... ok test_x_user_id_does_not_change_identity (test_auth.BearerTest.test_x_user_id_does_not_change_identity) ... ok test_x_user_id_gives_no_access (test_auth.BearerTest.test_x_user_id_gives_no_access) ... ok test_colon_and_unicode_in_password (test_auth.LoginTest.test_colon_and_unicode_in_password) ... ok +test_garbage_after_basic_is_401_not_500 (test_auth.LoginTest.test_garbage_after_basic_is_401_not_500) ... ok test_login (test_auth.LoginTest.test_login) ... ok test_malformed_credentials (test_auth.LoginTest.test_malformed_credentials) ... ok test_token_is_opaque_and_unique (test_auth.LoginTest.test_token_is_opaque_and_unique) ... ok @@ -66,7 +68,7 @@ test_password_is_never_returned (test_validation.UserValidationTest.test_passwor test_password_length_limits (test_validation.UserValidationTest.test_password_length_limits) ... ok ---------------------------------------------------------------------- -Ran 60 tests in 1.798s +Ran 62 tests in 1.797s OK diff --git a/src/security.py b/src/security.py index 83b15d3..73d7baa 100644 --- a/src/security.py +++ b/src/security.py @@ -1,5 +1,4 @@ import base64 -import binascii from argon2 import PasswordHasher from argon2.exceptions import InvalidHashError, VerificationError @@ -28,7 +27,9 @@ def parse_basic(header): return None try: decoded = base64.b64decode(value.strip(), validate=True).decode("utf-8") - except (binascii.Error, UnicodeDecodeError): + except ValueError: + # три случая сразу: не ASCII в заголовке (сам ValueError), неверный base64 и байты не в UTF-8 + # (их исключения — подклассы ValueError) return None # двоеточие в пароле допустимо, поэтому делим только по первому username, colon, password = decoded.partition(":") diff --git a/student-tests/test_auth.py b/student-tests/test_auth.py index 4242f99..b63547b 100644 --- a/student-tests/test_auth.py +++ b/student-tests/test_auth.py @@ -50,6 +50,15 @@ class LoginTest(unittest.TestCase): headers = {"Authorization": header} if header else {} self.assert_basic_challenge(call("POST", "/api/v1/auth/sessions", headers=headers)) + def test_garbage_after_basic_is_401_not_500(self): + # значение заголовка приходит на сервер как latin-1, поэтому после Basic может оказаться не ASCII + values = ("\u00e9", "\u00e9\u00e9\u00e9=", "\u00ff\u00fe", "//46cHc=", "=", "====", "a", " ", "A" * 5000, "Og==", + "dXNlcjpwYXNz dXNlcjpwYXNz") + for value in values: + with self.subTest(value=ascii(value[:16])): + result = call("POST", "/api/v1/auth/sessions", headers={"Authorization": "Basic " + value}) + self.assert_basic_challenge(result) + def test_username_that_cannot_exist(self): for username in ("", "Has Space", "ab\u0000cd", "имя_кириллицей"): with self.subTest(username=username): @@ -81,6 +90,11 @@ class BearerTest(unittest.TestCase): with self.subTest(token=token[:8]): self.assert_bearer_challenge(call("GET", "/api/v1/users/me", user={"token": token})) + def test_garbage_token_is_401_not_500(self): + for token in ("\u00e9", "\u00ff\u00fe", "a b", "x" * 10000): + with self.subTest(token=ascii(token[:16])): + self.assert_bearer_challenge(call("GET", "/api/v1/users/me", user={"token": token})) + def test_basic_is_not_accepted_on_business_endpoints(self): headers = basic(self.alice["username"], self.alice["password"]) self.assert_bearer_challenge(call("GET", "/api/v1/users/me", headers=headers))