Les headers de la Reporting API, Reporting-Endpoints et Report-To

Ces headers indiquent au navigateur où envoyer les reports. Vous déclarez un ou plusieurs endpoints nommés, puis une politique référence un endpoint par son nom pour y router ses reports. Le header moderne est Reporting-Endpoints ; Report-To est la forme historique, conservée surtout pour le Network Error Logging.

Reporting-Endpoints: default="https://<Endpoint-ID>.report.centralcsp.com"

Pages de cette section

Comment une politique pointe vers un endpoint

Un header ne fait que déclarer les endpoints. Une politique en référence ensuite un par son nom, et chaque politique a sa propre syntaxe pour cela :

• CSP utilise la directive report-to : report-to csp-endpoint.
• COOP, COEP et Permissions-Policy utilisent un paramètre report-to= sur leur header, par exemple Cross-Origin-Opener-Policy: same-origin; report-to="coop-endpoint".
• Integrity-Policy utilise une directive endpoints=().
• Les types de report implicites (deprecation, intervention, crash) n'ont pas de syntaxe par politique ; ils vont à l'endpoint nommé default.

Quelle que soit la syntaxe employée par une politique, le nom doit correspondre à un nom déclaré par Reporting-Endpoints (ou Report-To) sur la même réponse, sinon les reports ne vont nulle part. Voir Politiques pour chacune.

Étapes suivantes

• Voyez comment chaque politique pointe vers un endpoint dans Politiques.
• Comparez les deux headers dans Report-To vs Reporting-Endpoints.