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