Українська
Команди, результати й правила
Крок 1. Команди й результат входу
Навіщо. Метод сервісу отримує команду – запис із тим, що надіслав клієнт, – і повертає DTO. Для автентифікації команди невеликі; результат успішного входу містить обидва токени з часом їхньої дії та власний профіль користувача, щоб клієнт міг одразу показати ім’я користувача без додаткового запиту.
Що зробити.
cs
using Chatex.Core.Users;
namespace Chatex.Core.Auth;
public sealed record RegisterCommand(string UserName, string Email, string Password, string DisplayName);
/// <param name="Login">User name or email.</param>
public sealed record LoginCommand(string Login, string Password);
public sealed record RefreshCommand(string RefreshToken);
/// <summary>Where a request came from; stored with refresh tokens so users can review their sessions.</summary>
public sealed record ClientInfo(string? UserAgent, string? IpAddress)
{
public static ClientInfo Unknown { get; } = new(null, null);
}
/// <summary>Tokens for a signed-in user. The client sends the access token on each request and the refresh token to renew it.</summary>
public sealed record AuthResult(
string AccessToken,
DateTimeOffset AccessTokenExpiresAt,
string RefreshToken,
DateTimeOffset RefreshTokenExpiresAt,
MyProfileDto User);LoginCommand.Loginприймає ім’я користувача або електронну адресу; сервіс розрізняє їх за символом@.ClientInfoописує, звідки надійшов запит (браузер та IP-адреса). Його зберігають разом із кожним токеном оновлення, щоб майбутня сторінка «активні сесії» могла їх перелічити.ClientInfo.Unknownобслуговує тести та внутрішні виклики.AuthResult– те, що API перетворює на свою відповідь: токен доступу потрапляє в тіло JSON, токен оновлення – у cookie (тема 13).
Крок 2. DTO користувача
Навіщо. AuthResult містить MyProfileDto – перший із DTO користувача. Усі вони живуть в одному файлі: власний профіль користувача (з електронною адресою), публічний профіль іншого користувача (із часом «востаннє онлайн») і короткий опис, що показується поруч із кожним повідомленням і в кожному списку учасників. Решту файлу використовує тема 9; створіть його повністю вже зараз.
Що зробити. Створіть папку Users:
cs
using Chatex.Data.Entities;
using Chatex.Data.Models;
namespace Chatex.Core.Users;
/// <summary>The signed-in user's own profile.</summary>
public sealed record MyProfileDto(
Guid Id,
string UserName,
string Email,
string DisplayName,
string? Bio,
bool HasAvatar,
DateTimeOffset CreatedAt);
/// <summary>Another user's public profile.</summary>
public sealed record UserDto(
Guid Id,
string UserName,
string DisplayName,
string? Bio,
bool HasAvatar,
DateTimeOffset? LastSeenAt);
/// <summary>Just enough to show a user next to a message or in a list.</summary>
public sealed record UserSummaryDto(Guid Id, string UserName, string DisplayName, bool HasAvatar);
public sealed record UpdateProfileCommand(string DisplayName, string? Bio);
public sealed record ChangePasswordCommand(string CurrentPassword, string NewPassword);
internal static class UserMappings
{
public static MyProfileDto ToMyProfileDto(this User user) => new(
user.Id,
user.UserName!,
user.Email!,
user.Profile?.DisplayName ?? user.UserName!,
user.Profile?.Bio,
user.Profile?.AvatarPath is not null,
user.CreatedAt);
public static UserDto ToDto(this User user) => new(
user.Id,
user.UserName!,
user.Profile?.DisplayName ?? user.UserName!,
user.Profile?.Bio,
user.Profile?.AvatarPath is not null,
user.LastSeenAt);
public static UserSummaryDto ToSummaryDto(this User user) => new(
user.Id,
user.UserName!,
user.Profile?.DisplayName ?? user.UserName!,
user.Profile?.AvatarPath is not null);
public static UserSummaryDto ToDto(this UserSummary user) =>
new(user.Id, user.UserName, user.DisplayName, user.AvatarPath is not null);
}HasAvatar– цеbool, а не шлях: шлях у сховищі – внутрішня деталь. Клієнт завантажує аватар із/api/users/{id}/avatar(тема 13).- Відображення – це методи розширення в
internal static class:user.ToMyProfileDto()добре читається, і ніхто поза Chatex.Core не може їх викликати. user.Profile?.DisplayName ?? user.UserName!– у користувача завжди є профіль, але якщо профіль не завантажено, ім’я користувача слугує розумною запасною відповіддю замість винятку.ToDto(this UserSummary user)відображаєUserSummary, який повертає запит списку чатів із теми 5.
Крок 3. Помилки, що нічого не розкривають
Навіщо. Помилки автентифікації – це тема безпеки. Якби вхід казав «такого користувача немає» для невідомого імені й «хибний пароль» для відомого, зловмисник міг би перевіряти, які імена користувачів або адреси існують. Chatex в обох випадках повертає однаковий invalid_credentials. А от помилки реєстрації, навпаки, мають бути конкретними: користувачеві потрібно знати, що ім’я зайняте.
Що зробити.
cs
using Chatex.Core.Common;
namespace Chatex.Core.Auth;
public static class AuthErrors
{
/// <summary>Deliberately vague: does not say whether the user exists.</summary>
public static Error InvalidCredentials { get; } =
Error.Unauthorized("invalid_credentials", "The user name, email or password is wrong.");
public static Error LockedOut { get; } =
Error.Unauthorized("locked_out", "Too many failed attempts. Try again later.");
public static Error InvalidRefreshToken { get; } =
Error.Unauthorized("invalid_refresh_token", "The session has expired. Sign in again.");
public static Error UserNameTaken { get; } =
Error.Conflict("user_name_taken", "This user name is already taken.");
public static Error EmailTaken { get; } =
Error.Conflict("email_taken", "An account with this email already exists.");
}ErrorKind.Unauthorized стає HTTP 401, Conflict – 409 (тема 12).
Крок 4. Перевіряльники
Навіщо. Форма реєстрації має чотири поля з чіткими правилами. Ім’я користувача відповідає правилу для псевдонімів із теми 7 (3–32 символи, спершу літера); відображуване ім’я має вміститися в стовпець із теми 4 (64 символи). Це обмеження належить профілю, тому живе в ProfileValidators у папці Users; тема 9 додає до того самого файлу перевіряльники профілю.
Що зробити. Спершу створіть клас із обмеженнями:
cs
namespace Chatex.Core.Users;
internal static class ProfileValidators
{
public const int MaxDisplayName = 64;
public const int MaxBio = 500;
}Потім перевіряльники двох команд автентифікації:
cs
using Chatex.Core.Common;
using Chatex.Core.Users;
using FluentValidation;
namespace Chatex.Core.Auth;
internal sealed class RegisterCommandValidator : AbstractValidator<RegisterCommand>
{
public RegisterCommandValidator()
{
RuleFor(c => c.UserName).NotEmpty().Handle(3, 32);
RuleFor(c => c.Email).NotEmpty().EmailAddress().MaximumLength(256);
RuleFor(c => c.Password).NotEmpty().MaximumLength(128);
RuleFor(c => c.DisplayName).NotEmpty().MaximumLength(ProfileValidators.MaxDisplayName);
}
}
internal sealed class LoginCommandValidator : AbstractValidator<LoginCommand>
{
public LoginCommandValidator()
{
RuleFor(c => c.Login).NotEmpty().MaximumLength(256);
RuleFor(c => c.Password).NotEmpty().MaximumLength(128);
}
}- Кожен перевіряльник – це клас
internal sealed, похідний відAbstractValidator<T>; правила оголошуються в конструкторі. - Правил пароля тут немає. Довжину й цифри перевіряє Identity (налаштований в
AddCore), тож джерело істини одне. Перевіряльник лише обмежує довжину 128 символами, щоб ніхто не міг змусити сервер хешувати мегабайт «пароля». - Жодне правило не каже «ім’я користувача вільне». Надійно відповісти на це може лише база даних; сервіс перетворює
DuplicateUserNameвід Identity наuser_name_taken.
Перевірка
dotnet build проходить успішно.