Files
mtusi2026lab2/openspec/specs/identification/spec.md
T
ricoromaandClaude Opus 5.5 7b775a29a9 chore: carry over lab 1 solution into lab 2 skeleton
Copy the committed lab 1 sources as-is: src/, student-tests/, bench/,
Dockerfile, docker-compose.yml, pyproject.toml, uv.lock,
.python-version, config_example.toml, AGENTS.md, CLAUDE.md, .claude/,
openspec/, .graphifyignore and KNOWN_ISSUES.md. Lab 1 evidence stays
in the lab 1 repository.

Merge the new skeleton files with own sections: Makefile (lab 2
targets plus own run, docker, bench and common targets), .gitignore,
.dockerignore and .env.example. Rename the image to
mtusi-messenger:lab2 and point AGENTS.md at lab 2.

The application is still the in-memory lab 1 implementation.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 22:11:46 +03:00

4.3 KiB
Raw Blame History

identification Specification

Purpose

Выбор текущего пользователя на лабе 1 через заголовок X-User-Id и порядок проверок «идентификация → доступ к ресурсу». Это учебная идентификация, а не аутентификация: любой клиент может выдать себя за другого. С лабы 2 её заменяет Bearer-сессия.

Requirements

Requirement: Защищённые эндпоинты требуют X-User-Id

Все эндпоинты, кроме POST /api/v1/users и health, SHALL требовать заголовок X-User-Id с UUID существующего пользователя. Этот пользователь SHALL считаться текущим для запроса.

Scenario: Корректный заголовок

  • WHEN клиент вызывает GET /api/v1/users/me с X-User-Id существующего пользователя
  • THEN ответ 200 с этим пользователем

Requirement: Отказ в идентификации — 401

Сервис SHALL отвечать 401 с code unauthorized, когда заголовок X-User-Id отсутствует, не является UUID или указывает на несуществующего пользователя. Эти три случая MUST давать одинаковый ответ и MUST NOT давать 400.

Scenario: Нет заголовка

  • WHEN клиент вызывает GET /api/v1/users/me без X-User-Id
  • THEN ответ 401 с code unauthorized

Scenario: Не UUID

  • WHEN X-User-Id равен not-a-uuid
  • THEN ответ 401 с code unauthorized

Scenario: Неизвестный пользователь

  • WHEN X-User-Id — корректный UUID, но такого пользователя нет
  • THEN ответ 401 с code unauthorized

Requirement: Идентификация раньше доступа и валидации

Идентификация SHALL проверяться раньше доступа к конкретному ресурсу и раньше проверки пути, query и полей тела. Исключение, согласованное с преподавателем 2026-09-26: тело, которое не разбирается как JSON, отклоняется с 400 до идентификации.

Scenario: Чужой чат без заголовка

  • WHEN клиент без X-User-Id запрашивает существующий чат
  • THEN ответ 401, а не 404

Scenario: Невалидное поле без заголовка

  • WHEN клиент без X-User-Id отправляет сообщение с {"text": ""}
  • THEN ответ 401, а не 400

Scenario: Битый JSON без заголовка

  • WHEN клиент без X-User-Id отправляет тело {bad
  • THEN ответ 400 с code invalid_request

Requirement: Схема идентификации в документации API

Документация, которую отдаёт сервис (/openapi.json и /docs), SHALL объявлять схему devUser так же, как contracts/openapi.json: apiKey в заголовке X-User-Id. Защищённые операции SHALL ссылаться на неё, публичные (POST /api/v1/users, health) MUST NOT. Объявление схемы MUST NOT менять ответы: без заголовка по-прежнему 401, а не 400 или 403.

Scenario: Кнопка Authorize в Swagger

  • WHEN разработчик открывает /docs
  • THEN доступна кнопка Authorize с полем X-User-Id, и введённое значение уходит заголовком в защищённые запросы

Scenario: Схема в openapi.json

  • WHEN клиент запрашивает /openapi.json
  • THEN components.securitySchemes.devUser совпадает с контрактом, у GET /api/v1/users/me security равно [{"devUser": []}], а у POST /api/v1/users security нет