El cliente debe iniciar sesión para obtener acceso a la red.
Cuándo usarlo
Portales cautivos en el wifi de hoteles y aeropuertos.
Causas habituales y soluciones
511 está pensado para los portales cautivos: el wifi de hoteles, aeropuertos o cafeterías que intercepta el tráfico hasta que inicias sesión o aceptas las condiciones. El portal debería responder 511 con un enlace de inicio de sesión en lugar de suplantar el sitio que pediste. Los sistemas operativos detectan los portales solicitando URL conocidas, como captive.apple.com o connectivitycheck.gstatic.com/generate_204, y abren una ventana de inicio de sesión cuando la respuesta no es la esperada.
HTTPS no se puede interceptar limpiamente, así que en las redes con portal sueles ver errores de certificado en lugar de un 511; abrir un sitio http:// sin cifrar, como neverssl.com, hace que aparezca la página de inicio de sesión. Las cachés nunca deben guardar un 511, y las aplicaciones deberían tratarlo como un problema de red, no como un error de la API. Tus propios servidores de origen nunca deberían enviarlo.
Error del servidor (5xx)
Los códigos 5xx son errores del servidor: puede que la solicitud sea correcta, pero el servidor o algo detrás de él ha fallado. Conviene configurar alertas para ellos.
Cómo se ve
HTTP/1.1 511 Network Authentication RequiredCómo enviarlo
| Node.js / Express | res.status(511).end() |
|---|---|
| Python / Flask | return '', 511 |
| nginx | return 511; |
Cómo comprobarlo
curl -s -o /dev/null -w "%{http_code}\n" https://example.com/