1PKI --SELF(1) strongSwan PKI --SELF(1)
2
6 pki --self - Create a self-signed certificate
7
9 pki --self [--in file|--keyid hex] [--type t] --dn distinguished-name
10 [--san subjectAltName] [--lifetime days] [--not-
11 before datetime] [--not-after datetime] [--serial hex]
12 [--flag flag] [--digest digest] [--rsa-padding padding]
13 [--ca] [--ocsp uri] [--pathlen len] [--addrblock block]
14 [--nc-permitted name] [--nc-excluded name]
15 [--policy-mapping mapping] [--policy-explicit len]
16 [--policy-inhibit len] [--policy-any len]
17 [--cert-policy oid [--cps-uri uri] [--user-notice text]]
18 [--outform encoding] [--debug level]
19 pki --self --options file
21 pki --self -h | --help
23
25 This sub-command of pki(1) is used to create a self-signed certificate.
26
28 -h, --help
29 Print usage information with a summary of the available options.
30 -v, --debug level
32 Set debug level, default: 1.
33 -+, --options file
35 Read command line options from file.
36 -i, --in file
38 Private key input file. If not given the key is read from STDIN.
39 -x, --keyid hex
41 Smartcard or TPM private key object handle in hex format with an
42 optional 0x prefix.
43 -t, --type type
45 Type of the input key. Either priv, rsa, ecdsa, ed25519 or
46 bliss, defaults to priv.
47 -d, --dn distinguished-name
49 Subject and issuer distinguished name (DN). Required.
50 -a, --san subjectAltName
52 subjectAltName extension to include in certificate. Can be used
53 multiple times.
54 -l, --lifetime days
56 Days the certificate is valid, default: 1095. Ignored if both an
57 absolute start and end time are given.
58 -F, --not-before datetime
60 Absolute time when the validity of the certificate begins. The
61 datetime format is defined by the --dateform option.
62 -T, --not-after datetime
64 Absolute time when the validity of the certificate ends. The
65 datetime format is defined by the --dateform option.
66 -D, --dateform form
68 strptime(3) format for the --not-before and --not-after options,
69 default: %d.%m.%y %T
70 -s, --serial hex
72 Serial number in hex. It is randomly allocated by default.
73 -e, --flag flag
75 Add extendedKeyUsage flag. One of serverAuth, clientAuth, crl‐
76 Sign, or ocspSigning. Can be used multiple times.
77 -g, --digest digest
79 Digest to use for signature creation. One of md5, sha1, sha224,
80 sha256, sha384, or sha512. The default is determined based on
81 the type and size of the signature key.
82 -R, --rsa-padding padding
84 Padding to use for RSA signatures. Either pkcs1 or pss, defaults
85 to pkcs1.
86 -f, --outform encoding
88 Encoding of the created certificate file. Either der (ASN.1 DER)
89 or pem (Base64 PEM), defaults to der.
90 -b, --ca
92 Include CA basicConstraint extension in certificate.
93 -o, --ocsp uri
95 OCSP AuthorityInfoAccess URI to include in certificate. Can be
96 used multiple times.
97 -p, --pathlen len
99 Set path length constraint.
100 -B, --addrblock block
102 RFC 3779 address block to include in certificate. block is
103 either a CIDR subnet (such as 10.0.0.0/8) or an arbitrary
104 address range (192.168.1.7-192.168.1.13). Can be repeated to
105 include multiple blocks. Please note that the supplied blocks
106 are included in the certificate as is, so for standards compli‐
107 ance, multiple blocks must be supplied in correct order and
108 adjacent blocks must be combined. Refer to RFC 3779 for details.
109 -n, --nc-permitted name
111 Add permitted NameConstraint extension to certificate. For DNS
112 or email constraints, the identity type is not always detectable
113 by the given name. Use the dns: or email: prefix to force a con‐
114 straint type.
115 -N, --nc-excluded name
117 Add excluded NameConstraint extension to certificate. For DNS or
118 email constraints, the identity type is not always detectable by
119 the given name. Use the dns: or email: prefix to force a con‐
120 straint type.
121 -M, --policy-mapping issuer-oid:subject-oid
123 Add policyMapping from issuer to subject OID.
124 -E, --policy-explicit len
126 Add requireExplicitPolicy constraint.
127 -H, --policy-inhibit len
129 Add inhibitPolicyMapping constraint.
130 -A, --policy-any len
132 Add inhibitAnyPolicy constraint.
133 Certificate Policy
135 Multiple certificatePolicy extensions can be added. Each with the fol‐
136 lowing information:
137 -P, --cert-policy oid
139 OID to include in certificatePolicy extension. Required.
140 -C, --cps-uri uri
142 Certification Practice statement URI for certificatePolicy.
143 -U, --user-notice text
145 User notice for certificatePolicy.
146
148 Generate a self-signed certificate using the given RSA key:
149 pki --self --in key.der --dn "C=CH, O=strongSwan, CN=moon" \
151 --san moon.strongswan.org > cert.der
152
154 pki(1)
1555.7.2 2016-12-13 PKI --SELF(1)