Reporting-Endpoints

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Der HTTP Reporting-Endpoints Antwort-Header erlaubt Website-Administratoren, ein oder mehrere Endpunkte anzugeben, an die Berichte gesendet werden können, die von der Reporting-API erzeugt werden.

Die Endpunkte können beispielsweise als Ziel zum Senden von CSP-Verstoßberichten, Cross-Origin-Opener-Policy Berichten oder anderen allgemeinen Verstößen verwendet werden.

Wenn er zur Meldung von Content Security Policy (CSP) Fehlern verwendet wird, wird der Header in Kombination mit dem Content-Security-Policy Header report-to Directive genutzt. Für weitere Details zum Einrichten der CSP-Berichterstattung lesen Sie die Content Security Policy (CSP) Dokumentation.

Hinweis: Dieser Header ersetzt Report-To zur Deklaration von Endpunkten und sollte bevorzugt verwendet werden.

Header-Typ Antwort-Header
Verbotener Anfrage-Header Nein
CORS-safelisted Antwort-Header Nein

Syntax

http
Reporting-Endpoints: <endpoint>
Reporting-Endpoints: <endpoint>, …, <endpointN>
<endpoint>

Ein Reporting-Endpunkt im Format <endpoint-name>="<URL>". Die Endpunkte müssen gültige URIs in Anführungszeichen sein (z. B. my-endpoint="https://example.com/reports") und nicht-sichere Endpunkte werden ignoriert. Es kann eine durch Kommas getrennte Liste von Endpunkten angegeben werden.

Beispiele

Einrichten eines CSP-Verstoßbericht-Endpunkts

Das folgende Beispiel zeigt, wie der Reporting-Endpoints Antwort-Header in Verbindung mit dem Content-Security-Policy Header verwendet wird, um anzugeben, wohin CSP-Verstoßberichte gesendet werden:

http
Reporting-Endpoints: csp-endpoint="https://example.com/csp-reports"
Content-Security-Policy: default-src 'self'; report-to csp-endpoint

Angabe mehrerer Reporting-Endpunkte

Es ist möglich, mehrere Endpunkte anzugeben, die für verschiedene Arten von Verstoßberichten verwendet werden können.

http
Reporting-Endpoints: csp-endpoint="https://example.com/csp-reports",
                     permissions-endpoint="https://example.com/permissions-policy-reports"

Spezifikationen

Specification
Reporting API
# header-field-registration

Browser-Kompatibilität

Siehe auch