Skip to Content

Limity żądań

Jak żądania są ograniczane na adres IP klienta, co otrzymuje ograniczony klient (HTTP 429, nagłówki limitów) i gdzie są limity obiektów.

Aby usługa pozostawała responsywna i aby ograniczyć nadużycia, platforma limituje liczbę żądań, jakie pojedynczy klient może wykonać w krótkim oknie czasowym. Ta strona wyjaśnia ograniczanie liczby żądań obowiązujące przy logowaniu, w obszarze konta i w REST API, opisuje, co otrzymuje ograniczony klient, oraz czym różni się to od funkcji ochrony kont opisanych w innych miejscach.

Ograniczanie żądań dotyczy tutaj wolumenu żądań. Jest czymś innym niż zabezpieczenia powierzchni logowania (ograniczanie liczby żądań na adres IP, ochrona przed atakami brute force, blokowanie kont) opisane na stronie Ochrona przed zagrożeniami oraz niż zależne od planu limity obiektów (ilu użytkowników, ile aplikacji i tak dalej możesz utworzyć), udokumentowane na stronie Plany i dodatki.

Jak działa dławienie żądań

  • Żądania są liczone dla każdego adresu IP klienta, a nie dla użytkownika czy sesji, więc wywołujący bez uwierzytelnienia jest dławiony dokładnie tak samo. Klient IPv6 jest liczony według prefiksu /64, ponieważ jedno połączenie zwykle dysponuje całym prefiksem.
  • Licznik jest wspólny dla całego wdrożenia. Ponieważ każdy węzeł odczytuje ten sam licznik, klient nie przepchnie większej liczby żądań, kierując je do innego węzła.
  • Dławieniu podlega ruch logowania, obszaru konta i REST API. Gdy klient przekroczy dozwoloną liczbę żądań w oknie, kolejne żądania są odrzucane z kodem HTTP 429 (Too Many Requests) do czasu przejścia do następnego okna. Limit wygasa samoczynnie: normalny ruch wznawia się automatycznie, gdy tylko klient zwolni.
  • Osobne zabezpieczenie obejmujące całą platformę broni dodatkowo przed zalewem żądań o dużym wolumenie (próbami odmowy usługi), niezależnie od okna liczonego per adres IP.
  • Wiadomości e-mail, które wywołujący bez uwierzytelnienia wyzwala na wpisany przez siebie adres (weryfikacja rejestracji, jej ponowne wysłanie, link do resetowania hasła), są dodatkowo ograniczone do 5 na godzinę na adres odbiorcy, niezależnie od adresu IP, z którego pochodzą żądania. Powyżej tego limitu nowa rejestracja lub żądanie resetu dla tego adresu jest odrzucane, a ponowne wysłanie niczego nie wysyła, dopóki nie upłynie godzina.

Co otrzymuje ograniczony klient

Zdławione żądanie do REST API albo żądanie logowania zwraca kod 429 wraz z nagłówkami, które mówią klientowi, kiedy ponowić próbę:

NagłówekZnaczenie
Retry-AfterLiczba sekund oczekiwania przed ponowną próbą.
X-RateLimit-LimitLiczba żądań dozwolonych w oknie.
X-RateLimit-RemainingLiczba żądań wciąż dozwolonych w bieżącym oknie.
X-RateLimit-ResetKiedy okno zostanie zresetowane, jako uniksowy znacznik czasu (w sekundach).

Buduj klientów tak, aby respektowały te nagłówki. Po otrzymaniu kodu 429 odczekaj czas z Retry-After i ponów próbę, zamiast natychmiast powtarzać żądanie w pętli. Odczyt nagłówka X-RateLimit-Remaining pozwala dobrze napisanemu klientowi zwolnić, zanim zostanie zdławiony. Traktuj nagłówki jako rozstrzygające źródło limitu; dokładne liczby mogą się zmieniać, a klient, który je czyta, dostosowuje się automatycznie.

Żądania tokenów machine-to-machine

Tokeny uzyskiwane grantem client credentials są limitowane osobno, dla każdego klienta, a nie dla adresu IP, ponieważ punkt końcowy tokenu obsługuje również logowania interaktywne, a jedna źle działająca usługa nie może dławić logowań wszystkich, którzy współdzielą jej sieć. Przydział zależy od Twojej subskrypcji:

PlanŻądania tokenów na minutę, na klienta
Trial30
Free60
Essential1 200
Advanced6 000
Pro30 000

Klient powyżej swojego limitu otrzymuje kod 429 z nagłówkiem Retry-After oraz błąd OAuth too_many_requests. Ten limit nigdy nie dotyczy logowań interaktywnych.

Usługa, która buforuje swój access token i używa go aż do chwili tuż przed wygaśnięciem, potrzebuje mniej więcej jednego żądania tokenu na godzinę i pozostaje daleko poniżej przydziału każdego planu. Osiągnięcie limitu prawie zawsze oznacza, że klient żąda nowego tokenu przy każdym wywołaniu API; napraw wtedy buforowanie, zamiast prosić o wyższy limit. Plany wejściowe mają dodatkowo miesięczny budżet tokenów; oba limity są udokumentowane na stronie API.

Czego ten mechanizm nie ogranicza

  • Blokowanie kont i blokady adresów IP po powtarzających się nieudanych logowaniach to inny mechanizm, konfigurowany w obszarze Bezpieczeństwo i zdejmowany w sekcji Monitorowanie → Limity żądań i zablokowane adresy IP. Blokują one konkretny adres IP albo konkretne konto na dłuższy, konfigurowalny czas; dławienie żądań jedynie opóźnia serię żądań.
  • Limity obiektów i wielkości (maksymalna liczba użytkowników, aplikacji, połączeń, polityk, stref sieciowych, członków zespołu administracyjnego) wynikają z Twojej subskrypcji i licencji, a nie z tempa żądań. Zobacz Plany i dodatki.

Powiązane tematy

Na tej stronie