forked from mtusi2026/mtusi2026lab2
Возвращать 401 вместо 500 при не-ASCII символах в заголовке Basic
This commit is contained in:
@@ -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` |
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
+3
-2
@@ -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(":")
|
||||
|
||||
@@ -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))
|
||||
|
||||
Reference in New Issue
Block a user