# Rate-Limits

Wie Anfragen pro Client-IP gedrosselt werden, was ein gedrosselter Client erhält (HTTP 429, Rate-Limit-Header) und wo Objektlimits stehen.

Um den Dienst reaktionsfähig zu halten und Missbrauch abzuschwächen, begrenzt die Plattform, wie viele Anfragen ein einzelner Client in einem kurzen Zeitfenster stellen darf. Diese Seite erklärt das Rate-Limiting für Anfragen, das für Anmeldung, den Kontobereich und die REST-API gilt, was ein gedrosselter Client erhält und wie es sich von den an anderer Stelle dokumentierten Kontoschutzfunktionen unterscheidet.

Beim Rate-Limiting geht es hier um das **Anfragevolumen**. Es ist getrennt von den Verteidigungsmaßnahmen der Anmeldeoberfläche (Ratenbegrenzung pro IP, Brute-Force-Schutz, Kontosperrung), die unter [Bedrohungsschutz](https://dts-identity.com/de/docs/security/threat-protection.md) behandelt werden, und von den stufenspezifischen **Objekt-Limits** (wie viele Benutzer, Anwendungen usw. Sie erstellen dürfen), die unter [Pläne und Add-ons](https://dts-identity.com/de/docs/getting-started/plans-and-addons.md#sizing-limits) dokumentiert sind.

## Wie die Anfrage-Drosselung funktioniert

- Anfragen werden **pro Client-IP-Adresse** gezählt, nicht pro Benutzer oder pro Sitzung, sodass ein nicht authentifizierter Aufrufer genauso gedrosselt wird. Ein IPv6-Client wird über sein /64-Präfix gezählt, da ein Anschluss in der Regel das ganze Präfix hält.
- Die Zählung wird über das gesamte Deployment hinweg geteilt. Da jeder Knoten denselben Zähler liest, kann ein Client nicht mehr Anfragen durchbringen, indem er einen anderen Knoten erreicht.
- Anmelde-, Konto- und REST-API-Verkehr werden gedrosselt. Überschreitet ein Client die zulässige Anzahl von Anfragen im Zeitfenster, werden weitere Anfragen mit **HTTP 429 (Too Many Requests)** abgelehnt, bis das Zeitfenster umschlägt. Das Limit läuft von selbst ab: Normaler Verkehr wird automatisch fortgesetzt, sobald der Client langsamer wird.
- Ein separater plattformweiter Schutz wehrt zusätzlich zum IP-bezogenen Zeitfenster hochvolumige Fluten (Denial-of-Service-Versuche) ab.
- E-Mails, die ein nicht angemeldeter Aufrufer an eine von ihm eingegebene Adresse auslöst (Bestätigung der Registrierung, deren erneuter Versand, der Link zum Zurücksetzen des Passworts), sind zusätzlich auf **5 pro Stunde und Empfängeradresse** begrenzt, unabhängig davon, von welcher IP die Anfragen kommen. Darüber hinaus wird eine neue Registrierung oder Anfrage zum Zurücksetzen für die Adresse abgelehnt und ein erneuter Versand verschickt nichts, bis die Stunde vorüber ist.

## Was ein gedrosselter Client erhält

Eine gedrosselte REST-API- oder Anmeldeanfrage gibt **429** zusammen mit Headern zurück, die dem Client mitteilen, wann er es erneut versuchen soll:

| Header | Bedeutung |
|---|---|
| `Retry-After` | Sekunden, die vor einem erneuten Versuch zu warten sind. |
| `X-RateLimit-Limit` | Die Anzahl der im Zeitfenster erlaubten Anfragen. |
| `X-RateLimit-Remaining` | Im aktuellen Zeitfenster noch erlaubte Anfragen. |
| `X-RateLimit-Reset` | Wann das Zeitfenster zurückgesetzt wird, als Unix-Zeitstempel (Sekunden). |

**Bauen Sie Clients so, dass sie diese Header berücksichtigen.** Warten Sie bei einer 429 auf `Retry-After` und versuchen Sie es dann erneut, anstatt sofort in einer Schleife weiterzumachen. Das Lesen von `X-RateLimit-Remaining` erlaubt einem wohlverhaltenen Client, langsamer zu werden, bevor er gedrosselt wird. Behandeln Sie die Header als maßgebliches Limit; die genauen Zahlen können sich ändern, und ein Client, der sie liest, passt sich automatisch an.

## Machine-to-Machine-Token-Anfragen [#machine-to-machine-token-requests]

Tokens aus dem client-credentials-Grant werden separat begrenzt, **pro Client statt pro IP-Adresse**. Der Token-Endpunkt bedient auch interaktive Anmeldungen, und ein fehlerhaft arbeitender Dienst darf nicht die Anmeldungen aller drosseln, die sein Netzwerk mitbenutzen. Das Kontingent richtet sich nach Ihrem Abonnement:

| Stufe | Token-Anfragen pro Minute und Client |
|---|---|
| Trial | 30 |
| Free | 60 |
| Essential | 1.200 |
| Advanced | 6.000 |
| Pro | 30.000 |

Ein Client über seinem Limit erhält **429** mit einem `Retry-After`-Header und dem OAuth-Fehler `too_many_requests`. Interaktive Anmeldungen sind von diesem Limit nie betroffen.

Ein Dienst, der seinen Access-Token zwischenspeichert und bis kurz vor Ablauf weiterverwendet, benötigt etwa eine Token-Anfrage pro Stunde und bleibt damit weit unter dem Kontingent jeder Stufe. Wird das Limit erreicht, fordert der Client fast immer für jeden API-Aufruf einen neuen Token an. Beheben Sie in diesem Fall das Caching, statt ein höheres Limit anzufragen. Die Einstiegsstufen haben zusätzlich ein monatliches Token-Budget; beide Limits sind unter [APIs](https://dts-identity.com/de/docs/integrations/apis.md#machine-to-machine-token-limits) dokumentiert.

## Was auf diese Weise nicht ratenbegrenzt wird

- **Kontosperrung und IP-Sperren** durch wiederholt fehlgeschlagene Anmeldungen sind ein anderer Mechanismus, konfiguriert unter Security und aufgehoben unter [Monitoring → Rate-Limits und gesperrte IPs](https://dts-identity.com/de/docs/monitoring/rate-limits-and-blocked-ips.md). Diese sperren eine bestimmte IP oder ein bestimmtes Konto für einen längeren, konfigurierbaren Zeitraum; die Anfrage-Drosselung verzögert lediglich einen Schwall von Anfragen.
- **Objekt- und Größenlimits** (maximale Anzahl von Benutzern, Anwendungen, Verbindungen, Richtlinien, Netzwerkzonen, Admin-Team-Mitgliedern) werden durch Ihr Abonnement und Ihre Lizenz bestimmt, nicht durch die Anfragerate. Siehe [Pläne und Add-ons](https://dts-identity.com/de/docs/getting-started/plans-and-addons.md#sizing-limits).

## Verwandte Themen

- [Bedrohungsschutz](https://dts-identity.com/de/docs/security/threat-protection.md), behandelt Ratenbegrenzung pro IP, Brute-Force-Schutz, die Erkennung kompromittierter Passwörter und die Bot-Erkennung auf der Anmeldeoberfläche.
- [Rate-Limits und gesperrte IPs](https://dts-identity.com/de/docs/monitoring/rate-limits-and-blocked-ips.md), zum Überprüfen und Freigeben gesperrter Clients.
- [Pläne und Add-ons](https://dts-identity.com/de/docs/getting-started/plans-and-addons.md#sizing-limits), für stufenspezifische Objekt-Limits.
- [APIs](https://dts-identity.com/de/docs/integrations/apis.md), zum Beziehen und Verwenden von Tokens für die REST-API.
