Skip to content

[Auth] Миграция модуля авторизации и аутентификации на DDD #43

Closed

Description

@soorq

Контекст

Текущая реализация авторизации размыта между контроллерами и моделями базы данных. Это создает риски безопасности и затрудняет внедрение новых методов входа (например, OAuth2 или MFA). Необходимо выделить Auth в отдельный Bounded Context, инкапсулировать логику проверки прав и управления сессиями внутри доменного слоя.


Технические требования

  • Локация логики: src/modules/auth/
  • Инструменты: JWT/Opaque tokens, Argon2/BCrypt для хеширования, Redis для хранения сессий/Revocation list.
  • Логика работы:
    1. Domain Layer: Создание агрегата Account или Identity. Определение Value Objects: Email, PasswordHash, Role.
    2. Domain Services: Реализация PasswordHasherInterface и сервиса аутентификации, проверяющего инварианты (например, блокировка после N неудачных попыток).
    3. Application Layer: Команды LoginCommand, RefreshTokenCommand, RegisterCommand.
    4. Infrastructure Layer: Реализация IdentityRepository и адаптеров для работы с токенами.

Цель и критерии приемки (Definition of Done)

  • База: Созданы интерфейсы IdentityRepository и TokenProviderInterface. Выполнена миграция сущности пользователя в доменную модель.
  • Функционал: Логика регистрации и входа перенесена в Application Services. Добавлен механизм Domain Events для события UserAuthenticated.
  • Лимиты/SLA: Время хеширования пароля и генерации токена не должно превышать 200мс.
  • Интеграция: Обновлены конфиги безопасности. Все секреты (JWT_SECRET) вынесены в .env.

Важные указания

  • Производительность: Использование кэширования в Redis для проверки валидности токенов (Blacklist) во избежание лишних запросов к основной БД.
  • Ошибки: Выбрасывать специфичные исключения: InvalidCredentialsException, AccountLockedException, TokenExpiredException. Избегать утечки информации в сообщениях об ошибках (не уточнять, что именно неверно: логин или пароль).
  • Безопасность: Пароли никогда не должны покидать пределы доменного слоя в открытом виде. Реализовать атомарное обновление времени последнего входа.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationenhancementNew feature or request

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions