Scroll to navigation

PKI --SELF(1) strongSwan PKI --SELF(1)

NAME

pki --self - Create a self-signed certificate

SYNOPSIS

pki --self [--in file|--keyid hex] [--type t] --dn distinguished-name [--san subjectAltName] [--lifetime days] [--not-before datetime] [--not-after datetime] [--serial hex] [--flag flag] [--digest digest] [--ca] [--ocsp uri] [--pathlen len] [--addrblock block] [--nc-permitted name] [--nc-excluded name] [--policy-mapping mapping] [--policy-explicit len] [--policy-inhibit len] [--policy-any len] [--cert-policy oid [--cps-uri uri] [--user-notice text]] [--outform encoding] [--debug level]
pki --self --options file
pki --self -h | --help

DESCRIPTION

This sub-command of pki(1) is used to create a self-signed certificate.

OPTIONS

Print usage information with a summary of the available options.
Set debug level, default: 1.
-+, --options file
Read command line options from file.
Private key input file. If not given the key is read from STDIN.
Smartcard or TPM private key object handle in hex format with an optional 0x prefix.
Type of the input key. Either priv, rsa, ecdsa, ed25519 or bliss, defaults to priv.
Subject and issuer distinguished name (DN). Required.
subjectAltName extension to include in certificate. Can be used multiple times.
Days the certificate is valid, default: 1095. Ignored if both an absolute start and end time are given.
Absolute time when the validity of the certificate begins. The datetime format is defined by the --dateform option.
Absolute time when the validity of the certificate ends. The datetime format is defined by the --dateform option.
strptime(3) format for the --not-before and --not-after options, default: %d.%m.%y %T
Serial number in hex. It is randomly allocated by default.
Add extendedKeyUsage flag. One of serverAuth, clientAuth, crlSign, or ocspSigning. Can be used multiple times.
Digest to use for signature creation. One of md5, sha1, sha224, sha256, sha384, or sha512. The default is determined based on the type and size of the signature key.
Encoding of the created certificate file. Either der (ASN.1 DER) or pem (Base64 PEM), defaults to der.
Include CA basicConstraint extension in certificate.
OCSP AuthorityInfoAccess URI to include in certificate. Can be used multiple times.
Set path length constraint.
RFC 3779 address block to include in certificate. block is either a CIDR subnet (such as 10.0.0.0/8) or an arbitrary address range (192.168.1.7-192.168.1.13). Can be repeated to include multiple blocks. Please note that the supplied blocks are included in the certificate as is, so for standards compliance, multiple blocks must be supplied in correct order and adjacent blocks must be combined. Refer to RFC 3779 for details.
Add permitted NameConstraint extension to certificate. For DNS or email constraints, the identity type is not always detectable by the given name. Use the dns: or email: prefix to force a constraint type.
Add excluded NameConstraint extension to certificate. For DNS or email constraints, the identity type is not always detectable by the given name. Use the dns: or email: prefix to force a constraint type.
Add policyMapping from issuer to subject OID.
Add requireExplicitPolicy constraint.
Add inhibitPolicyMapping constraint.
Add inhibitAnyPolicy constraint.

Certificate Policy

Multiple certificatePolicy extensions can be added. Each with the following information:

OID to include in certificatePolicy extension. Required.
Certification Practice statement URI for certificatePolicy.
User notice for certificatePolicy.

EXAMPLES

Generate a self-signed certificate using the given RSA key:


pki --self --in key.der --dn "C=CH, O=strongSwan, CN=moon" \
--san moon.strongswan.org > cert.der

SEE ALSO

pki(1)

2016-12-13 5.5.2