doc: add verify-digested param for EdDSA

Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Shane Lontis <shane.lontis@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/25032)
This commit is contained in:
Pauli 2024-07-30 11:29:32 +10:00
parent b00ea9a6a2
commit ab02a297eb
1 changed files with 11 additions and 4 deletions

View File

@ -38,9 +38,9 @@ instance, a nonempty context-string is not permitted.
=head2 ED25519 and ED448 Signature Parameters =head2 ED25519 and ED448 Signature Parameters
Two parameters can be set during signing or verification: the EdDSA The following parameters can be set during signing or verification by
B<instance name> and the B<context-string value>. They can be set by passing an OSSL_PARAM array to EVP_DigestSignInit_ex() or
passing an OSSL_PARAM array to EVP_DigestSignInit_ex(). EVP_PKEY_CTX_set_params():
=over 4 =over 4
@ -56,9 +56,14 @@ One of the five strings "Ed25519", "Ed25519ctx", "Ed25519ph", "Ed448", "Ed448ph"
A string of octets with length at most 255. A string of octets with length at most 255.
=item * "verify-digested" (B<OSSL_SIGNATURE_PARAM_EDDSA_VERIFY_DIGESTED> <integer>
If set to a nonzero value, EdDSA can be used to verify a hash of a message.
If zero, EdDSA will digest the message internally.
=back =back
Both of these parameters are optional. All of these parameters are optional.
If the instance name is not specified, then the default "Ed25519" or If the instance name is not specified, then the default "Ed25519" or
"Ed448" is used. "Ed448" is used.
@ -82,6 +87,8 @@ EVP_PKEY_CTX_get_params().
=item * "context-string" (B<OSSL_SIGNATURE_PARAM_CONTEXT_STRING>) <octet string> =item * "context-string" (B<OSSL_SIGNATURE_PARAM_CONTEXT_STRING>) <octet string>
=item * "fips-indicator" (B<OSSL_SIGNATURE_PARAM_FIPS_APPROVED_INDICATOR>) <integer>
=back =back
The parameters are described in L<provider-signature(7)>. The parameters are described in L<provider-signature(7)>.