]> git.donarmstrong.com Git - ca-certificates.git/blob - debian/README.Debian
Update package description with CA audit clarification
[ca-certificates.git] / debian / README.Debian
1 The Debian Package “ca-certificates”
2 ----------------------------------
3
4 This package includes PEM files of CA certificates to allow SSL-based
5 applications to check for the authenticity of SSL connections.
6
7 Please note that we can neither confirm nor deny whether the certificate
8 authorities whose certificates are included in this package have in any
9 way been audited for trustworthiness or RFC 3647 compliance.  Full
10 responsibility to assess them belongs to the local system administrator.
11
12 The CA certificates contained in this package are installed into
13 “/usr/share/ca-certificates”.
14
15 The configuration file “/etc/ca-certificates.conf” is seeded with
16 trust information through Debconf.  Just call “dpkg-reconfigure
17 ca-certificates” to adjust the settings.
18
19 “update-ca-certificates” will then update “/etc/ssl/certs” which may be
20 used by the web browsers in Debian.  It will also generate the hash
21 symlinks and generate a single-file version in
22 “/etc/ssl/certs/ca-certificates.crt”.
23
24 If you want to install local certificate authorities to be implicitly
25 trusted, please put the certificate files as single files ending with
26 “.crt“ into “/usr/local/share/ca-certificates” and re-run
27 “update-ca-certificates”.  If you want to prepare a local package
28 of your certificates, you should depend on “ca-certificates“, install
29 the PEM files into “/usr/local/share/ca-certificates” as above and call
30 “update-ca-certificates” in the package's “postinst“.
31
32 How certificates will be accepted into the ca-certificates package
33 ------------------------------------------------------------------
34
35  Option 1:
36  - File a *GPG-signed* bug report against ca-certificates with
37    *severity normal*.  The bug report must include an attached
38    copy of the PEM certificates of the CA, a link to and a
39    description of the CA, the licence of the CA certificate
40    and signed fingerprint and/or hash values of the certificate.
41  - Get two or three recommendations from other people to the
42    bug report, GPG-signed (preferably from the strong set).
43  - CA certificates will not be accepted if requested by only
44    one person.
45
46  Option 2:
47  - Get it included into Mozilla's trust store.
48  - File a bug against ca-certificates stating this fact.
49