man/certmgr.1

   1 .\"
   2 .\" certmgr manual page.
   3 .\" Copyright 2004 Novell
   4 .\" Author:
   5 .\"   Sebastien Pouliot <sebastien@ximian.com>
   6 .\"
   7 .TH Mono "certmgr"
   8 .SH NAME
   9 certmgr \- Mono Certificate Manager (CLI version)
  10 .SH SYNOPSIS
  11 .PP
  12 .B certmgr [action] [object type] [options] store [filename]
  13 or
  14 .B certmgr -ssl [options] url
  15 .SH DESCRIPTION
  16 This tool allow to add, remove or extract certificates, certificate revocation
  17 lists (CRL) or certificate trust lists (CTL) to/from a certificate store.
  18 Certificate stores are used to build and validate certificate chains for
  19 Authenticode(r) code signing validation and SSL server certificates.
  20 .SH ACTIONS
  21 .TP
  22 .I "-add"
  23 Add a certificate, CRL or CTL to specified store.
  24 .TP
  25 .I "-del"
  26 Remove a certificate, CRL or CTL from specified store.
  27 .TP
  28 .I "-put"
  29 Copy a certificate, CRL or CTL from a store to a file.
  30 .TP
  31 .I "-ssl"
  32 Download and add the certificates from a SSL session. You'll be asked to
  33 confirm the addition of every certificate received from the server. Note
  34 that SSL/TLS protocols do not requires a server to send the root certificate.
  35 This action assume an certificate (-c) object type and will import the
  36 certificates in appropriate stores (i.e. server certificate in the
  37 OtherPeople store, the root certificate in the Trust store, any other
  38 intermediate certificates in the IntermediateCA store).
  39
  40 .SH OBJECT TYPES
  41 .TP
  42 .I "-c", "-cert", "-certificate"
  43 Add, Delete or Put certificates. That is the specified file must/will contains
  44 X.509 certificates in DER binary encoding.
  45 .TP
  46 .I "-crl"
  47 Add, Delete or Put certificate revocation lists (CRL). That is the specified
  48 file must/will contains X.509 CRL in DER binary encoding.
  49 .TP
  50 .I "-ctl"
  51 Add, Delete or Put certificate trust lists (CRL). UNSUPPORTED.
  52
  53 .SH OPTIONS
  54 .TP
  55 .I "-m"
  56 Use the machine's certificate stores (instead of the default user's stores).
  57 .TP
  58 .I "-v"
  59 More details displayed on the console.
  60 .TP
  61 .I "-help", "-h", "-?", "/?"
  62 Display help about this tool.
  63
  64 .SH FILES
  65 .B WARNING: This details the current behavior of Mono and could change between releases.
  66 The only safe way to interact with certificate stores is to use the certmgr
  67 tool. The current releases of Mono keeps all the user certificate stores in
  68 separates directories under
  69 .I ~/.config/.mono/certs/
  70 .TP
  71 For example the trusted root certificates for a user would be kept under
  72 .I ~/.config/.mono/certs/Trust/
  73 .TP
  74 Certificates files are kept in DER (binary) format (extension .cer).
  75 .TP
  76 The filenames either starts with
  77 .I tbp
  78 (thumbprint) or
  79 .I ski
  80 (subject key identifier).
  81 .TP
  82 The rest of the filename is the base64-encoded value (tbp or ski).
  83
  84 .SH EXAMPLES
  85 .TP
  86 .B certmgr -ssl https://www.verisign.com
  87 Import certificates from www.verisign.com used for HTTP over SSL. See KNOWN
  88 ISSUES (MD2) if you're downloading from www.verisign.com.
  89 .TP
  90 .B certmgr -ssl ldaps://www.nldap.com:636
  91 Import the certificates from www.nldap.com used for secure LDAP. This works
  92 even if we don't know how to speak LDAP because we stop the communication
  93 shortly after the SSL handshake (which gives us the certificate).
  94
  95 .SH KNOWN ISSUES
  96 .TP
  97 .B MD2
  98 Some Certificate Authorities (CA) old root certificates use the MD2 hash
  99 algorithm. MD2 is old enough not to be part of the standard .NET framework.
 100 This makes it impossible to validate a digital signature made with MD2. For
 101 this reason MD2 is included in the Mono.Security.dll assembly. However the
 102 machine.config file must be updated so the OID for MD2 is known at runtime.
 103
 104 To correct this insert the following XML snippet inside the <configuration>
 105 element of your machine.config file.
 106   <mscorlib>\r
 107     <cryptographySettings>\r
 108       <cryptoNameMapping>\r
 109         <cryptoClasses>\r
 110           <cryptoClass monoMD2="Mono.Security.Cryptography.MD2Managed, Mono.Security, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=0738eb9f132ed756" />\r
 111         </cryptoClasses>\r
 112         <nameEntry name="MD2" class="monoMD2" />\r
 113       </cryptoNameMapping>\r
 114       <oidMap>\r
 115         <oidEntry OID="1.2.840.113549.2.2" name="MD2" />\r
 116       </oidMap>\r
 117     </cryptographySettings>\r
 118   </mscorlib>
 119
 120 .SH AUTHOR
 121 Written by Sebastien Pouliot
 122 .SH COPYRIGHT
 123 Copyright (C) 2004 Novell.
 124 .SH MAILING LISTS
 125 Visit http://mail.ximian.com/mailman/mono-list for details.
 126 .SH WEB SITE
 127 Visit: http://www.go-mono.com for details
 128 .SH SEE ALSO
 129 .BR makecert(1), setreg(1)