doc: document the OSSL_SIGNATURE_PARAM_FIPS_VERIFY_MESSAGE parameter

Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Shane Lontis <shane.lontis@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/25211)
This commit is contained in:
Pauli 2024-08-16 10:21:12 +10:00
parent 3c1713aeed
commit a9fc8702e0
3 changed files with 13 additions and 0 deletions

View File

@ -44,6 +44,8 @@ EVP_PKEY_CTX_get_params().
=item "fips-indicator" (B<OSSL_SIGNATURE_PARAM_FIPS_APPROVED_INDICATOR>) <integer>
=item "verify-message" (B<OSSL_SIGNATURE_PARAM_FIPS_VERIFY_MESSAGE> <integer>
The parameters are described in L<provider-signature(7)>.
=back

View File

@ -147,6 +147,8 @@ EVP_PKEY_CTX_get_params().
=item "fips-indicator" (B<OSSL_SIGNATURE_PARAM_FIPS_APPROVED_INDICATOR>) <integer>
=item "verify-message" (B<OSSL_SIGNATURE_PARAM_FIPS_VERIFY_MESSAGE> <integer>
These common parameter are described in L<provider-signature(7)>.
=item "digest" (B<OSSL_SIGNATURE_PARAM_DIGEST>) <UTF8 string>

View File

@ -395,6 +395,15 @@ This may be used after calling either the sign or verify final functions. It may
return 0 if either the "digest-check", "key-check", or "sign-check" are set to 0.
This option is used by the OpenSSL FIPS provider.
=item "verify-message" (B<OSSL_SIGNATURE_PARAM_FIPS_VERIFY_MESSAGE> <integer>
A getter that returns 1 if a signature verification operation acted on
a raw message, or 0 if it verified a predigested message. A value of 0
indicates likely non-approved usage of the FIPS provider. This flag is
set when any signature verification initialisation function is called.
It is also set to 1 when any signing operation is performed to signify
compliance. See FIPS 140-3 IG 2.4.B for further information.
=item "key-check" (B<OSSL_SIGNATURE_PARAM_FIPS_KEY_CHECK>) <integer>
If required this parameter should be set early via an init function