Ubuntu Manpage: getcert

Provided by: certmonger_0.79.5-3ubuntu1_amd64

NAME

       getcert

SYNOPSIS

       getcert rekey [options]

DESCRIPTION

       Tells  certmonger  to  generate  a new key pair, generate a signing request for the public
       key, and submit the signing request to a CA for  signing,  in  order  to  replace  both  a
       certificate and its private key.

SPECIFYING REQUESTS BY NICKNAME

       -i NAME
              The new key pair will be generated and the new certificate will be obtained for the
              tracking request which has this nickname.  If this option is not specified,  and  a
              tracking  entry  which  matches  the  key and certificate storage options which are
              specified already exists, that entry will be used.  If not specified, the  location
              of  the  certificate should be specified with either a combination of the -d and -n
              options, or with the -f option.

SPECIFYING REQUESTS BY CERTIFICATE LOCATION

       -d DIR The certificate is in the NSS database in the specified directory.

       -n NAME
              The certificate in the NSS database named with -d has the specified nickname.  Only
              valid with -d.

       -t TOKEN
              If the NSS database has more than one token available, the certificate is stored in
              this token.  This argument only rarely needs to be specified.  Only valid with -d.

       -f FILE
              The certificate is stored in the named file.

KEY GENERATION OPTIONS

       -G TYPE
              In case a new key pair needs to be generated, this option specifies the type of the
              keys to be generated.  If not specified, the current key type will be used.

       -g BITS
              This option specifies the size of the new key to be generated.  If not specified, a
              key of the same size as the existing key will be generated.

              -c NAME

ENROLLMENT OPTIONS

       -c NAME
              Submit the new signing request to the specified CA rather than the  one  which  was
              previously  associated with this certificate.  The name of the CA should correspond
              to one listed by getcert list-cas.

       -T NAME
              Request a certificate using the named profile,  template,  or  certtype,  from  the
              specified CA.

       --ms-template-spec SPEC
              Include  a  V2  Certificate  Template extension in the signing request.  This datum
              includes an Object Identifier, a major version number  (positive  integer)  and  an
              optional        minor       version       number.        The       format       is:
              <oid>:<majorVersion>[:<minorVersion>].

       -X NAME
              Request a certificate using the named issuer from the specified CA.

       -I NAME
              Assign the specified nickname to this task, replacing the previous nickname.

SIGNING REQUEST OPTIONS

-N NAME
Change the subject name to include in the signing request.

-u keyUsage
Add an extensionRequest for the specified keyUsage to the signing request. The
keyUsage value is expected to be one of these names:

digitalSignature

nonRepudiation

keyEncipherment

dataEncipherment

keyAgreement

keyCertSign

cRLSign

encipherOnly

decipherOnly

-U EKU Change the extendedKeyUsage value specified in an extendedKeyUsage extension part
of the extensionRequest attribute in the signing request. The EKU value is
expected to be an object identifier (OID).

-K NAME
Change the Kerberos principal name specified as part of a subjectAltName extension
part of the extensionRequest attribute in the signing request.

-E EMAIL
Change the email address specified as part of a subjectAltName extension part of
the extensionRequest attribute in the signing request.

-D DNSNAME
Change the DNS name specified as part of a subjectAltName extension part of the
extensionRequest attribute in the signing request.

-A ADDRESS
Change the IP address specified as part of a subjectAltName extension part of the
extensionRequest attribute in the signing request.

-l FILE
Add an optional ChallengePassword value, read from the file, to the signing
request. A ChallengePassword is often required when the CA is accessed using SCEP.

-L PIN Add the argument value to the signing request as a ChallengePassword attribute. A
ChallengePassword is often required when the CA is accessed using SCEP.

OTHER OPTIONS

       -B COMMAND
              When  ever  the  certificate  or  the  CA's certificates are saved to the specified
              locations, run  the  specified  command  as  the  client  user  before  saving  the
              certificates.

       -C COMMAND
              When  ever  the  certificate  or  the  CA's certificates are saved to the specified
              locations,  run  the  specified  command  as  the  client  user  after  saving  the
              certificates.

       -a DIR When  ever the certificate is saved to the specified location, if root certificates
              for the CA are available, save them to the specified NSS database.

       -F FILE
              When ever the certificate is saved to the specified location, if root  certificates
              for  the  CA are available, and when the local copies of the CA's root certificates
              are updated, save them to the specified file.

       -w     Wait for the new certificate to be issued and saved, or for the attempt  to  obtain
              one using the new key to fail.

       -v     Be  verbose  about  errors.   Normally,  the  details of an error received from the
              daemon will be suppressed if the client can make a diagnostic suggestion.

BUGS

       Please file tickets for any that you find at https://fedorahosted.org/certmonger/