Українська
Обмеження частоти запитів
Крок 1. Навіщо стримувати вхід
Навіщо. Блокування облікового запису з теми 8 зупиняє добір пароля до одного облікового запису: п’ять хибних спроб його блокують. Воно не зупиняє зловмисника, який пробує один поширений пароль на тисячах облікових записів, ані скрипт, що масово реєструє облікові записи. Такі атаки надходять з небагатьох IP-адрес багатьма запитами. Обмежувач частоти запитів (rate limiter) ASP.NET Core рахує запити за розділом – тут за IP-адресою клієнта – і відхиляє ті, що перевищують ліміт.
Chatex стримує лише анонімні кінцеві точки автентифікації: 20 запитів з однієї IP-адреси за 60 секунд. Справжній користувач входить кілька разів на день; звичайне API, яким користуються авторизовані користувачі, не стримується.
Крок 2. Політика
Що зробити.
cs
using System.ComponentModel.DataAnnotations;
using System.Globalization;
using System.Threading.RateLimiting;
using Microsoft.AspNetCore.RateLimiting;
using Microsoft.Extensions.Options;
namespace Chatex.Api.Infrastructure;
internal sealed class RateLimitingOptions
{
public const string Section = "RateLimiting";
/// <summary>Requests a client IP may make to the auth endpoints per window.</summary>
[Range(1, 1_000_000)]
public int AuthPermitLimit { get; set; } = 20;
[Range(1, 3600)]
public int AuthWindowSeconds { get; set; } = 60;
}
/// <summary>
/// Throttles the anonymous auth endpoints per client IP, so passwords cannot be guessed across many accounts and
/// accounts cannot be created in bulk. Behind Nginx the IP comes from <c>X-Forwarded-For</c> (UseForwardedHeaders).
/// </summary>
internal static class RateLimiting
{
public const string AuthPolicy = "auth";
public const string TooManyRequestsCode = "too_many_requests";
public static IServiceCollection AddChatexRateLimiting(this IServiceCollection services)
{
services.AddOptions<RateLimitingOptions>()
.BindConfiguration(RateLimitingOptions.Section)
.ValidateDataAnnotations()
.ValidateOnStart();
services.AddRateLimiter(o =>
{
o.RejectionStatusCode = StatusCodes.Status429TooManyRequests;
o.OnRejected = WriteRejectionAsync;
});
services.AddOptions<RateLimiterOptions>()
.Configure<IOptions<RateLimitingOptions>>((limiter, options) =>
{
var settings = options.Value;
limiter.AddPolicy(AuthPolicy, context => RateLimitPartition.GetFixedWindowLimiter(
context.Connection.RemoteIpAddress?.ToString() ?? "unknown",
_ => new FixedWindowRateLimiterOptions
{
PermitLimit = settings.AuthPermitLimit,
Window = TimeSpan.FromSeconds(settings.AuthWindowSeconds),
QueueLimit = 0,
}));
});
return services;
}
private static async ValueTask WriteRejectionAsync(OnRejectedContext context, CancellationToken cancellationToken)
{
var http = context.HttpContext;
if (context.Lease.TryGetMetadata(MetadataName.RetryAfter, out var retryAfter))
{
http.Response.Headers.RetryAfter = ((int)Math.Ceiling(retryAfter.TotalSeconds)).ToString(CultureInfo.InvariantCulture);
}
var problems = http.RequestServices.GetRequiredService<IProblemDetailsService>();
await problems.WriteAsync(new ProblemDetailsContext
{
HttpContext = http,
ProblemDetails =
{
Status = StatusCodes.Status429TooManyRequests,
Detail = "Too many requests. Try again later.",
Extensions = { [ResultHttpExtensions.CodeExtension] = TooManyRequestsCode },
},
});
}
}RateLimitingOptionsробить ліміт налаштовуваним (тести підвищують або знижують його) і перевіреним під час запуску.- Обмежувач із фіксованим вікном для кожної IP: щонайбільше
PermitLimitзапитів за вікно, далі відхилення до кінця вікна.QueueLimit = 0відхиляє одразу, а не змушує запити чекати. - Політика читає параметри під час конфігурування через
AddOptions<RateLimiterOptions>().Configure<IOptions<RateLimitingOptions>>(...)– той самий прийом, що й для параметрів JWT Bearer у темі 12. WriteRejectionAsyncвідповідає429 Too Many Requestsяк Problem Details із кодомtoo_many_requestsі заголовкомRetry-Afterз кількістю секунд до кінця вікна. Він використовуєIProblemDetailsService, тож тіло має ту саму форму, що й кожна інша помилка.
Крок 3. Стримайте групу автентифікації
Що зробити. Додайте політику до групи автентифікації (змінений рядок позначено зеленим):
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").RequireRateLimiting(RateLimiting.AuthPolicy);
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));
}
}Один виклик на групі охоплює всі п’ять кінцевих точок. Сам обмежувач реєструється в AddApi і вмикається викликом UseRateLimiter() у наступному розділі.
IP-адреса за проксі
На робочому сервері кожен запит доходить до Kestrel від Nginx з 127.0.0.1. Без переспрямованих заголовків з наступного розділу всі користувачі ділили б один розділ – і 21-й вхід за хвилину заблокував би всіх.