summaryrefslogtreecommitdiff
path: root/src/lib/libssl/doc/openssl.txt
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libssl/doc/openssl.txt')
-rw-r--r--src/lib/libssl/doc/openssl.txt27
1 files changed, 23 insertions, 4 deletions
diff --git a/src/lib/libssl/doc/openssl.txt b/src/lib/libssl/doc/openssl.txt
index 432a17b66c..f8817b0a71 100644
--- a/src/lib/libssl/doc/openssl.txt
+++ b/src/lib/libssl/doc/openssl.txt
@@ -154,8 +154,22 @@ for example contain data in multiple sections. The correct syntax to
154use is defined by the extension code itself: check out the certificate 154use is defined by the extension code itself: check out the certificate
155policies extension for an example. 155policies extension for an example.
156 156
157In addition it is also possible to use the word DER to include arbitrary 157There are two ways to encode arbitrary extensions.
158data in any extension. 158
159The first way is to use the word ASN1 followed by the extension content
160using the same syntax as ASN1_generate_nconf(). For example:
161
1621.2.3.4=critical,ASN1:UTF8String:Some random data
163
1641.2.3.4=ASN1:SEQUENCE:seq_sect
165
166[seq_sect]
167
168field1 = UTF8:field1
169field2 = UTF8:field2
170
171It is also possible to use the word DER to include arbitrary data in any
172extension.
159 173
1601.2.3.4=critical,DER:01:02:03:04 1741.2.3.4=critical,DER:01:02:03:04
1611.2.3.4=DER:01020304 1751.2.3.4=DER:01020304
@@ -336,16 +350,21 @@ Subject Alternative Name.
336The subject alternative name extension allows various literal values to be 350The subject alternative name extension allows various literal values to be
337included in the configuration file. These include "email" (an email address) 351included in the configuration file. These include "email" (an email address)
338"URI" a uniform resource indicator, "DNS" (a DNS domain name), RID (a 352"URI" a uniform resource indicator, "DNS" (a DNS domain name), RID (a
339registered ID: OBJECT IDENTIFIER) and IP (and IP address). 353registered ID: OBJECT IDENTIFIER), IP (and IP address) and otherName.
340 354
341Also the email option include a special 'copy' value. This will automatically 355Also the email option include a special 'copy' value. This will automatically
342include and email addresses contained in the certificate subject name in 356include and email addresses contained in the certificate subject name in
343the extension. 357the extension.
344 358
359otherName can include arbitrary data associated with an OID: the value
360should be the OID followed by a semicolon and the content in standard
361ASN1_generate_nconf() format.
362
345Examples: 363Examples:
346 364
347subjectAltName=email:copy,email:my@other.address,URI:http://my.url.here/ 365subjectAltName=email:copy,email:my@other.address,URI:http://my.url.here/
348subjectAltName=email:my@other.address,RID:1.2.3.4 366subjectAltName=email:my@other.address,RID:1.2.3.4
367subjectAltName=otherName:1.2.3.4;UTF8:some other identifier
349 368
350Issuer Alternative Name. 369Issuer Alternative Name.
351 370
@@ -759,7 +778,7 @@ called.
759 778
760The X509V3_EXT_METHOD structure is described below. 779The X509V3_EXT_METHOD structure is described below.
761 780
762strut { 781struct {
763int ext_nid; 782int ext_nid;
764int ext_flags; 783int ext_flags;
765X509V3_EXT_NEW ext_new; 784X509V3_EXT_NEW ext_new;