diff options
author | slontis <shane.lontis@oracle.com> | 2022-05-04 12:04:43 +1000 |
---|---|---|
committer | Pauli <pauli@openssl.org> | 2022-05-09 10:08:07 +1000 |
commit | b40c753b6e09eb6df06c161cdf771c704898b050 (patch) | |
tree | 86165ecf2d5a9c538957e9b06f4df9e8189c3458 /doc/man3/EC_GROUP_copy.pod | |
parent | fcbd8be18229ef7aa32369d2e9c747348f7d6490 (diff) |
Add documentation for key validation that indicates the difference between the
EVP_PKEY_XXX_check() calls for the default and fips providers.
Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Paul Dale <pauli@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/18235)
(cherry picked from commit 0b3d2594d060dc19269d3740ad672f065ec6398a)
Diffstat (limited to 'doc/man3/EC_GROUP_copy.pod')
-rw-r--r-- | doc/man3/EC_GROUP_copy.pod | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/doc/man3/EC_GROUP_copy.pod b/doc/man3/EC_GROUP_copy.pod index 3702f7368c..2f776cc8c5 100644 --- a/doc/man3/EC_GROUP_copy.pod +++ b/doc/man3/EC_GROUP_copy.pod @@ -159,9 +159,10 @@ The function EC_GROUP_check_discriminant() calculates the discriminant for the c For a curve defined over Fp the discriminant is given by the formula 4*a^3 + 27*b^2 whilst for F2^m curves the discriminant is simply b. In either case for the curve to be valid the discriminant must be non zero. -The function EC_GROUP_check() performs a number of checks on a curve to verify that it is valid. Checks performed include +The function EC_GROUP_check() behaves in the following way: +For the OpenSSL default provider it performs a number of checks on a curve to verify that it is valid. Checks performed include verifying that the discriminant is non zero; that a generator has been defined; that the generator is on the curve and has -the correct order. +the correct order. For the OpenSSL FIPS provider it uses EC_GROUP_check_named_curve() to conform to SP800-56Ar3. The function EC_GROUP_check_named_curve() determines if the group's domain parameters match one of the built-in curves supported by the library. The curve name is returned as a B<NID> if it matches. If the group's domain parameters have been modified then no match will be found. |