Rate Limiting w ASP.NET Core: Architektura i Konfiguracja

Architektura i konfiguracja komponentu limitowania szybkości zapytań w ASP.NET Core

ASP.NET Core oferuje potężny i elastyczny mechanizm do limitowania szybkości przetwarzania przychodzących zapytań, co jest kluczowe dla utrzymania stabilności i bezpieczeństwa aplikacji webowych. U podstaw tej funkcjonalności leży wyspecjalizowany _komponent middleware do limitowania szybkości_ (rate limiting middleware), który efektywnie zarządza przepływem zapytań, wykorzystując uniwersalny komponent limitowania szybkości .NET. Zrozumienie jego architektury, zasad konfiguracji i rozszerzania pozwala programistom na poziomie middle/senior tworzyć solidne i skalowalne rozwiązania. Niniejszy artykuł szczegółowo omawia koncepcje i mechanizmy działania tego komponentu, wykraczając poza jego powierzchowne zastosowanie.

Integracja i konfiguracja Rate Limiting Middleware w ASP.NET Core

Centralną rolę w systemie rate limiting w ASP.NET Core odgrywa _komponent middleware limitującego_ (rate limiting middleware). Przechwytuje on każde przychodzące zapytanie HTTP, podejmując decyzję o jego dalszym przetwarzaniu lub odrzuceniu na podstawie zdefiniowanych reguł. To middleware jest swego rodzaju adapterem, wykorzystującym podstawowe algorytmy limitowania dostarczane przez uniwersalny komponent limitowania szybkości .NET.

Do wdrożenia _komponentu middleware_ do potoku przetwarzania zapytań ASP.NET Core używa się metody rozszerzającej UseRateLimiter dla interfejsu IApplicationBuilder. Kluczowym wymogiem dotyczącym jego umiejscowienia w potoku jest pozycja między wywołaniami UseRouting a UseEndpoints. Gwarantuje to, że ograniczenia są stosowane po zdefiniowaniu trasy zapytania, ale zanim zapytanie dotrze do końcowego punktu przetwarzania. W aplikacjach zbudowanych na szablonach WebApplication/WebApplicationBuilder (począwszy od ASP.NET Core 6.0), ten warunek jest często spełniony domyślnie.

Konfiguracja zachowania _komponentu middleware_ odbywa się poprzez _opcje konfiguracji limitera_, hermetyzowane w instancji klasy RateLimiterOptions. Metoda UseRateLimiter ma dwie główne formy: jedna pozwala na bezpośrednie przekazanie instancji RateLimiterOptions, druga, częściej używana, pobiera parametry z kontenera usług aplikacji, co odpowiada wzorcowi Options.

Dla pełnego funkcjonowania, włączając zbieranie metryk, konieczne jest zarejestrowanie wymaganych usług w kontenerze zależności. Odbywa się to za pomocą metody rozszerzającej AddRateLimiter dla IServiceCollection. Począwszy od ASP.NET Core 8, rejestracja tych usług jest obowiązkowa. Metoda AddRateLimiter służy również do konfigurowania RateLimiterOptions poprzez delegat przekazywany jako parametr. Od ASP.NET Core 9 dodano formę AddRateLimiter bez delegata, co zakłada alternatywne sposoby dostarczania ustawień. Efektywna _konfiguracja_ tych parametrów jest krytyczna dla wydajności i bezpieczeństwa aplikacji.

Globalne i polityko-zorientowane mechanizmy limitowania

Funkcjonalność rate limiting w ASP.NET Core operuje dwoma niezależnymi, ale wzajemnie uzupełniającymi się mechanizmami: _globalnym limitowaniem_ i _limitowaniem opartym na politykach_. Zapytanie zostanie pomyślnie przetworzone tylko po uzyskaniu zezwolenia od obu mechanizmów. Jeśli jeden z nich nie jest skonfigurowany lub nie ma zastosowania do bieżącego zapytania, jego zezwolenie jest uznawane za automatycznie uzyskane.

Globalne limitowanie szybkości zapytań

_Globalne limitowanie_ stosuje się do wszystkich bez wyjątku przychodzących zapytań. Konfiguruje się je poprzez przypisanie do właściwości GlobalLimiter w RateLimiterOptions instancji selektywnego limitera. Ten limiter musi być obiektem klasy PartitionedRateLimiter, sparametryzowanym typem zasobu HttpContext. W kontekście ASP.NET Core HttpContext jest zawsze używany jako typ zasobu dla limiterów. Brak konfiguracji globalnego limitera dezaktywuje ten mechanizm. Zarządzanie ruchem na poziomie globalnym jest pierwszym szczeblem ochrony.

Limitowanie szybkości na podstawie polityk

Dla bardziej szczegółowej kontroli nad przepływem zapytań stosuje się _limitowanie oparte na politykach_. _Polityki limitowania zapytań_ pozwalają na stosowanie specyficznych reguł limitowania do określonych grup zapytań, powiązanych z konkretnymi trasami lub punktami docelowymi routingu.

Konfiguracja polityk odbywa się za pomocą kilku przeciążeń metody AddPolicy w RateLimiterOptions. Metody te umożliwiają dodawanie nazwanych _polityk limitowania_ do konfiguracji.

Polityki mogą być:

