Merge branch 'nodiscc-improvements-misc' into master
[user-js.git] / CAs.md
blob33a9dc1ebea16e74151b9f08a93b6b9223744abe
1 # Limiting trust in Certificate Authorities
4 It all started when I read [this blog post][5]...
6 So another part of my browser hardening was to somehow reduce the number of CAs trusted by my browser. First I thought I would sniff all the HTTPS connections and extract the certificates from there, to get the list of CAs I **really** need.
8 Then I came up with an better idea. I'd use [certpatrol](http://patrol.psyced.org/) to record the certs from the HTTPS sites I visit. There was just one problem, certpatrol only stores the fingerprint of the issuer cert, which is usually a [intermediate CA](https://en.wikipedia.org/wiki/Intermediate_certificate_authorities). So I needed to get the root CA of the intermediate CA. The solution for this to use Firefox's *cert8.db* to extract the intermediate CAs and get the issuer (root CA) from there.
10 So I wrapped up a script that uses the certpatrol's SQLite DB and Mozilla's [certutil](https://developer.mozilla.org/en-US/docs/NSS_security_tools/certutil) to establish a list of required root CAs from the HTTPS sites that you have visited.
12 There's also a ready made list built in into the script, that has 28 root CAs in it. With this list of CAs you should already be able to browse the web quite freely. Of course there might also be some geographical variations as to what CAs "are required" for normal use.
14 This script requires that you have the CA certificates in ```/usr/share/ca-certificates/mozilla``` (see <https://packages.debian.org/search?keywords=ca-certificates>). Red Hat based systems have a different model for this, so the script doesn't currently work on those (see [#140](https://github.com/pyllyukko/user.js/issues/140)).
16 ## Examples
18 **Do note**, that in order for all this to work, you **MUST** remove or rename Firefox's default CA list that is stored inside ```libnssckbi.so``` as described [here][5].
20 ### Check the current list of CAs in cert8.db
22 ````
23 cas.sh -P ~/.mozilla/firefox/XXXXXXXX.current_profile -r
24 ````
26 ### Import CAs
28 First check which CAs would be imported (dry-run):
30 ````
31 cas.sh -p ~/.mozilla/firefox/XXXXXXXX.reference_profile -A
32 ````
34 Then import the required CAs to new profile:
36 ````
37 cas.sh -p  ~/.mozilla/firefox/XXXXXXXX.reference_profile -P ~/.mozilla/firefox/XXXXXXXX.new_profile -a
38 ````
40 ### Verify that it worked
42 After you have run the script, verify from Firefox's [certificate settings](https://support.mozilla.org/en-US/kb/advanced-settings-browsing-network-updates-encryption?redirectlocale=en-US&redirectslug=Options+window+-+Advanced+panel#w_certificates-tab), that the list is indeed limited:
44 ![Firefox certificates](./screenshots/firefox_certificate_settings-1.png)
46 ## The default list
48 This is the default CA list, that you can use. It should be enough for basic use for the most biggest/popular sites. Of course this still depends on where you are located and what sites/services/etc. you use. If you know some popular site, that is not accessible with this root CA list, please let me know and I'll consider adding it to the list.
50 | Root CA                                                       | Used by                       |
51 | ------------------------------------------------------------- | ----------------------------- |
52 | AddTrust External CA Root                                     | https://www.debian.org/       |
53 | Baltimore CyberTrust Root                                     |                               |
54 | COMODO Certification Authority                                |                               |
55 | Deutsche Telekom Root CA 2                                    |                               |
56 | DigiCert High Assurance EV Root CA                            | https://www.facebook.com/     |
57 | DigiCert Global Root CA                                       | https://duckduckgo.com/       |
58 | Entrust.net Secure Server Certification Authority             |                               |
59 | Entrust.net Certification Authority (2048)                    |                               |
60 | [Entrust Root Certification Authority][11]                    | https://www.ssllabs.com/      |
61 | Equifax Secure Certificate Authority                          |                               |
62 | GTE CyberTrust Global Root                                    |                               |
63 | GeoTrust Global CA                                            | https://www.google.com/       |
64 | GeoTrust Primary Certification Authority                      | https://www.robtex.com/       |
65 | GeoTrust Primary Certification Authority - G3                 |                               |
66 | GlobalSign Root CA                                            | https://www.wikipedia.org/    |
67 | Go Daddy Class 2 Certification Authority                      |                               |
68 | Go Daddy Root Certificate Authority - G2                      |                               |
69 | Starfield Class 2 Certification Authority                     | https://tools.ietf.org/       |
70 | StartCom Certification Authority                              |                               |
71 | UTN-USERFirst-Hardware                                        |                               |
72 | ValiCert Class 2 Policy Validation Authority                  |                               |
73 | VeriSign Class 3 Public Primary Certification Authority - G3  | https://www.mysql.com/        |
74 | VeriSign Class 3 Public Primary Certification Authority - G5  | https://twitter.com/          |
75 | [thawte Primary Root CA][7]                                   |                               |
76 | [thawte Primary Root CA - G3][7]                              |                               |
77 | SecureTrust CA                                                |                               |
78 | QuoVadis Root CA 2                                            | https://supportforums.cisco.com/ |
79 | DST Root CA X3                                                | [Let's Encrypt](https://letsencrypt.org/) |
82 ### How to use the default list
84 Import the default CA list with:
86 ````
87 cas.sh -C -P ~/.mozilla/firefox/XXXXXXXX.new_profile -a
88 ````
90 [5]: https://blog.torproject.org/blog/life-without-ca
91 [7]: https://www.thawte.com/roots/
92 [11]: https://www.entrust.com/products/developer-api-standards/