Límites de tasa
Cómo se limitan las solicitudes por IP de cliente, qué recibe un cliente limitado (HTTP 429, cabeceras de límite) y dónde están los límites de objetos.
Para mantener el servicio con capacidad de respuesta y frenar los abusos, la plataforma limita cuántas solicitudes puede hacer un solo cliente en una ventana corta de tiempo. Esta página explica la limitación de tasa de solicitudes que se aplica al inicio de sesión, al área de cuenta y a la API REST, qué recibe un cliente limitado y en qué se diferencia de las funciones de protección de cuentas documentadas en otras páginas.
Aquí la limitación de tasa trata del volumen de solicitudes. Es independiente de las defensas de la superficie de inicio de sesión (limitación de tasa por IP, protección contra fuerza bruta, bloqueo de cuentas) tratadas en Protección contra amenazas, y de los límites de objetos por nivel (cuántos usuarios, aplicaciones, etc. puede crear) documentados en Planes y add-ons.
Cómo funciona la limitación de solicitudes
- Las solicitudes se cuentan por dirección IP de cliente, no por usuario ni por sesión, así que un llamante sin autenticar se limita exactamente igual. Un cliente IPv6 se cuenta por su prefijo /64, ya que una conexión suele disponer de todo el prefijo.
- El recuento se comparte en todo el despliegue. Como todos los nodos leen el mismo contador, un cliente no puede colar más solicitudes dirigiéndose a otro nodo.
- Se limita el tráfico de inicio de sesión, de cuenta y de la API REST. Cuando un cliente supera el número de solicitudes permitido en la ventana, las siguientes se rechazan con HTTP 429 (Too Many Requests) hasta que la ventana se renueva. El límite caduca por sí solo: el tráfico normal se reanuda automáticamente en cuanto el cliente reduce el ritmo.
- Una protección aparte, para toda la plataforma, defiende además de las avalanchas de gran volumen (intentos de denegación de servicio) por encima de la ventana por IP.
- Los correos electrónicos que un llamante sin autenticar desencadena hacia una dirección que introduce (verificación de registro, su reenvío, el enlace de restablecimiento de contraseña) se limitan además a 5 por hora por dirección de destinatario, sea cual sea la IP de la que procedan las solicitudes. Por encima de ese límite, se rechaza una nueva solicitud de registro o de restablecimiento para esa dirección, y un reenvío no envía nada, hasta que haya transcurrido la hora.
Qué recibe un cliente limitado
Una solicitud limitada a la API REST o de inicio de sesión devuelve 429 junto con cabeceras que indican al cliente cuándo reintentar:
| Cabecera | Significado |
|---|---|
Retry-After | Segundos que hay que esperar antes de reintentar. |
X-RateLimit-Limit | El número de solicitudes permitidas en la ventana. |
X-RateLimit-Remaining | Solicitudes que aún se permiten en la ventana actual. |
X-RateLimit-Reset | Cuándo se reinicia la ventana, como marca de tiempo Unix (en segundos). |
Construya los clientes de modo que respeten estas cabeceras. Ante un 429, espere el tiempo de Retry-After y reintente, en lugar de repetir en bucle de inmediato. Leer X-RateLimit-Remaining permite a un cliente bien educado bajar el ritmo antes de que se le limite. Trate las cabeceras como el límite autoritativo; las cifras exactas pueden cambiar, y un cliente que las lee se adapta automáticamente.
Solicitudes de token machine-to-machine
Los tokens obtenidos con el grant client credentials se limitan por separado, por cliente en lugar de por dirección IP: el endpoint de token también atiende inicios de sesión interactivos, y un servicio que se comporte mal no debe limitar los inicios de sesión de todos los que comparten su red. El cupo depende de su suscripción:
| Nivel | Solicitudes de token por minuto y cliente |
|---|---|
| Trial | 30 |
| Free | 60 |
| Essential | 1.200 |
| Advanced | 6.000 |
| Pro | 30.000 |
Un cliente que supera su límite recibe 429 con una cabecera Retry-After y el error de OAuth too_many_requests. Los inicios de sesión interactivos nunca se ven afectados por este límite.
Un servicio que almacena en caché su access token y lo reutiliza hasta poco antes de que caduque necesita aproximadamente una solicitud de token por hora y se queda muy por debajo del cupo de cualquier nivel. Alcanzar el límite significa casi siempre que el cliente pide un token nuevo en cada llamada a la API: corrija la caché en lugar de pedir un límite más alto. Los niveles de entrada tienen además un presupuesto mensual de tokens; ambos límites están documentados en APIs.
Qué no se limita de esta manera
- El bloqueo de cuentas y los bloqueos de IP por inicios de sesión fallidos repetidos son un mecanismo distinto, que se configura en Seguridad y se levanta en Monitoring → Límites de tasa e IP bloqueadas. Esos bloquean una IP concreta o una cuenta concreta durante un periodo más largo y configurable; la limitación de solicitudes solo retrasa una ráfaga de peticiones.
- Los límites de objetos y de dimensionamiento (número máximo de usuarios, aplicaciones, conexiones, políticas, zonas de red, miembros del equipo de administración) los determinan su suscripción y su licencia, no la tasa de solicitudes. Consulte Planes y add-ons.
Temas relacionados
- Protección contra amenazas, que trata la limitación de tasa por IP, la protección contra fuerza bruta, la detección de contraseñas filtradas y la detección de bots en la superficie de inicio de sesión.
- Límites de tasa e IP bloqueadas, para revisar y liberar clientes bloqueados.
- Planes y add-ons, para los límites de objetos por nivel.
- APIs, para obtener y utilizar tokens de la API REST.
Tipos de eventos de auditoría
Referencia de todos los tipos de evento que registra el registro de auditoría: identificador, nombre en la consola, gravedad y significado, por categoría.
Tokens
Para qué sirve cada token de ID, de acceso y de refresco, quién valida cuál, cuánto viven, y cómo funcionan la rotación y el almacenamiento seguro.