# Rate limit

Come le richieste vengono limitate per IP client, che cosa riceve un client limitato (HTTP 429, header di rate limit) e dove sono i limiti sugli oggetti.

Per mantenere il servizio reattivo e attenuare gli abusi, la piattaforma limita il numero di richieste che un singolo client può effettuare in una breve finestra temporale. Questa pagina illustra il rate limiting sulle richieste che si applica all'accesso, all'area dell'account e alla REST API, che cosa riceve un client limitato e in che cosa questo si distingue dalle funzioni di protezione degli account documentate altrove.

Il rate limiting trattato qui riguarda il **volume di richieste**. È distinto dalle difese della superficie di accesso (limitazione per IP, protezione dal brute force, blocco dell'account) descritte in [Protezione dalle minacce](https://dts-identity.com/it/docs/security/threat-protection.md), e dai **limiti sugli oggetti** per singolo piano (quanti utenti, applicazioni e così via è possibile creare) documentati in [Piani e add-on](https://dts-identity.com/it/docs/getting-started/plans-and-addons.md#sizing-limits).

## Come funziona la limitazione delle richieste

- Le richieste vengono conteggiate **per indirizzo IP del client**, non per utente né per sessione, quindi anche un chiamante non autenticato viene limitato allo stesso modo. Un client IPv6 viene conteggiato in base al suo prefisso /64, poiché una connessione dispone di norma dell'intero prefisso.
- Il conteggio è condiviso dall'intero deployment. Poiché ogni nodo legge lo stesso contatore, un client non può far passare più richieste raggiungendo un nodo diverso.
- Il traffico di accesso, dell'area account e della REST API è soggetto a limitazione. Quando un client supera il numero di richieste consentito nella finestra, le richieste successive vengono rifiutate con **HTTP 429 (Too Many Requests)** finché la finestra non si rinnova. Il limite scade da solo: il traffico normale riprende automaticamente non appena il client rallenta.
- Una protezione separata a livello di piattaforma difende dalle ondate ad alto volume (tentativi di denial of service) in aggiunta alla finestra per singolo IP.
- Le email che un chiamante non autenticato fa inviare a un indirizzo da esso inserito (verifica della registrazione, il relativo reinvio, il link per la reimpostazione della password) sono inoltre limitate a **5 all'ora per indirizzo destinatario**, indipendentemente dall'IP da cui provengono le richieste. Oltre tale soglia, una nuova richiesta di registrazione o di reimpostazione per l'indirizzo viene rifiutata e un reinvio non invia nulla, finché l'ora non è trascorsa.

## Che cosa riceve un client limitato

Una richiesta alla REST API o di accesso che viene limitata restituisce **429** insieme agli header che indicano al client quando riprovare:

| Header | Significato |
|---|---|
| `Retry-After` | Secondi di attesa prima di riprovare. |
| `X-RateLimit-Limit` | Il numero di richieste consentite nella finestra. |
| `X-RateLimit-Remaining` | Richieste ancora consentite nella finestra corrente. |
| `X-RateLimit-Reset` | Quando la finestra si azzera, come timestamp Unix (in secondi). |

**Conviene realizzare i client in modo che rispettino questi header.** In caso di 429, attendere il tempo indicato da `Retry-After` e riprovare, anziché ripetere subito la richiesta in ciclo. La lettura di `X-RateLimit-Remaining` consente a un client ben educato di rallentare prima di essere limitato. Gli header vanno considerati il limite autorevole: i valori esatti possono cambiare e un client che li legge si adatta automaticamente.

## Richieste di token machine-to-machine [#machine-to-machine-token-requests]

I token ottenuti con il grant client credentials sono limitati separatamente, **per client anziché per indirizzo IP**: il token endpoint serve anche gli accessi interattivi e un singolo servizio malfunzionante non deve limitare gli accessi di tutti coloro che condividono la sua rete. Il contingente dipende dal proprio abbonamento:

| Piano | Richieste di token al minuto, per client |
|---|---|
| Trial | 30 |
| Free | 60 |
| Essential | 1.200 |
| Advanced | 6.000 |
| Pro | 30.000 |

Un client che supera il proprio limite riceve **429** con un header `Retry-After` e l'errore OAuth `too_many_requests`. Gli accessi interattivi non sono mai interessati da questo limite.

Un servizio che memorizza in cache il proprio access token e lo riutilizza fino a poco prima della scadenza necessita di circa una richiesta di token all'ora e resta ben al di sotto del contingente di qualsiasi piano. Raggiungere il limite significa quasi sempre che il client richiede un token nuovo per ogni chiamata API: in tal caso conviene correggere la gestione della cache anziché chiedere un limite più alto. I piani di ingresso hanno inoltre un budget mensile di token; entrambi i limiti sono documentati in [API](https://dts-identity.com/it/docs/integrations/apis.md#machine-to-machine-token-limits).

## Che cosa non è soggetto a questo tipo di limitazione

- Il **blocco dell'account e i blocchi IP** dovuti ad accessi ripetutamente non riusciti sono un meccanismo diverso, configurato in Sicurezza e rimosso in [Monitoraggio → Limiti di frequenza e IP bloccati](https://dts-identity.com/it/docs/monitoring/rate-limits-and-blocked-ips.md). Questi bloccano un IP specifico o un account specifico per un periodo più lungo e configurabile; la limitazione delle richieste ritarda soltanto un'ondata di richieste.
- I **limiti sugli oggetti e dimensionali** (numero massimo di utenti, applicazioni, connessioni, criteri, zone di rete, membri del team di amministrazione) dipendono dal proprio abbonamento e dalla propria licenza, non dalla frequenza delle richieste. Vedere [Piani e add-on](https://dts-identity.com/it/docs/getting-started/plans-and-addons.md#sizing-limits).

## Argomenti correlati

- [Protezione dalle minacce](https://dts-identity.com/it/docs/security/threat-protection.md), che tratta la limitazione per IP, la protezione dal brute force, il rilevamento delle password compromesse e il rilevamento dei bot sulla superficie di accesso.
- [Limiti di frequenza e IP bloccati](https://dts-identity.com/it/docs/monitoring/rate-limits-and-blocked-ips.md), per esaminare e sbloccare i client bloccati.
- [Piani e add-on](https://dts-identity.com/it/docs/getting-started/plans-and-addons.md#sizing-limits), per i limiti sugli oggetti per singolo piano.
- [API](https://dts-identity.com/it/docs/integrations/apis.md), per ottenere e utilizzare i token per la REST API.
