| Index: openssl/doc/apps/x509v3_config.pod
|
| ===================================================================
|
| --- openssl/doc/apps/x509v3_config.pod (revision 105093)
|
| +++ openssl/doc/apps/x509v3_config.pod (working copy)
|
| @@ -52,7 +52,7 @@
|
| policies extension for an example.
|
|
|
| If an extension type is unsupported then the I<arbitrary> extension syntax
|
| -must be used, see the L<ARBITRART EXTENSIONS|/"ARBITRARY EXTENSIONS"> section for more details.
|
| +must be used, see the L<ARBITRARY EXTENSIONS|/"ARBITRARY EXTENSIONS"> section for more details.
|
|
|
| =head1 STANDARD EXTENSIONS
|
|
|
| @@ -178,7 +178,7 @@
|
|
|
| otherName can include arbitrary data associated with an OID: the value
|
| should be the OID followed by a semicolon and the content in standard
|
| -ASN1_generate_nconf() format.
|
| +L<ASN1_generate_nconf(3)|ASN1_generate_nconf(3)> format.
|
|
|
| Examples:
|
|
|
| @@ -226,21 +226,82 @@
|
|
|
| =head2 CRL distribution points.
|
|
|
| -This is a multi-valued extension that supports all the literal options of
|
| -subject alternative name. Of the few software packages that currently interpret
|
| -this extension most only interpret the URI option.
|
| +This is a multi-valued extension whose options can be either in name:value pair
|
| +using the same form as subject alternative name or a single value representing
|
| +a section name containing all the distribution point fields.
|
|
|
| -Currently each option will set a new DistributionPoint with the fullName
|
| -field set to the given value.
|
| +For a name:value pair a new DistributionPoint with the fullName field set to
|
| +the given value both the cRLissuer and reasons fields are omitted in this case.
|
|
|
| -Other fields like cRLissuer and reasons cannot currently be set or displayed:
|
| -at this time no examples were available that used these fields.
|
| +In the single option case the section indicated contains values for each
|
| +field. In this section:
|
|
|
| -Examples:
|
| +If the name is "fullname" the value field should contain the full name
|
| +of the distribution point in the same format as subject alternative name.
|
|
|
| +If the name is "relativename" then the value field should contain a section
|
| +name whose contents represent a DN fragment to be placed in this field.
|
| +
|
| +The name "CRLIssuer" if present should contain a value for this field in
|
| +subject alternative name format.
|
| +
|
| +If the name is "reasons" the value field should consist of a comma
|
| +separated field containing the reasons. Valid reasons are: "keyCompromise",
|
| +"CACompromise", "affiliationChanged", "superseded", "cessationOfOperation",
|
| +"certificateHold", "privilegeWithdrawn" and "AACompromise".
|
| +
|
| +
|
| +Simple examples:
|
| +
|
| crlDistributionPoints=URI:http://myhost.com/myca.crl
|
| crlDistributionPoints=URI:http://my.com/my.crl,URI:http://oth.com/my.crl
|
|
|
| +Full distribution point example:
|
| +
|
| + crlDistributionPoints=crldp1_section
|
| +
|
| + [crldp1_section]
|
| +
|
| + fullname=URI:http://myhost.com/myca.crl
|
| + CRLissuer=dirName:issuer_sect
|
| + reasons=keyCompromise, CACompromise
|
| +
|
| + [issuer_sect]
|
| + C=UK
|
| + O=Organisation
|
| + CN=Some Name
|
| +
|
| +=head2 Issuing Distribution Point
|
| +
|
| +This extension should only appear in CRLs. It is a multi valued extension
|
| +whose syntax is similar to the "section" pointed to by the CRL distribution
|
| +points extension with a few differences.
|
| +
|
| +The names "reasons" and "CRLissuer" are not recognized.
|
| +
|
| +The name "onlysomereasons" is accepted which sets this field. The value is
|
| +in the same format as the CRL distribution point "reasons" field.
|
| +
|
| +The names "onlyuser", "onlyCA", "onlyAA" and "indirectCRL" are also accepted
|
| +the values should be a boolean value (TRUE or FALSE) to indicate the value of
|
| +the corresponding field.
|
| +
|
| +Example:
|
| +
|
| + issuingDistributionPoint=critical, @idp_section
|
| +
|
| + [idp_section]
|
| +
|
| + fullname=URI:http://myhost.com/myca.crl
|
| + indirectCRL=TRUE
|
| + onlysomereasons=keyCompromise, CACompromise
|
| +
|
| + [issuer_sect]
|
| + C=UK
|
| + O=Organisation
|
| + CN=Some Name
|
| +
|
| +
|
| =head2 Certificate Policies.
|
|
|
| This is a I<raw> extension. All the fields of this extension can be set by
|
| @@ -329,7 +390,17 @@
|
| nameConstraints=permitted;email:.somedomain.com
|
|
|
| nameConstraints=excluded;email:.com
|
| +issuingDistributionPoint = idp_section
|
|
|
| +=head2 OCSP No Check
|
| +
|
| +The OCSP No Check extension is a string extension but its value is ignored.
|
| +
|
| +Example:
|
| +
|
| + noCheck = ignored
|
| +
|
| +
|
| =head1 DEPRECATED EXTENSIONS
|
|
|
| The following extensions are non standard, Netscape specific and largely
|
| @@ -370,7 +441,8 @@
|
| There are two ways to encode arbitrary extensions.
|
|
|
| The first way is to use the word ASN1 followed by the extension content
|
| -using the same syntax as ASN1_generate_nconf(). For example:
|
| +using the same syntax as L<ASN1_generate_nconf(3)|ASN1_generate_nconf(3)>.
|
| +For example:
|
|
|
| 1.2.3.4=critical,ASN1:UTF8String:Some random data
|
|
|
| @@ -450,7 +522,8 @@
|
|
|
| =head1 SEE ALSO
|
|
|
| -L<req(1)|req(1)>, L<ca(1)|ca(1)>, L<x509(1)|x509(1)>
|
| +L<req(1)|req(1)>, L<ca(1)|ca(1)>, L<x509(1)|x509(1)>,
|
| +L<ASN1_generate_nconf(3)|ASN1_generate_nconf(3)>
|
|
|
|
|
| =cut
|
|
|