]> git.donarmstrong.com Git - ca-certificates.git/blobdiff - debian/README.Debian
Rewrap README.Debian and control
[ca-certificates.git] / debian / README.Debian
index b68b6d129807e32fdea7fdb563517f5b708e3a11..3a64463a1f2aad2b28d4534ead8fa545a8bf3a6a 100644 (file)
@@ -1,43 +1,50 @@
-The Debian Package ca-certificates
+The Debian Package “ca-certificates”
 ----------------------------------
 
-Common CA certificates PEM files, installed in /usr/share/ca-certificates/
-
-It includes the following certificates:
- - spi-inc.org certificate
- - db.debian.org certificate
- - Mozilla builtin CA certificates
- - brasil.gov.br certificate
- - cacert.org certificate
-
-configuration file:
- /etc/ca-certificates.conf
-       - managed by debconf
-   # dpkg-reconfigure ca-certificates
-
- update-ca-certificates will update /etc/ssl/certs
-       make hash symlinks
-       generate ca-certificates.crt (single-file version)
-
-/etc/ssl/certs/ca-certificates.crt will be used by many of the web browsers
-in Debian, including mozilla, when deciding what secure web sites to trust.
-
-For w3m package, it has ssl_ca_path configuration in /etc/w3m/w3mconfig,
-so it works without any configuration.  You can specify 
-/etc/ssl/certs/ca-certificates.crt for ssl_ca_file instead.
-
-
-How certificate will be accepted in ca-certificates package
------------------------------------------------------------
-
- - submit *GPG signed* bug report to ca-certificate with severity normal.
-   the bug report should include
-     - description of the CA
-     - how to obtain CA cert pem or paste it in the bug report
-     - license of the CA certificate
-     - fingerprint and/or hash value of the cert
- - get 2 or 3 recommendation ("seconded" mail) from other people to 
-   the bug report, GPG signed.
-   I won't accept if the CA is requested by only one people.
-   
- -- ukai <ukai@debian.or.jp>, Wed May 18 01:24:57 2005
+This package includes PEM files of CA certificates to allow SSL-based
+applications to check for the authenticity of SSL connections.
+
+Please note that Debian can neither confirm nor deny whether the
+certificate authorities whose certificates are included in this package
+have in any way been audited for trustworthiness or RFC 3647 compliance.
+Full responsibility to assess them belongs to the local system
+administrator.
+
+The CA certificates contained in this package are installed into
+“/usr/share/ca-certificates”.
+
+The configuration file “/etc/ca-certificates.conf” is seeded with
+trust information through Debconf.  Just call “dpkg-reconfigure
+ca-certificates” to adjust the settings.
+
+“update-ca-certificates” will then update “/etc/ssl/certs” which may be
+used by the web browsers in Debian.  It will also generate the hash
+symlinks and generate a single-file version in
+“/etc/ssl/certs/ca-certificates.crt”.
+
+If you want to install local certificate authorities to be implicitly
+trusted, please put the certificate files as single files ending with
+“.crt“ into “/usr/local/share/ca-certificates” and re-run
+“update-ca-certificates”.  If you want to prepare a local package
+of your certificates, you should depend on “ca-certificates“, install
+the PEM files into “/usr/local/share/ca-certificates” as above and call
+“update-ca-certificates” in the package's “postinst“.
+
+How certificates will be accepted into the ca-certificates package
+------------------------------------------------------------------
+
+ Option 1:
+ - File a *GPG-signed* bug report against ca-certificates with
+   *severity normal*.  The bug report must include an attached
+   copy of the PEM certificates of the CA, a link to and a
+   description of the CA, the licence of the CA certificate
+   and signed fingerprint and/or hash values of the certificate.
+ - Get two or three recommendations from other people to the
+   bug report, GPG-signed (preferably from the strong set).
+ - CA certificates will not be accepted if requested by only
+   one person.
+
+ Option 2:
+ - Get it included into Mozilla's trust store.
+ - File a bug against ca-certificates stating this fact.
+