407 Proxy Authentication Required

Verwendung

Trifft ein Fehler 407 Proxy Authentication Required ein, weiß der Client, dass gültige Anmeldedaten erforderlich sind, bevor er über den Proxy auf die angeforderte Ressource zugreifen kann. Das ähnelt der Antwort 401 Unauthorized, und der Client verwendet dieselben Authentifizierungsprotokolle.

Der Server gibt den Header Proxy-Authenticate zurück, um die zulässigen Verfahren anzugeben.

SEO-Auswirkung

Suchmaschinen wie Google indexieren keine URL, die den Status 407 Proxy Authentication Required zurückgibt. Zuvor indexierte URLs, die diesen Statuscode zurückgeben, werden aus den Suchergebnissen entfernt.

Beispiel

Der Client fordert eine Ressource an, und der Server antwortet mit 407 Proxy Authentication Required, um anzuzeigen, dass die Ressource hinter einem Proxy geschützt ist. Der Server gibt an, dass er basic-Autorisierung unterstützt. Der Client antwortet mit einem username:password-Paar nach dem basic-Authentifizierungsprotokoll, angegeben im Header Proxy-Authorization. Anschließend überträgt der Server die angeforderte Ressource.

Erste Anfrage

GET /documents/tech-news HTTP/1.1
Host: example.com

Erste Antwort

HTTP/1.1 407 Proxy Authentication Required
Proxy-Authenticate: Basic realm="Documents"

Nächste Anfrage

GET /documents/tech-news HTTP/1.1
Host: example.com
Proxy-Authorization: Basic RXhhbXBsZTphaQ==

Abschließende Antwort

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Length: 25000

<PDF document included in message body>

Behebung

Ein 407 Proxy Authentication Required bedeutet, dass der Proxy-Server gültige Anmeldedaten benötigt, bevor er die Anfrage weiterleitet.

Prüfen Sie den Header Proxy-Authenticate in der Antwort. Dieser Header gibt das erforderliche Authentifizierungsverfahren an (Basic, Digest, NTLM, Negotiate). Passen Sie die Client-Konfiguration an das erwartete Verfahren an. Untersuchen Sie den Header mit den Browser-DevTools oder mit curl -v über den Proxy.

Konfigurieren Sie die Proxy-Anmeldedaten im Client. Hinterlegen Sie Proxy-Benutzername und -Passwort in den Proxy-Einstellungen des Browsers, in der Anwendungskonfiguration oder in Umgebungsvariablen. Betten Sie die Anmeldedaten bei Kommandozeilenwerkzeugen in die Proxy-URL ein:

export HTTP_PROXY=http://user:pass@proxy:8080
export HTTPS_PROXY=http://user:pass@proxy:8080

Übermitteln Sie die Anmeldedaten bei programmatischen HTTP-Clients im Header Proxy-Authorization.

Überprüfen Sie Proxy-Benutzername und -Passwort. Ein falsches oder abgelaufenes Anmeldedatenpaar löst diesen Fehler aus. Bestätigen Sie die Werte mit der Netzwerkadministration. NTLM- und Kerberos-Proxys erfordern Anmeldedaten eines Domänenkontos. Stellen Sie sicher, dass das Domänenpräfix (z. B. DOMAIN\username) enthalten ist.

Prüfen Sie, ob ein transparenter Proxy den Verkehr abfängt. Manche Unternehmensnetzwerke leiten den gesamten Verkehr ohne explizite Client-Konfiguration über einen transparenten Proxy. Eine VPN-Verbindung oder eine geänderte Netzwerkrichtlinie führt eine Proxy-Authentifizierung ein, wo zuvor keine bestand. Prüfen Sie die Proxy-Einstellungen des Systems (Windows: Internetoptionen, macOS: Systemeinstellungen > Netzwerk > Proxys, Linux: /etc/environment oder die Proxy-Einstellungen der Desktop-Umgebung).

Leeren Sie zwischengespeicherte Proxy-Anmeldedaten. Browser und Betriebssysteme speichern Tokens der Proxy-Authentifizierung zwischen. Veraltete zwischengespeicherte Anmeldedaten führen nach einer Passwortänderung zu wiederholten 407-Antworten. Leeren Sie den Anmeldedaten-Cache (Anmeldeinformationsverwaltung unter Windows, Schlüsselbundverwaltung unter macOS).

Prüfen Sie, ob der Proxy die Zieldomain zulässt. Manche Proxy-Server beschränken den Zugriff auf freigegebene Domains oder URL-Kategorien. Ist das Ziel durch eine Richtlinie blockiert, gibt der Proxy 407 zurück, um eine erneute Authentifizierung zu erzwingen, selbst wenn die Anmeldedaten gültig sind. Klären Sie die Allow-List des Proxys mit der Netzwerkadministration.

Wenden Sie sich für den Proxy-Zugang an die Netzwerkadministration. Unternehmens- oder Institutions-Proxys erfordern die Einrichtung eines Kontos. Fordern Sie Zugangsdaten an, bestätigen Sie Proxy-Adresse und -Port und prüfen Sie das verwendete Authentifizierungsverfahren.

Code-Referenzen

.NET

HttpStatusCode.ProxyAuthenticationRequired

Rust

http::StatusCode::PROXY_AUTHENTICATION_REQUIRED

Rails

:proxy_authentication_required

http.StatusProxyAuthRequired

Symfony

Response::HTTP_PROXY_AUTHENTICATION_REQUIRED

Python3.5+

http.HTTPStatus.PROXY_AUTHENTICATION_REQUIRED

Java

java.net.HttpURLConnection.HTTP_PROXY_AUTH

Apache HttpComponents Core

org.apache.hc.core5.http.HttpStatus.SC_PROXY_AUTHENTICATION_REQUIRED

Angular

@angular/common/http/HttpStatusCode.ProxyAuthenticationRequired