testssl.sh/etc/README.md

38 lines
2.4 KiB
Markdown
Raw Normal View History

2016-03-13 20:38:06 +01:00
### Certificate stores
2016-03-13 20:38:06 +01:00
The certificate trust stores were retrieved from
2016-03-13 20:38:06 +01:00
* **Linux:** Copied from an up-to-date Debian Linux machine
* **Mozilla:** https://curl.haxx.se/docs/caextract.html
* **Java:** extracted (``keytool -list -rfc -keystore <file> | grep -E -v '^$|^\*\*\*\*\*|^Entry |^Creation |^Alias '``) from a JRE 8 from https://jdk.java.net/ (previously JRE keystore extracted from $JAVA_HOME/jre/lib/security/cacerts using Linux)
* **Microsoft:** Following command pulls all certificates from Windows Update services: ``CertUtil -syncWithWU -f -f . `` (see also http://aka.ms/RootCertDownload, https://technet.microsoft.com/en-us/library/dn265983(v=ws.11).aspx#BKMK_CertUtilOptions).
* **Apple:**
1. __System:__ from Apple OS X keychain app. Open Keychain Access utility, i.e.
In the Finder window, under Favorites --> "Applications" --> "Utilities"
2017-09-18 23:32:35 +02:00
(OR perform a Spotlight Search for Keychain Access)
2016-03-25 11:52:23 +01:00
--> "Keychain Access" (2 click). In that window --> "Keychains" --> "System"
--> "Category" --> "All Items"
2017-09-18 23:32:35 +02:00
Select all CA certificates except for Developer ID Certification Authority, "File" --> "Export Items"
2. __Internet:__ Pick the latest subdir from https://opensource.apple.com/source/security_certificates/. They are in DER format despite their file extension.
2016-03-13 20:38:06 +01:00
Google Chromium uses basically the trust stores above, see https://www.chromium.org/Home/chromium-security/root-ca-policy.
If you want to check trust against e.g. a company internal CA you need to use ``./testssl.sh --add-ca companyCA1.pem,companyCA2.pem <further_cmds>`` or ``ADDTL_CA_FILES=companyCA1.pem,companyCA2.pem ./testssl.sh <further_cmds>``.
#### Further files
2016-03-13 20:38:06 +01:00
2017-08-13 11:32:24 +02:00
* ``tls_data.txt`` contains lists of cipher suites and private keys for sockets-based tests
2017-08-04 15:10:41 +02:00
* ``cipher-mapping.txt`` contains information about all of the cipher suites defined for SSL/TLS
2017-02-24 17:55:20 +01:00
* ``ca_hashes.txt`` is used for HPKP test in order to have a fast comparison with known CAs. Use
2017-09-18 23:32:35 +02:00
``~/utils/create_ca_hashes.sh`` for an update
2017-02-24 17:55:20 +01:00
* ``common-primes.txt`` is used for LOGJAM and the PFS section
2017-02-24 17:55:20 +01:00
2019-04-23 10:26:30 +02:00
* ``client-simulation.txt`` / ``client-simulation.wiresharked.txt`` are as the names indicate data for the client simulation.
The first one is derived from ``~/utils/update_client_sim_data.pl``, and manually edited to sort and label those we don't want.
The second file provides more client data retrieved from wireshark captures and some instructions how to do that yourself.