diff options
author | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2020-12-04 09:26:25 +0100 |
---|---|---|
committer | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2020-12-10 15:19:55 +0100 |
commit | e9701a0141313d2c7008c6ee6d821ba80b3a14d9 (patch) | |
tree | 7a494e29ac74057b0057d16f422fe7a30309c012 /doc/man5/x509v3_config.pod | |
parent | 7c051ecce4ca9cd65f802fbf4fc469755859a036 (diff) | |
download | openssl-e9701a0141313d2c7008c6ee6d821ba80b3a14d9.tar.gz |
x509v3_config.pod: Clarify semantics of subjectKeyIdentifier and authorityKeyIdentifier
Reviewed-by: Tomas Mraz <tmraz@fedoraproject.org>
(Merged from https://github.com/openssl/openssl/pull/13614)
Diffstat (limited to 'doc/man5/x509v3_config.pod')
-rw-r--r-- | doc/man5/x509v3_config.pod | 34 |
1 files changed, 20 insertions, 14 deletions
diff --git a/doc/man5/x509v3_config.pod b/doc/man5/x509v3_config.pod index 953b0268cd..a20065a8d9 100644 --- a/doc/man5/x509v3_config.pod +++ b/doc/man5/x509v3_config.pod @@ -164,11 +164,14 @@ Examples: =head2 Subject Key Identifier -This is a string extension with one of two legal values. If it is the word -B<hash>, then OpenSSL will follow the process in RFC 5280 to calculate the -hash value. -Otherwise, the value should be a hex string to output directly, however, this -is strongly discouraged. +This SKID extension is a string with one of two legal values. +If it is the word B<hash>, then OpenSSL will follow +the process specified in RFC 5280 section 4.2.1.2. (1): +The keyIdentifier is composed of the 160-bit SHA-1 hash of the value of the BIT +STRING subjectPublicKey (excluding the tag, length, and number of unused bits). + +Otherwise, the value must be a hex string (possibly with C<:> separating bytes) +to output directly, however, this is strongly discouraged. Example: @@ -176,16 +179,19 @@ Example: =head2 Authority Key Identifier -This extension has two options, B<keyid> and B<issuer>. Either or both -can have the value B<always>, indicated by putting a colon between -the option and its value. +The AKID extension specification may have the value B<keyid> or B<issuer> +or both of them, separated by C<,>. +Either or both can have the option B<always>, +indicated by putting a colon C<:> between the value and this opton. + +If B<keyid> is present, an attempt is made to copy the subject key identifier +(SKID) from the issuer certificate, which is the default behavior. +If this fails and the option B<always> is present, an error is returned. +For self-issued certs the specification for the SKID must be given before. -If B<keyid> is present, than an attempt is made to copy the subject key -identifier from the parent certificate. If the value B<always> is present, -then an error can be returned if the option fails. If B<issuer> is present, -an attempt is made to copy the issuer and serial number from the parent -certificate. This is done if the B<keyid> option fails, or if B<issuer> -has B<always> specified. +If B<issuer> is present and no B<keyid> has been added +or it has the option B<always> specified, then +the issuer DN and serial number are copied from the issuer certificate. Examples: |