MadJax
dd36bbc425
Application mono-utilisateur : inscription unique, connexion par JWT (12 h), protection de toutes les routes de données, réinitialisation de mot de passe par email avec repli de journalisation, onboarding réorganisé en deux étapes (inscription → connexion → profil + véhicule). Backend (SchotzIadKmTracker.Api) : - Entités Compte (singleton) et ResetPasswordToken + migration AjoutAuthentification. - Hachage PasswordHasher, JwtService (HS256, durée configurable), IEmailService (MailKit + repli LoggingEmailService selon Smtp:Host). - AuthService (register 409 si compte existant, login 401 générique, forgot-password non-divulgation, reset à usage unique + expiration), AuthController (5 endpoints publics), DTOs + validateurs FluentValidation. - Sécurité pipeline : JwtBearer + filtre d'autorisation global, UseAuthentication avant UseAuthorization ; /health et /api/auth/* publics. Frontend (schotziad-km-tracker, zoneless + signals) : - AuthService (localStorage), authInterceptor (Bearer + purge/redirection 401), authGuard, écrans Login/Register/ForgotPassword/ResetPassword, routes publiques et protection [authGuard, profilConfigureGuard]. Configuration : .env.example et docker-compose.yml (JWT__SecretKey, durées, Smtp__*). Tests : 54 tests backend (propriétés FsCheck P1–P14, exemples, intégration WebApplicationFactory) + tests frontend (AuthService, authGuard, authInterceptor, ResetPasswordComponent). Suite complète au vert. Spec : .kiro/specs/authentification (requirements, design, tasks).
53 lines
2.6 KiB
C#
53 lines
2.6 KiB
C#
using SchotzIadKmTracker.Api.Models.DTOs;
|
|
|
|
namespace SchotzIadKmTracker.Api.Services;
|
|
|
|
/// <summary>
|
|
/// Logique métier d'authentification de l'application mono-utilisateur :
|
|
/// existence du compte, inscription, connexion, demande et application de la
|
|
/// réinitialisation du mot de passe.
|
|
/// </summary>
|
|
public interface IAuthService
|
|
{
|
|
/// <summary>
|
|
/// Indique si un compte existe déjà, afin d'orienter le frontend (inscription vs connexion).
|
|
/// </summary>
|
|
/// <param name="ct">Jeton d'annulation de l'opération.</param>
|
|
/// <returns><c>true</c> s'il existe au moins un compte, <c>false</c> sinon (Exigences 1.2, 9.1).</returns>
|
|
Task<bool> CompteExisteAsync(CancellationToken ct);
|
|
|
|
/// <summary>
|
|
/// Inscrit le compte unique. Lève <see cref="Exceptions.CompteDejaExistantException"/>
|
|
/// si un compte existe déjà (Exigence 1).
|
|
/// </summary>
|
|
/// <param name="dto">Email et mot de passe fournis à l'inscription.</param>
|
|
/// <param name="ct">Jeton d'annulation de l'opération.</param>
|
|
Task RegisterAsync(RegisterDto dto, CancellationToken ct);
|
|
|
|
/// <summary>
|
|
/// Authentifie le compte et émet un jeton JWT. Lève
|
|
/// <see cref="Exceptions.IdentifiantsInvalidesException"/> si les identifiants sont invalides (Exigence 2).
|
|
/// </summary>
|
|
/// <param name="dto">Identifiants de connexion (email et mot de passe).</param>
|
|
/// <param name="ct">Jeton d'annulation de l'opération.</param>
|
|
/// <returns>Le jeton JWT émis et sa date d'expiration.</returns>
|
|
Task<LoginResultDto> LoginAsync(LoginDto dto, CancellationToken ct);
|
|
|
|
/// <summary>
|
|
/// Traite une demande de réinitialisation de mot de passe. Par principe de non-divulgation,
|
|
/// se termine toujours sans exception, que l'email corresponde ou non à un compte (Exigence 6.6).
|
|
/// </summary>
|
|
/// <param name="dto">Email pour lequel demander la réinitialisation.</param>
|
|
/// <param name="ct">Jeton d'annulation de l'opération.</param>
|
|
Task ForgotPasswordAsync(ForgotPasswordDto dto, CancellationToken ct);
|
|
|
|
/// <summary>
|
|
/// Réinitialise le mot de passe à partir d'un jeton de réinitialisation. Lève
|
|
/// <see cref="Exceptions.LienResetInvalideException"/> si le jeton est inconnu ou déjà utilisé,
|
|
/// <see cref="Exceptions.LienResetExpireException"/> s'il a expiré (Exigence 7).
|
|
/// </summary>
|
|
/// <param name="dto">Jeton de réinitialisation et nouveau mot de passe.</param>
|
|
/// <param name="ct">Jeton d'annulation de l'opération.</param>
|
|
Task ResetPasswordAsync(ResetPasswordDto dto, CancellationToken ct);
|
|
}
|