NAME

       MakeCert - Create X.509 certificates for test purposes

SYNOPSIS

       makecert [options] certificate

DESCRIPTION

       Create  an  X.509  certificate using the provided informations. This is useful for testing
       Authenticode signatures, SSL and S/MIME technologies.

PARAMETERS

       -# num Specify the certificate serial number.

       -n dn  Specify the subject Distinguished Name (DN).

       -in dn Specify the issuer Distinguished Name (DN).

       -r     Create a self-signed, also called root, certificate.

       -iv pvkfile
              Specify the private key file  (.PVK)  for  the  issuer.  The  private  key  in  the
              specified file will be used to sign the new certificate.

       -ic certfile
              Extract  the  issuer's  name from the specified certificate file - i.e. the subject
              name of the specified certificate becomes the issuer name of the new certificate.

       -in name
              Use the issuer's name from the specified parameter.

       -ik container
              Specify the key container name to be used for the issuer.

       -iky [signature | exchange | #]
              Specify the key number to be used in the provider (when used with -ik).

       -ip provider
              Specify the cryptographic provider to be used for the issuer.

       -ir [localmachine | currentuser]
              Specify the provider will search the user or the machine keys  containers  for  the
              issuer.

       -iy number
              Specify the provider type to be used for the issuer.

       -sv pkvfile
              Specify  the  private  key  file (.PVK) for the subject. The public part of the key
              will be inserted into the created certificate. If non-existant the  specified  file
              will be created with a new key pair (default to 1024 bits RSA key pair).

       -sk container
              Specify the key container name to be used for the subject.

       -sky [signature | exchange | #]
              Specify the key number to be used in the provider (when used with -sk).

       -sp provider
              Specify the cryptographic provider to be used for the subject.

       -sr [localmachine | currentuser]
              Specify  the  provider  will search the user or the machine keys containers for the
              subject.

       -sy number
              Specify the provider type to be used for the issuer.

       -a hash
              Select hash algorithm. Only MD5 and SHA1 algorithms are supported.

       -b date
              The date since when the certificate is valid (notBefore).

       -e date
              The date until when the certificate is valid (notAfter).

       -m number
              Specify the certificate validity period in months. This is added to  the  notBefore
              validity date which can be set with -b or will default to the current date/time.

       -cy [authority|end]
              Basic  constraints.  Select  Authority  or  End-Entity  certificate. Only Authority
              certificates can be used to sign other certificates (-ic). End-Entity can  be  used
              by clients (e.g. Authenticode, S/MIME) or servers (e.g. SSL).

       -h number
              Add a path length restriction to the certificate chain. This is only applicable for
              certificates that have BasicConstraint set to Authority (-cy  authority).  This  is
              used to limit the chain of certificates than can be issued under this authority.

       -alt filename
              Add  a  subjectAltName extension to the certificate. Each line from 'filename' will
              be added as a DNS entry of the extension. This option is  useful  if  you  want  to
              create a single SSL certificate to work on several hosts that do not share a common
              domain name (i.e. CN=*.domain.com would not work).

       -eku oid[,oid]
              Add some extended key usage OID to the certificate.

       -p12 pkcs12file password
              Create a new PKCS#12  file  containing  both  the  certificates  (the  subject  and
              possibly  the issuer's) and the private key. The PKCS#12 file is protected with the
              specified password. This option is mono exclusive.

       -?     Help (display this help message)

       -!     Extended help (for advanced options)

EXAMPLES

       To create a SSL test (i.e. non trusted) certificate is easy once  your  know  your  host's
       name. The following command will create a test certificate for an SSL server:
            $ hostname
            pollux

            $ makecert -r -eku 1.3.6.1.5.5.7.3.1 -n "CN=pollux" -sv pollux.pvk pollux.cer
            Success

       In  particular  in  the  above example, the parameters used to build this test certificate
       were:

       -r     Create a self-signed certificate (i.e. without an hierarchy).

       -eku 1.3.6.1.5.5.7.3.1
              Optional (as sadly  most  client  don't  require  it).  This  indicates  that  your
              certificate is intended for server-side authentication.

       -n     Common  Name  (CN)  = Host name. This is verified the SSL client and must match the
              connected host (or else you'll get a warning or error or *gasp* nothing).

       -sv private.key
              The private key file. The key (1024  bits  RSA  key  pair)  will  be  automatically
              generated if the specified file isn't present.

       pollux.cer
              The SSL certificate to be created for your host.

KNOWN RESTRICTIONS

       Compared  to  the  Windows  version some options aren't supported (-$, -d, -l, -nscp, -is,
       -sc, -ss). Also PVK files with passwords aren't supported.

AUTHOR

       Written by Sebastien Pouliot

COPYRIGHT

       Copyright (C) 2003 Motus Technologies.  Copyright (C) 2004-2005  Novell.   Released  under
       BSD license.

MAILING LISTS

       Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for details.

WEB SITE

       Visit http://www.mono-project.com for details

SEE ALSO

       signcode(1)

                                                                                   Mono(MakeCert)