# 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](https://dts-identity.com/pl/docs/security/threat-protection.md) 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](https://dts-identity.com/pl/docs/getting-started/plans-and-addons.md#sizing-limits).

## 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łówek | Znaczenie |
|---|---|
| `Retry-After` | Liczba sekund oczekiwania przed ponowną próbą. |
| `X-RateLimit-Limit` | Liczba żądań dozwolonych w oknie. |
| `X-RateLimit-Remaining` | Liczba żądań wciąż dozwolonych w bieżącym oknie. |
| `X-RateLimit-Reset` | Kiedy 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 [#machine-to-machine-token-requests]

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 |
|---|---|
| Trial | 30 |
| Free | 60 |
| Essential | 1 200 |
| Advanced | 6 000 |
| Pro | 30 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](https://dts-identity.com/pl/docs/integrations/apis.md#machine-to-machine-token-limits).

## 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](https://dts-identity.com/pl/docs/monitoring/rate-limits-and-blocked-ips.md). 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](https://dts-identity.com/pl/docs/getting-started/plans-and-addons.md#sizing-limits).

## Powiązane tematy

- [Ochrona przed zagrożeniami](https://dts-identity.com/pl/docs/security/threat-protection.md), obejmująca ograniczanie liczby żądań na adres IP, ochronę przed atakami brute force, wykrywanie haseł z wycieków oraz wykrywanie botów na powierzchni logowania.
- [Limity żądań i zablokowane adresy IP](https://dts-identity.com/pl/docs/monitoring/rate-limits-and-blocked-ips.md), do przeglądania i zwalniania zablokowanych klientów.
- [Plany i dodatki](https://dts-identity.com/pl/docs/getting-started/plans-and-addons.md#sizing-limits), po limity obiektów zależne od planu.
- [API](https://dts-identity.com/pl/docs/integrations/apis.md), po informacje o uzyskiwaniu i używaniu tokenów do REST API.