• Nazwanymi: rejestrowane są w RateLimiterOptions z unikalnym identyfikatorem. Mogą być wielokrotnie używane i przypisywane do różnych tras.
• Anonimowymi: przypisywane są bezpośrednio do konkretnej trasy i nie są przeznaczone do ponownego użycia w innych miejscach.

Proces konfiguracji nazwanych polityk obejmuje dwa etapy:

• Dodanie nazwanej polityki do RateLimiterOptions za pomocą AddPolicy.
• Przypisanie tej polityki do jednej lub kilku tras w konfiguracji routingu.

Anonimowe polityki wymagają jedynie przypisania do trasy. Zapewnia to elastyczność w _zarządzaniu dostępem_ do różnych endpointów.

Obsługa odrzuceń i tworzenie niestandardowych polityk

Gdy zapytanie zostanie odrzucone przez mechanizm rate limiting, _komponent middleware_ musi wykonać określone działania. To zachowanie jest konfigurowane poprzez właściwości OnRejected i RejectionStatusCode w RateLimiterOptions.

Właściwość RejectionStatusCode określa kod statusu HTTP, który zostanie zwrócony klientowi (np. 503 Service Unavailable lub 429 Too Many Requests). Właściwość OnRejected pozwala zdefiniować _handler odrzucenia autoryzacji_ — asynchroniczny delegat (ValueTask), przyjmujący HttpContext i obiekt odpowiedzi z odrzuceniem. Ten delegat jest przeznaczony do modyfikacji odpowiedzi, na przykład w celu dodania nagłówków Retry-After lub dostarczenia bardziej szczegółowych informacji o przyczynach odrzucenia.

Ważne jest, aby pamiętać, że _polityki limitowania_ mogą mieć swój własny, specyficzny handler odrzucenia. Jeśli dla zapytania podlegającego polityce zdefiniowano zarówno globalny handler, jak i handler wewnątrz polityki, priorytet zawsze ma handler zdefiniowany w polityce. Taki mechanizm pozwala na precyzyjne dostosowywanie reakcji na _odrzucanie zapytań_.

Tworzenie niestandardowych polityk limitowania

Dla realizacji złożonych i niestandardowych scenariuszy _limitowania_, wykraczających poza standardowe konfiguracje, ASP.NET Core umożliwia tworzenie _niestandardowych polityk limitowania zapytań_. Taka polityka musi implementować uogólniony interfejs IRateLimiterPolicy<TPartitionKey>, gdzie TPartitionKey określa typ klucza partycjonowania.

Interfejs IRateLimiterPolicy<TPartitionKey> definiuje dwa kluczowe elementy:

• Metoda GetPartition: to _metoda partycjonująca_, która na podstawie bieżącego HttpContext zwraca dane dla partycji z określonym typem klucza partycjonowania. Pozwala ona dynamicznie wybierać podstawowy limiter dla zapytania, na przykład na podstawie adresu IP klienta, identyfikatora użytkownika, wartości nagłówka lub innych parametrów HttpContext. To sprawia, że rate limiting jest selektywne, umożliwiając stosowanie różnych limitów do różnych grup zapytań, nawet jeśli podlegają one tej samej polityce.
• Właściwość OnRejected: jak wspomniano wcześniej, pozwala ona zdefiniować specyficzny handler odrzucenia właśnie dla danej polityki, nadpisując globalny handler.

Obiekty implementujące IRateLimiterPolicy<TPartitionKey> są wykorzystywane przez _komponent middleware_ do tworzenia tak zwanych _przygotowanych polityk_ (prepared policies), które są bezpośrednio stosowane do _przetwarzania zapytań_. W obecnych wersjach, oprócz klas implementujących ten interfejs, podstawą dla nazwanych polityk mogą być również delegaty partycjonujące z typem zasobu HttpContext. Zastosowanie niestandardowych polityk i _partycjonowania_ zapewnia programistom wyjątkową elastyczność w tworzeniu precyzyjnych i adaptacyjnych systemów rate limiting, zdolnych sprostać unikalnym wymaganiom wysokoobciążonych aplikacji, architektur mikroserwisowych lub publicznych API. Przyczynia się to do efektywnego _zarządzania zasobami_ i zapobiegania nadużyciom.

Co ważne

• Rate Limiting Middleware w ASP.NET Core to kluczowy komponent do kontroli ruchu i bezpieczeństwa, zintegrowany z uniwersalnym mechanizmem limitowania szybkości .NET.
• Konfiguracja funkcjonalności odbywa się poprzez RateLimiterOptions z wykorzystaniem metod UseRateLimiter dla potoku i AddRateLimiter do rejestracji usług i konfiguracji.
• System obsługuje dwa poziomy rate limiting: _globalne limitowanie_ dla wszystkich zapytań oraz _polityko-zorientowane_ dla granularnej kontroli nad konkretnymi trasami.
• Obsługa odrzuceń autoryzacji konfigurowana jest poprzez OnRejected i RejectionStatusCode, z możliwością nadpisania na poziomie polityk.
• _Niestandardowe polityki_, implementujące IRateLimiterPolicy<TPartitionKey>, pozwalają na wdrożenie złożonego _partycjonowania_ na podstawie HttpContext dla dynamicznego wyboru limiterów i dostosowania logiki odrzucenia.

— Editorial Team