Le client doit se connecter pour accéder au réseau.
Quand l’utiliser
Portails captifs des Wi-Fi d’hôtels et d’aéroports.
Causes courantes et solutions
511 est destiné aux portails captifs : le Wi-Fi d’un hôtel, d’un aéroport ou d’un café qui intercepte le trafic jusqu’à ce que vous vous connectiez ou acceptiez les conditions. Le portail doit répondre 511 avec un lien de connexion au lieu de se faire passer pour le site demandé. Les systèmes d’exploitation détectent les portails en récupérant des URL connues comme captive.apple.com ou connectivitycheck.gstatic.com/generate_204, et ouvrent une fenêtre de connexion quand la réponse est inattendue.
HTTPS ne peut pas être intercepté proprement : sur les réseaux à portail, vous voyez donc généralement des erreurs de certificat plutôt qu’un 511 ; ouvrir un site en http:// simple comme neverssl.com fait apparaître la page de connexion. Les caches ne doivent jamais stocker un 511, et les applications doivent le traiter comme un problème réseau, pas comme une erreur d’API. Vos propres serveurs d’origine ne devraient jamais l’envoyer.
Erreur serveur (5xx)
Les codes 5xx sont des erreurs serveur : la requête est peut-être correcte, mais le serveur ou un composant derrière lui a échoué. Ils méritent une alerte.
À quoi ça ressemble
HTTP/1.1 511 Network Authentication RequiredComment l’envoyer
| Node.js / Express | res.status(511).end() |
|---|---|
| Python / Flask | return '', 511 |
| nginx | return 511; |
Comment le vérifier
curl -s -o /dev/null -w "%{http_code}\n" https://example.com/