Українська
Кінцеві точки автентифікації
Крок 1. Де браузер зберігає токен оновлення
Навіщо. У темі 8 створено два токени. Токен доступу живе 15 хвилин; застосунок Angular тримає його в пам’яті й надсилає в заголовку Authorization. Токен оновлення живе 30 днів і значно цінніший. Якби скрипти сторінки могли його прочитати, єдина помилка міжсайтового скриптингу дала б зловмисникові змогу красти 30-денні сесії.
Тому токен оновлення взагалі не потрапляє до JavaScript. Сервер кладе його в cookie із чотирма захисними атрибутами:
HttpOnly– скрипти сторінки не можуть прочитати cookie;Secure– cookie надсилається лише через HTTPS (дляlocalhostбраузери роблять виняток);SameSite=Strict– браузер не надсилає cookie із запитами, які почали інші сайти, а це блокує міжсайтову підробку запитів;Path=/api/auth– cookie надсилається лише до кінцевих точок автентифікації, а не з кожним запитом до API.
Що зробити.
cs
using Chatex.Core.Auth;
namespace Chatex.Api.Infrastructure;
/// <summary>
/// The refresh token lives in an HttpOnly cookie that only the auth endpoints receive, so page scripts never see it.
/// SameSite=Strict keeps other sites from sending it along.
/// </summary>
internal static class RefreshTokenCookie
{
public const string Name = "chatex_refresh";
public const string Path = "/api/auth";
public static void Set(HttpResponse response, AuthResult auth) =>
response.Cookies.Append(Name, auth.RefreshToken, Options(auth.RefreshTokenExpiresAt));
public static string? Read(HttpRequest request) =>
request.Cookies.TryGetValue(Name, out var token) && !string.IsNullOrEmpty(token) ? token : null;
public static void Clear(HttpResponse response) => response.Cookies.Delete(Name, Options(expires: null));
private static CookieOptions Options(DateTimeOffset? expires) => new()
{
HttpOnly = true,
Secure = true,
SameSite = SameSiteMode.Strict,
Path = Path,
Expires = expires,
IsEssential = true,
};
}Clear видаляє cookie, надсилаючи його знову з датою спливу в минулому; атрибути мають збігатися з початковими, інакше браузер збереже старе cookie.
Крок 2. Кінцеві точки
Навіщо. П’ять кінцевих точок обгортають сервіс автентифікації. Чотири з них анонімні – не можна бути авторизованим, поки входиш, – а п’ята, «вийти скрізь», вимагає токена. JSON-відповідь на успішний вхід несе токен доступу й профіль; токен оновлення йде в cookie.
Що зробити. Створіть папку Endpoints:
cs
using System.Security.Claims;
using Chatex.Api.Contracts;
using Chatex.Api.Infrastructure;
using Chatex.Core.Auth;
using Chatex.Core.Common;
using Microsoft.AspNetCore.Http.HttpResults;
namespace Chatex.Api.Endpoints;
internal static class AuthEndpoints
{
public static void MapAuthEndpoints(this IEndpointRouteBuilder routes)
{
var group = routes.MapGroup("/auth").WithTags("Auth");
group.MapPost("/register", RegisterAsync).AllowAnonymous().WithName("Register")
.WithSummary("Creates an account and signs it in.");
group.MapPost("/login", LoginAsync).AllowAnonymous().WithName("Login")
.WithSummary("Signs in with a user name or email.");
group.MapPost("/refresh", RefreshAsync).AllowAnonymous().WithName("Refresh")
.WithSummary("Swaps the refresh token cookie for a new access token and cookie.");
group.MapPost("/logout", LogoutAsync).AllowAnonymous().WithName("Logout")
.WithSummary("Ends the session of the refresh token cookie.");
group.MapPost("/logout-all", LogoutAllAsync).WithName("LogoutAll")
.WithSummary("Ends every session of the signed-in user.");
}
private static async Task<Results<Ok<AuthResponse>, ProblemHttpResult>> RegisterAsync(
RegisterCommand command, IAuthService auth, HttpContext context, CancellationToken cancellationToken) =>
SignIn(await auth.RegisterAsync(command, context.GetClientInfo(), cancellationToken), context.Response);
private static async Task<Results<Ok<AuthResponse>, ProblemHttpResult>> LoginAsync(
LoginCommand command, IAuthService auth, HttpContext context, CancellationToken cancellationToken) =>
SignIn(await auth.LoginAsync(command, context.GetClientInfo(), cancellationToken), context.Response);
private static async Task<Results<Ok<AuthResponse>, ProblemHttpResult>> RefreshAsync(
IAuthService auth, HttpContext context, CancellationToken cancellationToken)
{
var token = RefreshTokenCookie.Read(context.Request);
var result = token is null
? AuthErrors.InvalidRefreshToken
: await auth.RefreshAsync(new RefreshCommand(token), context.GetClientInfo(), cancellationToken);
if (!result.IsSuccess)
{
RefreshTokenCookie.Clear(context.Response);
}
return SignIn(result, context.Response);
}
private static async Task<Results<NoContent, ProblemHttpResult>> LogoutAsync(
IAuthService auth, HttpContext context, CancellationToken cancellationToken)
{
var token = RefreshTokenCookie.Read(context.Request);
var result = token is null ? Result.Success : await auth.LogoutAsync(new RefreshCommand(token), cancellationToken);
RefreshTokenCookie.Clear(context.Response);
return result.ToNoContent();
}
private static async Task<Results<NoContent, ProblemHttpResult>> LogoutAllAsync(
ClaimsPrincipal user, IAuthService auth, HttpResponse response, CancellationToken cancellationToken)
{
var result = await auth.LogoutAllAsync(user.GetUserId(), cancellationToken);
if (result.IsSuccess)
{
RefreshTokenCookie.Clear(response);
}
return result.ToNoContent();
}
private static Results<Ok<AuthResponse>, ProblemHttpResult> SignIn(Result<AuthResult> result, HttpResponse response)
{
if (!result.IsSuccess)
{
return result.Error.ToProblem();
}
RefreshTokenCookie.Set(response, result.Value);
return TypedResults.Ok(AuthResponse.From(result.Value));
}
}MapAuthEndpoints– метод розширення дляIEndpointRouteBuilder.Program.csвикличе його на групі, що вже має префікс/apiі вимагає авторизації для всього;AllowAnonymous()знімає цю вимогу для чотирьох кінцевих точок.WithTags,WithName,WithSummary– метадані для OpenAPI: кінцеві точки з’являються згрупованими під «Auth», кожна з ідентифікатором операції та описом.- Параметри:
RegisterCommand commandчитається з тіла JSON,IAuthService auth– з упровадження залежностей,HttpContext contextдає доступ до запиту й відповіді. SignInспільний для реєстрації, входу й оновлення: у разі успіху встановлює cookie і повертає200зAuthResponse, у разі невдачі повертає проблему.RefreshAsyncчитає токен із cookie, а не з тіла. Невдале оновлення також очищає cookie, тож браузер із мертвим токеном перестає його надсилати.LogoutAsyncзавжди очищає cookie, навіть без чинного токена.
У темі 13 цей файл отримає ще один виклик: обмеження частоти запитів для всієї групи.
Перевірка
dotnet build проходить успішно.