secure/caroot/README

   1 # $FreeBSD$
   2
   3 This directory contains the scripts to update the TLS CA Root Certificates
   4 that comprise the 'root trust store'.
   5
   6 The 'updatecerts' make target should be run periodically by secteam@
   7 specifically when there is an important change to the list of trusted root
   8 certificates included by Mozilla.
   9
  10 It will:
  11         1) Remove the old trusted certificates (cleancerts)
  12         2) Download the latest certdata.txt from Mozilla (fetchcerts)
  13         3) Split certdata.txt into the individual .pem files (updatecerts)
  14
  15 Then the results should manually be inspected (svn status)
  16         1) Any no-longer-trusted certificates should be moved to the
  17         blacklisted directory (svn mv)
  18         2) any newly added certificates will need to be added (svn add)
  19
  20
  21 The following make targets exist:
  22
  23 cleancerts:
  24         Delete the old certificates, run as a dependency of updatecerts.
  25
  26 fetchcerts:
  27         Download the latest certdata.txt from the Mozilla NSS hg repo
  28         See the changelog here:
  29                 https://hg.mozilla.org/projects/nss/log/tip/lib/ckfw/builtins/certdata.txt
  30
  31 updatecerts:
  32         Runs a perl script (MAca-bundle.pl) on the downloaded certdata.txt
  33         to generate the individual certificate files (.pem) and store them
  34         in the trusted/ directory.