summaryrefslogtreecommitdiffstats
path: root/application/basilisk/base/content/docs/sslerrorreport/dataformat.rst
blob: f69dc74170020b1b39bafd293cc8fc1ffc55ca33 (plain)
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
.. _sslerrorreport_dataformat:

==============
Payload Format
==============

An example report::

  {
    "hostname":"example.com",
    "port":443,
    "timestamp":1413490449,
    "errorCode":-16384,
    "failedCertChain":[
      ],
    "userAgent":"Mozilla/5.0 (X11; Linux x86_64; rv:36.0) Gecko/20100101 Firefox/36.0",
    "version":1,
    "build":"20141022164419",
    "product":"Firefox",
    "channel":"default"
  }

Where the data represents the following:

"hostname"
  The name of the host the connection was being made to.

"port"
  The TCP port the connection was being made to.

"timestamp"
  The (local) time at which the report was generated. Seconds since 1 Jan 1970,
  UTC.

"errorCode"
  The error code. This is the error code from certificate verification. Here's a small list of the most commonly-encountered errors:
  https://wiki.mozilla.org/SecurityEngineering/x509Certs#Error_Codes_in_Firefox
  In theory many of the errors from sslerr.h, secerr.h, and pkixnss.h could be encountered. We're starting with just MOZILLA_PKIX_ERROR_KEY_PINNING_FAILURE, which means that key pinning failed (i.e. there wasn't an intersection between the keys in any computed trusted certificate chain and the expected list of keys for the domain the user is attempting to connect to).

"failedCertChain"
  The certificate chain which caused the pinning violation (array of base64
  encoded PEM)

"user agent"
  The user agent string of the browser sending the report

"build"
  The build ID

"product"
  The product name

"channel"
  The user's release channel