ASP.NET Core Rate Limiting: Architektura a konfigurace

Architektura a konfigurace komponenty pro omezení rychlosti požadavků v ASP.NET Core

ASP.NET Core poskytuje robustní a flexibilní mechanismus pro omezení rychlosti zpracování příchozích požadavků, což je kriticky důležité pro udržení stability a bezpečnosti webových aplikací. Základem této funkcionality je specializovaný _middleware pro omezení rychlosti_ (rate limiting middleware), který efektivně řídí tok požadavků pomocí univerzální komponenty pro omezení rychlosti v .NET. Pochopení jeho architektury, principů konfigurace a rozšíření umožňuje vývojářům na úrovni middle/senior vytvářet robustní a škálovatelná řešení. Tento článek podrobně odhaluje koncepty a mechanismy fungování této komponenty, přesahující rámec povrchního použití.

Integrace a konfigurace Rate Limiting Middleware v ASP.NET Core

Centrální roli v systému rate limiting v ASP.NET Core hraje _middleware pro omezení rychlosti_ (rate limiting middleware). Zachytává každý příchozí HTTP požadavek a rozhoduje o jeho dalším zpracování nebo odmítnutí na základě definovaných pravidel. Tento middleware je jakýmsi adaptérem, který využívá základní algoritmy omezování poskytované univerzální komponentou pro omezení rychlosti v .NET.

Pro implementaci _middleware_ do pipeline zpracování požadavků ASP.NET Core se používá rozšiřující metoda UseRateLimiter pro rozhraní IApplicationBuilder. Klíčovým požadavkem na jeho umístění v pipeline je pozice mezi voláními UseRouting a UseEndpoints. To zaručuje, že omezení jsou aplikována poté, co byla definována trasa požadavku, ale dříve, než požadavek dosáhne koncového bodu zpracování. V aplikacích postavených na šablonách WebApplication/WebApplicationBuilder (počínaje ASP.NET Core 6.0) je tato podmínka často dodržována ve výchozím nastavení.

Konfigurace chování _middleware_ se provádí prostřednictvím _konfiguračních parametrů omezovače_, zapouzdřených v instanci třídy RateLimiterOptions. Metoda UseRateLimiter má dvě hlavní formy: jedna umožňuje předat instanci RateLimiterOptions přímo, druhá, častěji používaná, načítá parametry z kontejneru služeb aplikace, což odpovídá vzoru Options.

Pro plné fungování, včetně sběru metrik, je nutné zaregistrovat požadované služby v kontejneru závislostí. To se provádí pomocí rozšiřující metody AddRateLimiter pro IServiceCollection. Počínaje ASP.NET Core 8 je registrace těchto služeb povinná. Metoda AddRateLimiter slouží také ke konfiguraci RateLimiterOptions prostřednictvím delegáta předaného jako parametr. S ASP.NET Core 9 byla přidána forma AddRateLimiter bez delegáta, která předpokládá alternativní způsoby poskytování nastavení. Efektivní _konfigurace_ těchto parametrů je kritická pro výkon a bezpečnost aplikace.

Globální a politikou řízené mechanismy omezení

Funkcionalita rate limiting v ASP.NET Core pracuje se dvěma nezávislými, ale vzájemně se doplňujícími mechanismy: _globálním omezením_ a _omezením na základě politik_. Požadavek bude úspěšně zpracován pouze v případě, že získá povolení od obou mechanismů. Pokud jeden z nich není nakonfigurován nebo není použitelný pro aktuální požadavek, jeho povolení se považuje za automaticky získané.

Globální omezení rychlosti požadavků

_Globální omezení_ se aplikuje na všechny bez výjimky příchozí požadavky. Konfiguruje se přiřazením instance selektivního omezovače vlastnosti GlobalLimiter v RateLimiterOptions. Tento omezovač musí být objektem třídy PartitionedRateLimiter, parametrizovaným typem zdroje HttpContext. V kontextu ASP.NET Core HttpContext vždy se používá jako typ zdroje pro omezovače. Absence konfigurace globálního omezovače tento mechanismus deaktivuje. Správa provozu na globální úrovni je první linií obrany.

Omezení rychlosti na základě politik

Pro detailnější kontrolu nad tokem požadavků se používá _omezení na základě politik_. _Politiky omezení požadavků_ umožňují aplikovat specifická pravidla omezování na určité skupiny požadavků, spojené s konkrétními trasami nebo cíli směrování. Konfigurace politik se provádí pomocí několika přetížení metody AddPolicy v RateLimiterOptions. Tyto metody umožňují přidávat pojmenované _politiky omezení_ do konfigurace.

Politiky mohou být:

