From e9701a0141313d2c7008c6ee6d821ba80b3a14d9 Mon Sep 17 00:00:00 2001 From: "Dr. David von Oheimb" Date: Fri, 4 Dec 2020 09:26:25 +0100 Subject: x509v3_config.pod: Clarify semantics of subjectKeyIdentifier and authorityKeyIdentifier Reviewed-by: Tomas Mraz (Merged from https://github.com/openssl/openssl/pull/13614) --- doc/man5/x509v3_config.pod | 34 ++++++++++++++++++++-------------- 1 file changed, 20 insertions(+), 14 deletions(-) (limited to 'doc/man5') 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, 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, 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 and B. Either or both -can have the value B, indicated by putting a colon between -the option and its value. +The AKID extension specification may have the value B or B +or both of them, separated by C<,>. +Either or both can have the option B, +indicated by putting a colon C<:> between the value and this opton. + +If B 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 is present, an error is returned. +For self-issued certs the specification for the SKID must be given before. -If B is present, than an attempt is made to copy the subject key -identifier from the parent certificate. If the value B is present, -then an error can be returned if the option fails. If B is present, -an attempt is made to copy the issuer and serial number from the parent -certificate. This is done if the B option fails, or if B -has B specified. +If B is present and no B has been added +or it has the option B specified, then +the issuer DN and serial number are copied from the issuer certificate. Examples: -- cgit v1.2.3