HTTP-заголовок Reporting-Endpoints ответа позволяет администраторам веб-сайтов указывать одну или несколько конечных точек, на которые можно отправлять отчёты, создаваемые Reporting API.

Конечные точки можно использовать, например, для отправки отчётов о сбоях, отчётов об устаревании, отчётов о нарушениях политики безопасности содержимого (CSP), отчётов Cross-Origin-Opener-Policy и так далее.

Синтаксис

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

<endpoint>

Конечная точка для отчётов в формате <endpoint-name>="<URL>". Конечные точки должны содержать допустимые URI в строках в кавычках (например, my-endpoint="https://example.com/reports"); небезопасные конечные точки игнорируются. Можно указать список конечных точек, разделённых запятыми.

Описание

Заголовок Reporting-Endpoints определяет соответствие между именем конечной точки и URL-адресом.

Это имя можно использовать для указания конечной точки, на которую следует отправлять отчёты о нарушениях политик, в некоторых HTTP-заголовках. Например, Content-Security-Policy позволяет указать имя конечной точки для отправки отчётов в директиве report-to, а ключ endpoints выполняет ту же функцию для нарушений Integrity-Policy.

Конечная точка для отчётов по умолчанию

Конечная точка для отчётов по умолчанию — это отчёт с именем "default", как показано ниже:

Reporting-Endpoints: default="https://example.com/reports"

Она может использоваться как конечная точка для отчётов в случаях, когда HTTP-заголовок, инициирующий отправку отчёта, не предусматривает механизм указания конечной точки, например заголовок Permissions-Policy. Её также можно использовать для отчётов, с которыми вообще не связан HTTP-заголовок, например для отчётов об устаревании.

Примеры

Настройка конечной точки для отчётов о нарушениях CSP

В следующем примере показано, как заголовок ответа Reporting-Endpoints используется вместе с заголовком Content-Security-Policy, чтобы указать, куда отправляются отчёты о нарушениях CSP:

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

Указание нескольких конечных точек для отчётов

Можно указать несколько конечных точек для разных типов отчётов о нарушениях.

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

Спецификации

Совместимость с браузерами

См. также

• Reporting API
• Руководство по политике безопасности содержимого (CSP)
• Заголовок Content-Security-Policy
• Директива report-to