# Limites de débit

Comment les requêtes sont bridées par IP cliente, ce que reçoit un client bridé (HTTP 429, en-têtes de limitation) et où sont les limites d'objets.

Pour garder le service réactif et émousser les abus, la plateforme limite le nombre de requêtes qu'un même client peut émettre dans une courte fenêtre. Cette page explique la limitation de débit appliquée à la connexion, à l'espace du compte et à l'API REST, ce que reçoit un client bridé, et en quoi cela diffère des fonctions de protection des comptes documentées ailleurs.

La limitation de débit porte ici sur le **volume de requêtes**. Elle est distincte des défenses de la surface de connexion (limitation de débit par IP, protection contre la force brute, verrouillage de compte) traitées sous [Protection contre les menaces](https://dts-identity.com/fr/docs/security/threat-protection.md), et des **limites d'objets** par niveau d'abonnement (combien d'utilisateurs, d'applications, etc. vous pouvez créer) documentées sous [Plans & add-ons](https://dts-identity.com/fr/docs/getting-started/plans-and-addons.md#sizing-limits).

## Comment fonctionne le bridage des requêtes

- Les requêtes sont comptées **par adresse IP cliente**, et non par utilisateur ni par session : un appelant non authentifié est donc bridé de la même manière. Un client IPv6 est compté par son préfixe /64, car une connexion détient généralement l'ensemble du préfixe.
- Le compteur est partagé sur l'ensemble du déploiement. Comme chaque nœud lit le même compteur, un client ne peut pas faire passer davantage de requêtes en s'adressant à un autre nœud.
- Le trafic de connexion, celui de l'espace du compte et celui de l'API REST sont bridés. Lorsqu'un client dépasse le nombre de requêtes autorisé dans la fenêtre, les requêtes suivantes sont rejetées avec **HTTP 429 (Too Many Requests)** jusqu'au basculement de la fenêtre. La limite expire d'elle-même : le trafic normal reprend automatiquement dès que le client ralentit.
- Une protection distincte, valable pour toute la plateforme, se défend contre les déluges de fort volume (tentatives de déni de service), en plus de la fenêtre par IP.
- Les e-mails qu'un appelant non authentifié déclenche vers une adresse qu'il saisit (vérification d'inscription, son renvoi, le lien de réinitialisation du mot de passe) sont en outre limités à **5 par heure et par adresse destinataire**, quelle que soit l'IP d'origine des requêtes. Au-delà, une nouvelle demande d'inscription ou de réinitialisation pour cette adresse est refusée, et un renvoi n'envoie rien, jusqu'à ce que l'heure soit écoulée.

## Ce que reçoit un client bridé

Une requête d'API REST ou de connexion bridée renvoie **429**, accompagné d'en-têtes qui indiquent au client quand réessayer :

| En-tête | Signification |
|---|---|
| `Retry-After` | Nombre de secondes à attendre avant de réessayer. |
| `X-RateLimit-Limit` | Le nombre de requêtes autorisées dans la fenêtre. |
| `X-RateLimit-Remaining` | Les requêtes encore autorisées dans la fenêtre en cours. |
| `X-RateLimit-Reset` | Le moment où la fenêtre est réinitialisée, sous forme d'horodatage Unix (en secondes). |

**Concevez vos clients pour qu'ils respectent ces en-têtes.** Sur une 429, attendez la durée de `Retry-After` puis réessayez, au lieu de reboucler immédiatement. La lecture de `X-RateLimit-Remaining` permet à un client bien élevé de ralentir avant d'être bridé. Traitez les en-têtes comme la limite qui fait foi : les valeurs exactes peuvent changer, et un client qui les lit s'adapte automatiquement.

## Requêtes de token machine-to-machine [#machine-to-machine-token-requests]

Les tokens obtenus avec le grant client-credentials sont limités séparément, **par client plutôt que par adresse IP** : le token endpoint sert également les connexions interactives, et un service au comportement défaillant ne doit pas brider les connexions de tous ceux qui partagent son réseau. Le quota dépend de votre abonnement :

| Niveau | Requêtes de token par minute et par client |
|---|---|
| Trial | 30 |
| Free | 60 |
| Essential | 1 200 |
| Advanced | 6 000 |
| Pro | 30 000 |

Un client au-delà de sa limite reçoit **429**, avec un en-tête `Retry-After` et l'erreur OAuth `too_many_requests`. Les connexions interactives ne sont jamais affectées par cette limite.

Un service qui met son access token en cache et le réutilise jusqu'à peu avant son expiration a besoin d'environ une requête de token par heure, et reste donc très en deçà du quota de chaque niveau. Atteindre la limite signifie presque toujours que le client demande un nouveau token pour chaque appel d'API : corrigez alors la mise en cache plutôt que de demander une limite plus élevée. Les niveaux d'entrée disposent en outre d'un budget mensuel de tokens ; les deux limites sont documentées sous [API](https://dts-identity.com/fr/docs/integrations/apis.md#machine-to-machine-token-limits).

## Ce qui n'est pas limité de cette façon

- **Le verrouillage de compte et les blocages d'IP** consécutifs à des connexions répétées en échec relèvent d'un autre mécanisme, configuré sous Sécurité et levé sous [Monitoring → Limites de débit & IP bloquées](https://dts-identity.com/fr/docs/monitoring/rate-limits-and-blocked-ips.md). Ceux-ci bloquent une IP précise ou verrouillent un compte précis pour une durée plus longue et configurable ; le bridage des requêtes ne fait que retarder une salve de requêtes.
- **Les limites d'objets et de dimensionnement** (nombre maximal d'utilisateurs, d'applications, de connexions, de politiques, de zones réseau, de membres de l'équipe d'administration) sont régies par votre abonnement et votre licence, pas par le débit de requêtes. Voir [Plans & add-ons](https://dts-identity.com/fr/docs/getting-started/plans-and-addons.md#sizing-limits).

## Sujets liés

- [Protection contre les menaces](https://dts-identity.com/fr/docs/security/threat-protection.md), qui traite de la limitation de débit par IP, de la protection contre la force brute, de la détection des mots de passe compromis et de la détection des bots sur la surface de connexion.
- [Limites de débit & IP bloquées](https://dts-identity.com/fr/docs/monitoring/rate-limits-and-blocked-ips.md), pour examiner et libérer les clients bloqués.
- [Plans & add-ons](https://dts-identity.com/fr/docs/getting-started/plans-and-addons.md#sizing-limits), pour les limites d'objets par niveau d'abonnement.
- [API](https://dts-identity.com/fr/docs/integrations/apis.md), pour obtenir et utiliser des tokens destinés à l'API REST.