Pojmenované: registrují se v RateLimiterOptions s unikátním identifikátorem. Mohou být opakovaně použity a navázány na různé trasy.
Bezejmenné: vážou se přímo na konkrétní trasu a nejsou určeny k opakovanému použití jinde.

Proces konfigurace pojmenovaných politik zahrnuje dvě fáze:

Přidání pojmenované politiky do RateLimiterOptions pomocí AddPolicy.
Navázání této politiky na jednu nebo více tras v konfiguraci směrování.

Bezejmenné politiky vyžadují pouze navázání na trasu. To zajišťuje flexibilitu v _řízení přístupu_ k různým koncovým bodům.

Zpracování odmítnutí a vytváření vlastních politik

Když je požadavek odmítnut mechanismem rate limiting, _middleware_ musí provést určité akce. Toto chování se konfiguruje prostřednictvím vlastností OnRejected a RejectionStatusCode v RateLimiterOptions.

Vlastnost RejectionStatusCode definuje HTTP stavový kód, který bude vrácen klientovi (například 503 Service Unavailable nebo 429 Too Many Requests). Vlastnost OnRejected umožňuje definovat _obsluhu odmítnutí přidělení povolení_ — asynchronní delegát (ValueTask), který přijímá HttpContext a objekt odpovědi s odmítnutím. Tento delegát je určen k modifikaci odpovědi, například pro přidání hlaviček Retry-After nebo poskytnutí podrobnějších informací o důvodech odmítnutí.

Je důležité si uvědomit, že _politiky omezení_ mohou mít vlastní specifickou obsluhu odmítnutí. Pokud je pro požadavek, který spadá pod působnost politiky, definována jak globální obsluha, tak obsluha uvnitř politiky, priorita je vždy dána obsluze definované v politice. Takový mechanismus umožňuje jemné ladění reakcí na _odmítnutí požadavků_.

Vývoj vlastních politik omezení

Pro implementaci složitých a vlastních scénářů _omezování_, které přesahují rámec standardních konfigurací, poskytuje ASP.NET Core možnost vytváření _uživatelských politik omezení požadavků_. Taková politika musí implementovat generické rozhraní IRateLimiterPolicy<TPartitionKey>, kde TPartitionKey definuje typ klíče pro rozdělení (partitioning).

Rozhraní IRateLimiterPolicy<TPartitionKey> definuje dva klíčové prvky:

Metoda GetPartition: Toto je _partitionovací metoda_, která na základě aktuálního HttpContext vrací data pro partition s určeným typem partitionovacího klíče. Umožňuje dynamicky vybírat základní omezovač pro požadavek, například na základě IP adresy klienta, identifikátoru uživatele, hodnoty hlavičky nebo jiných parametrů HttpContext. To činí rate limiting selektivním, což umožňuje aplikovat různé limity na různé skupiny požadavků, i když spadají pod stejnou politiku.
Vlastnost OnRejected: Jak již bylo zmíněno, umožňuje definovat specifickou obsluhu odmítnutí právě pro danou politiku, přepisující globální obsluhu.

Objekty implementující IRateLimiterPolicy<TPartitionKey> jsou používány _middleware_ k vytváření takzvaných _připravených politik_ (prepared policies), které se přímo aplikují na _zpracování požadavků_. V aktuálních verzích, kromě tříd implementujících toto rozhraní, mohou jako základ pro pojmenované politiky sloužit i partitionovací delegáti s typem zdroje HttpContext.

Použití uživatelských politik a _partitionování_ poskytuje vývojářům výjimečnou flexibilitu při vytváření přesných a adaptivních systémů rate limiting, schopných splnit jedinečné požadavky vysoce zatížených aplikací, mikroservisních architektur nebo veřejných API. To přispívá k efektivnímu _řízení zdrojů_ a prevenci zneužití.

Co je důležité

Rate Limiting Middleware v ASP.NET Core je klíčovou komponentou pro kontrolu provozu a bezpečnosti, integrovanou s univerzálním mechanismem omezení rychlosti v .NET.
Konfigurace funkcionality se provádí prostřednictvím RateLimiterOptions s použitím metod UseRateLimiter pro pipeline a AddRateLimiter pro registraci služeb a konfiguraci.
Systém podporuje dvě úrovně rate limiting: _globální omezení_ pro všechny požadavky a _politikou řízené_ pro granulární kontrolu nad konkrétními trasami.
Zpracování odmítnutí povolení se konfiguruje prostřednictvím OnRejected a RejectionStatusCode, s možností přepsání na úrovni politik.
_Uživatelské politiky_, implementující IRateLimiterPolicy<TPartitionKey>, umožňují implementovat složité _partitionování_ na základě HttpContext pro dynamický výběr omezovačů a přizpůsobení logiky odmítnutí.