Skip to Content

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 behandelt werden, und von den stufenspezifischen Objekt-Limits (wie viele Benutzer, Anwendungen usw. Sie erstellen dürfen), die unter Pläne und Add-ons 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:

HeaderBedeutung
Retry-AfterSekunden, die vor einem erneuten Versuch zu warten sind.
X-RateLimit-LimitDie Anzahl der im Zeitfenster erlaubten Anfragen.
X-RateLimit-RemainingIm aktuellen Zeitfenster noch erlaubte Anfragen.
X-RateLimit-ResetWann 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

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:

StufeToken-Anfragen pro Minute und Client
Trial30
Free60
Essential1.200
Advanced6.000
Pro30.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 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. 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.

Verwandte Themen

  • Bedrohungsschutz, 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, zum Überprüfen und Freigeben gesperrter Clients.
  • Pläne und Add-ons, für stufenspezifische Objekt-Limits.
  • APIs, zum Beziehen und Verwenden von Tokens für die REST-API.

Auf dieser Seite