401 Unauthorized vs 407 Proxy Authentication Required

Cosa significa 401 Unauthorized vs 407?

RFC 9110 accoppia questi codici. Un 401 porta un header WWW-Authenticate e chiede credenziali per il server originario. Un 407 porta un header Proxy-Authenticate e chiede credenziali per il proxy. Le risposte vanno in header diversi: Authorization per il sito e Proxy-Authorization per il proxy.

Confonderli è comune perché entrambi parlano di "autenticazione". Il modo più rapido è guardare il codice stato: 401 significa che sei passato dal proxy.

Com'è a 401 in Python, curl, Node.js e browser?

Lo stesso errore si presenta in modo diverso in ogni strumento. Questi sono i messaggi da cercare nei log:

• Python requests: status_code == 401 con header WWW-Authenticate (sito) contro ProxyError con 407 (proxy)
• curl: HTTP/2 401 dopo un CONNECT riuscito (sito) contro CONNECT tunnel failed, response 407 (proxy)
• API: un JSON come {"message": "Unauthorized"} o un messaggio token invalido

Cosa causa a 401?

Probabilmente prima:

• La pagina o API richiede login o key. Lo chiede il sito, non il proxy.
• Credenziali proxy nel posto sbagliato, ad esempio un header Authorization per il proxy che il sito rifiuta.
• Cookie o token di sessione scaduti in un flusso multi-step.
• Token legato a IP o regione, quindi un’exit nuova lo invalida.

Come diagnostico a 401 passo dopo passo?

1. Conferma il codice: 401 è del sito, 407 del proxy.
2. Fai il test curl qui sotto. Se vedi HTTP/1.1 200 Connection established prima del 401, il proxy va bene.
3. Controlla se lo stesso URL richiede login in un browser normale.
4. In un flusso multi-step, controlla se il 401 compare quando cambia l’IP exit.

# Use the URL that fails; with https://api.ipify.org instead, you test the gateway alone.
# "HTTP/1.1 200 Connection established" first, then the site's own status: the site answered.
curl -v -x http://USERNAME:[email protected]:7777 https://TARGET_URL

# Same test through the SOCKS5 port, with DNS resolved at the exit
curl -v --socks5-hostname gw.crawlrelay.com:7778 --proxy-user USERNAME:PASSWORD https://TARGET_URL

Come risolvo a 401?

• Per problemi proxy (407) metti le credenziali nella URL proxy o nelle impostazioni proxy client, mai in un header Authorization.
• Per API pubbliche con key, registrati sul sito e invia la key come indicato.
• Per sessioni legate a IP, usa sessioni sticky per tutto il flusso.
• Per contenuti dietro login, rispetta i termini del sito prima di automatizzare. Fare scraping di account non tuoi o dati personali protetti è fuori dalla nostra Acceptable Use Policy.

Devo riprovare dopo a 401?

Non riprovare un 401 a occhi chiusi. Chiede qualcosa che la tua richiesta non ha. Aggiorna token o sessione se il tuo flusso ne ha uno, poi prova una volta. Ripetuti 401 significano contenuto non pubblico o accesso terminato.

Come si applica 401 Unauthorized vs 407 a CrawlRelay?

Un proxy HTTP segnala i problemi di credenziali suoi con 407 o tunnel fallito, non con 401. Se vedi 401 usando il gateway CrawlRelay, la richiesta ha raggiunto il sito, focalizzando il problema rapidamente.

Gateway: gw.crawlrelay.com, porta 7777 (HTTP, HTTPS tramite CONNECT) e porta 7778 (SOCKS5). Formato username: USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}. Correlato: 407 Proxy Authentication Required · 403 Forbidden · Sessions guide.