File: xfocsp-error-report-ping.rst

package info (click to toggle)
firefox 134.0.2-3
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 4,345,684 kB
  • sloc: cpp: 7,244,582; javascript: 6,236,669; ansic: 3,654,775; python: 1,359,774; xml: 618,542; asm: 426,944; java: 183,315; sh: 66,206; makefile: 19,398; perl: 13,009; objc: 12,453; yacc: 4,583; cs: 3,846; pascal: 2,989; 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>`