O cliente precisa fazer login para ter acesso à rede.
Quando usar
Portais cativos em Wi-Fi de hotéis e aeroportos.
Causas comuns e soluções
O 511 é feito para captive portals: o Wi-Fi de hotel, aeroporto ou café que intercepta o tráfego até você fazer login ou aceitar os termos. O portal deve responder 511 com um link de login, em vez de se passar pelo site que você pediu. Os sistemas operacionais detectam portais buscando URLs conhecidas, como captive.apple.com ou connectivitycheck.gstatic.com/generate_204, e abrem uma janela de login quando a resposta é inesperada.
O HTTPS não pode ser interceptado de forma limpa, então em redes com portal você geralmente vê erros de certificado em vez de um 511; abrir um site em http:// puro, como neverssl.com, faz aparecer a página de login. Caches nunca devem armazenar um 511, e as aplicações devem tratá-lo como um problema de rede, não como erro de API. Seus próprios servidores de origem nunca devem enviá-lo.
Erro do servidor (5xx)
Os códigos 5xx são erros do servidor: a requisição pode estar certa, mas o servidor ou algo por trás dele falhou. Vale a pena configurar alertas para eles.
Como fica
HTTP/1.1 511 Network Authentication RequiredComo enviar
| Node.js / Express | res.status(511).end() |
|---|---|
| Python / Flask | return '', 511 |
| nginx | return 511; |
Como verificar
curl -s -o /dev/null -w "%{http_code}\n" https://example.com/