Limitación de frecuencia

​

Intentos de autenticación (antes de la autenticación)

• Solo cuentan las credenciales incorrectas. Las credenciales ausentes (un cliente que nunca envió un token) y las autenticaciones correctas no consumen el cupo; una autenticación correcta restablece el contador de esa IP.
• Valores predeterminados: 10 fallos cada 60 segundos y, después, un bloqueo de 5 minutos para esa IP.
• Loopback (127.0.0.1 / ::1) está exento de forma predeterminada para que las sesiones locales de la CLI no puedan quedar bloqueadas.
• Los contadores se delimitan por clase de credencial, por lo que una avalancha contra una superficie no desplaza a otra. Los ámbitos incluyen el token o la contraseña compartidos del Gateway, los tokens de dispositivo, el emparejamiento de Node, la reaprobación de Node emparejados, los tokens de arranque de dispositivos y la emisión de desafíos de watchOS.

{
  "code": "INVALID_REQUEST",
  "message": "unauthorized: too many failed authentication attempts (retry later)",
  "retryable": true,
  "retryAfterMs": 297000,
  "details": {
    "code": "AUTH_RATE_LIMITED",
    "authReason": "rate_limited",
    "recommendedNextStep": "wait_then_retry"
  }
}

{
  "gateway": {
    "auth": {
      "rateLimit": {
        "maxAttempts": 10,
        "windowMs": 60000,
        "lockoutMs": 300000,
        "exemptLoopback": true
      }
    }
  }
}

​

Conexiones con origen en navegador

​

Webhooks

​

Escrituras del plano de control (protección posterior a la autenticación)

{
  "code": "UNAVAILABLE",
  "message": "rate limit exceeded for config.patch; retry after 35s",
  "retryable": true,
  "retryAfterMs": 34539,
  "details": { "method": "config.patch", "limit": "30 per 60s" }
}

​

Creación de sesiones ACP

Se superó el límite de frecuencia de creación de sesiones ACP para <method>; vuelva a intentarlo después de <n> s.

​

Espera entre reinicios

​

Notas operativas

• Todos los limitadores se almacenan en memoria y funcionan por proceso; varios Gateways no comparten estado. Sustituir el proceso del Gateway borra los contadores que le pertenecen (bloqueos de autenticación, limitación de Webhook y depósitos del plano de control). El periodo de espera entre reinicios sobrevive deliberadamente a los ciclos de reinicio dentro del proceso —eso es precisamente lo que limita— y solo se restablece con el proceso. El límite de sesiones ACP pertenece a su instancia del traductor y se restablece cuando se vuelve a crear esa instancia, no al reiniciar el Gateway.
• Los mapas de depósitos están acotados (límites estrictos de entradas más depuración periódica), por lo que las avalanchas de claves únicas no pueden aumentar la memoria sin límite.
• Cuando un cliente está detrás de un proxy inverso, la IP efectiva es la IP resuelta del cliente; consulte la autenticación de proxy de confianza para saber cómo se validan las cabeceras del proxy antes de que puedan influir en ella.
• La señalización de reintentos varía según la superficie: los limitadores de RPC del Gateway devuelven retryable: true junto con retryAfterMs, el punto de entrada de Webhook usa HTTP 429 con una cabecera Retry-After, y ACP incluye la espera en el mensaje de error. En todos los casos, espere el tiempo indicado antes de volver a intentarlo, en lugar de hacerlo inmediatamente.