]> git.donarmstrong.com Git - ca-certificates.git/blob - debian/README.Debian
4e44347114af1d94e78200fa8be2d83519aded87
[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 certificate authorities whose certificates are included
8 in this package are not in any way audited for trustworthiness and RFC
9 3647 compliance, and that full responsibility to assess them belongs to
10 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