File: xfocsp-error-report-ping.rst

package info (click to toggle)
firefox-esr 128.13.0esr-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 4,230,012 kB
  • sloc: cpp: 7,103,971; javascript: 6,088,450; ansic: 3,653,980; python: 1,212,330; xml: 594,604; asm: 420,652; java: 182,969; sh: 71,124; makefile: 20,747; perl: 13,449; objc: 12,399; yacc: 4,583; cs: 3,846; pascal: 2,973; lex: 1,720; ruby: 1,194; exp: 762; php: 436; lisp: 258; awk: 247; sql: 66; sed: 54; csh: 10
file content (69 lines) | stat: -rw-r--r-- 1,504 bytes parent folder | download | duplicates (16)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

"xfocsp-error-report" ping
==========================

This opt-in ping is sent when an X-Frame-Options error or a CSP: frame-ancestors
happens to report the error. Users can opt-in this by checking the reporting
checkbox. After users opt-in, this ping will be sent every time the error
happens. Users can opt-out this by un-checking the reporting checkbox on the
error page. The client_id and environment are not sent with this ping.

Structure:

.. code-block:: js

    {
      "type": "xfocsp-error-report",
      ... common ping data
      "payload": {
        "error_type": <string>,
        "xfo_header": <string>,
        "csp_header": <string>,
        "frame_hostname": <string>,
        "top_hostname": <string>,
        "frame_uri": <string>,
        "top_uri": <string>,
      }
    }

info
----

error_type
~~~~~~~~~~

The type of what error triggers this ping. This could be either "xfo" or "csp".

xfo_header
~~~~~~~~~~

The X-Frame-Options value in the response HTTP header.

csp_header
~~~~~~~~~~

The CSP: frame-ancestors value in the response HTTP header.

frame_hostname
~~~~~~~~~~~~~~

The hostname of the frame which triggers the error.

top_hostname
~~~~~~~~~~~~

The hostname of the top-level page which loads the frame.

frame_uri
~~~~~~~~~

The uri of the frame which triggers the error. This excludes the query strings.

top_uri
~~~~~~~

The uri of the top-level page which loads the frame. This excludes the query
strings.


See also: :doc:`common ping fields <common-ping>`