Rate limits
Hoe aanvragen per client-IP worden afgeremd, wat een afgeremde client terugkrijgt (HTTP 429, rate-limit-headers) en waar objectlimieten staan.
Om de dienst responsief te houden en misbruik af te zwakken, begrenst het platform hoeveel aanvragen één client in een kort tijdvenster mag doen. Deze pagina legt uit welke aanvraagbegrenzing geldt voor de aanmelding, het accountgebied en de REST API, wat een afgeremde client terugkrijgt, en hoe dit verschilt van de elders gedocumenteerde accountbeschermingsfuncties.
Bij rate limiting gaat het hier om het aanvraagvolume. Het staat los van de verdedigingen op het aanmeldoppervlak (rate limiting per IP, brute-force-beveiliging, accountvergrendeling) die onder Bedreigingsbeveiliging worden behandeld, en van de objectlimieten per abonnementsniveau (hoeveel gebruikers, applicaties enzovoort u mag aanmaken) die onder Abonnementen & add-ons staan.
Hoe het afremmen van aanvragen werkt
- Aanvragen worden per client-IP-adres geteld, niet per gebruiker of per sessie, dus een niet-geauthenticeerde aanroeper wordt precies zo afgeremd. Een IPv6-client wordt geteld op basis van zijn /64-prefix, omdat één verbinding doorgaans de hele prefix bezit.
- De telling wordt over de hele omgeving gedeeld. Omdat elke node dezelfde teller leest, kan een client niet meer aanvragen doorkrijgen door een andere node te benaderen.
- Aanmeld-, account- en REST API-verkeer worden afgeremd. Overschrijdt een client het toegestane aantal aanvragen in het tijdvenster, dan worden verdere aanvragen afgewezen met HTTP 429 (Too Many Requests) tot het tijdvenster omslaat. De limiet verloopt vanzelf: normaal verkeer wordt automatisch hervat zodra de client vaart mindert.
- Een aparte platformbrede bescherming weert daarnaast grootschalige vloedgolven (denial-of-service-pogingen) af, boven op het venster per IP.
- E-mails die een niet-geauthenticeerde aanroeper naar een door hem ingevoerd adres laat verzenden (de verificatie bij registratie, het opnieuw verzenden daarvan, de link voor wachtwoordherstel), worden daarnaast beperkt tot 5 per uur per ontvangstadres, ongeacht van welk IP-adres de aanvragen komen. Daarboven wordt een nieuwe registratie- of herstelaanvraag voor het adres geweigerd en verzendt opnieuw verzenden niets, tot het uur is verstreken.
Wat een afgeremde client terugkrijgt
Een afgeremde REST API- of aanmeldaanvraag geeft 429 terug, samen met headers die de client vertellen wanneer hij het opnieuw moet proberen:
| Header | Betekenis |
|---|---|
Retry-After | Seconden die vóór een nieuwe poging moeten worden gewacht. |
X-RateLimit-Limit | Het aantal aanvragen dat in het tijdvenster is toegestaan. |
X-RateLimit-Remaining | Aanvragen die in het huidige tijdvenster nog zijn toegestaan. |
X-RateLimit-Reset | Wanneer het tijdvenster wordt teruggezet, als Unix-tijdstempel (seconden). |
Bouw clients zo dat ze deze headers respecteren. Wacht bij een 429 op Retry-After en probeer het dan opnieuw, in plaats van meteen door te lussen. Door X-RateLimit-Remaining te lezen kan een net gedragende client vaart minderen voordat hij wordt afgeremd. Behandel de headers als de maatgevende limiet; de precieze getallen kunnen veranderen, en een client die ze leest, past zich automatisch aan.
Machine-to-machine-tokenverzoeken
Tokens uit de client-credentials-grant worden apart begrensd, per client in plaats van per IP-adres: het token-eindpunt bedient ook interactieve aanmeldingen, en één dienst die zich misdraagt mag niet de aanmeldingen afremmen van iedereen die zijn netwerk deelt. Het contingent hangt af van uw abonnement:
| Niveau | Tokenverzoeken per minuut, per client |
|---|---|
| Trial | 30 |
| Free | 60 |
| Essential | 1.200 |
| Advanced | 6.000 |
| Pro | 30.000 |
Een client die boven zijn limiet komt, krijgt 429 met een Retry-After-header en de OAuth-fout too_many_requests. Interactieve aanmeldingen worden door deze limiet nooit geraakt.
Een dienst die zijn access token cachet en tot vlak voor het verlopen hergebruikt, heeft ongeveer één tokenverzoek per uur nodig en blijft daarmee ver onder het contingent van elk niveau. Wordt de limiet bereikt, dan vraagt de client vrijwel altijd voor elke API-aanroep een nieuw token aan; herstel in dat geval het cachen in plaats van een hogere limiet aan te vragen. De instapniveaus hebben daarnaast een maandelijks tokenbudget; beide limieten zijn gedocumenteerd onder API's.
Wat op deze manier niet wordt begrensd
- Accountvergrendeling en IP-blokkades door herhaald mislukte aanmeldingen zijn een ander mechanisme, geconfigureerd onder Beveiliging en opgeheven onder Monitoring → Snelheidslimieten & geblokkeerde IP's. Die blokkeren een bepaalde IP of vergrendelen een bepaald account voor een langere, instelbare periode; het afremmen van aanvragen vertraagt alleen een golf aanvragen.
- Object- en omvangslimieten (maximumaantal gebruikers, applicaties, verbindingen, beleidsregels, netwerkzones, leden van het beheerdersteam) worden bepaald door uw abonnement en licentie, niet door de aanvraagsnelheid. Zie Abonnementen & add-ons.
Verwant
- Bedreigingsbeveiliging, over rate limiting per IP, brute-force-beveiliging, de detectie van gelekte wachtwoorden en de botdetectie op het aanmeldoppervlak.
- Snelheidslimieten & geblokkeerde IP's, voor het bekijken en vrijgeven van geblokkeerde clients.
- Abonnementen & add-ons, voor objectlimieten per niveau.
- API's, voor het verkrijgen en gebruiken van tokens voor de REST API.