HTTP Reporting-Endpoints Header

Der HTTP-Header Reporting-Endpoints ist ein Response-Header und die moderne Alternative zu Report-To. Er verwendet Structured Fields Syntax für einfachere Konfiguration von Browser-Error-Reporting-Endpoints für CSP-Violations, Network-Errors und Deprecations.

Typ

Response-Header

Syntax

Der Header definiert benannte Endpoints mit Structured Fields Format.

http 
Reporting-Endpoints: default="https://reports.example.com/api"
Reporting-Endpoints: csp="https://reports.example.com/csp", network="https://reports.example.com/net"

Direktiven

Die Direktiven definieren Endpoint-Namen und zugehörige URLs.

<endpoint-name>="<url>"
Benannter Endpoint mit vollständiger URL für Report-Versand. Name wird von anderen Headers wie CSP referenziert.
default
Standard-Endpoint für Reports ohne spezifische Gruppe. Wird verwendet, wenn kein anderer Endpoint definiert ist.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für den Reporting-Endpoints-Header.

Beispiel 1 Single Default Reporting-Endpoint

http 
GET /api/users HTTP/1.1
Host: api.example.com

Server konfiguriert Standard-Endpoint für alle Error-Reports.

http 
HTTP/1.1 200 OK
Content-Type: application/json
Reporting-Endpoints: default="https://monitoring.example.com/reports"

{"users": [...]}

Browser sendet alle Fehlerberichte an konfigurierten Default-Endpoint.

Beispiel 2 Separate Endpoints für CSP und Deprecations

http 
HTTP/1.1 200 OK
Content-Type: text/html
Reporting-Endpoints: csp-endpoint="https://security.example.com/csp", deprecation-endpoint="https://monitoring.example.com/deprecations"
Content-Security-Policy: default-src 'self'; report-to csp-endpoint

<!DOCTYPE html>...

CSP-Violations gehen an Security-Team, Deprecation-Warnings an Monitoring.

Beispiel 3 Migration von Report-To zu Reporting-Endpoints

http 
HTTP/1.1 200 OK
Report-To: {"group":"default","max_age":86400,"endpoints":[{"url":"https://reports.example.com/api"}]}
Reporting-Endpoints: default="https://reports.example.com/api"

Beide Headers für Kompatibilität mit alten und neuen Browsern.

Reporting Configuration Flow

Reporting-Endpoints Konfiguration und Error-Versand

Vorteile für die Systemarchitektur

Reporting-Endpoints bietet einfachere Syntax als Report-To für moderne Browser.

  • Simplified Configuration: Structured Fields Syntax ist lesbarer als JSON in Report-To
  • Granulares Routing: Unterschiedliche Error-Typen können an spezialisierte Monitoring-Systeme gesendet werden
  • Browser-Native Monitoring: Keine Client-Side JavaScript-Libraries für Error-Tracking nötig

Spezifikation

Reporting API v1 (W3C Working Draft) https://w3c.github.io/reporting/#header

Weitere Spezifikationen

Report-To Header, Content-Security-Policy Header