Replace ECDSA_METHOD with EC_KEY_METHOD and add the associated API #1785

smittals2 · 2024-08-20T23:23:34Z

Issues

CryptoAlg-2481

Description of changes:

This is the second pull request in a series of three (prev PR). This PR primarily focuses on refactoring and enhancing the EC_KEY_METHOD API. The key changes are as follows:

Removal of ECDSA_METHOD: ECDSA_METHOD support, including the associated ENGINE functions, has been fully removed and replaced by EC_KEY_METHOD. This aligns with the transition seen in OpenSSL 1.1.1 and was also driven by customer requirements.
Hiding Struct definition: The EC_KEY_METHOD struct definition is now internal. Unlike OpenSSL, where static allocation was possible, AWS-LC now supports only dynamic allocation of this struct.
Expansion of EC_KEY_METHOD Functions: Added various EC_KEY_METHOD_* functions to create, free, get/set, and manipulate the EC_KEY_METHOD struct.

Testing:

Tested with various fields initialized in EC_KEY_METHOD to ensure that custom functionality is correctly invoked.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and the ISC license.

…support *group_order_size custom functionality anymore

codecov-commenter · 2024-08-21T00:01:46Z

Codecov Report

Attention: Patch coverage is 70.53571% with 33 lines in your changes missing coverage. Please review.

Project coverage is 78.39%. Comparing base (353228b) to head (cbe8a5a).
Report is 27 commits behind head on main.

Files with missing lines	Patch %	Lines
crypto/engine/engine.c	0.00%	13 Missing ⚠️
crypto/fipsmodule/ec/ec_key.c	76.00%	12 Missing ⚠️
crypto/fipsmodule/ec/ec_test.cc	82.50%	6 Missing and 1 partial ⚠️
crypto/ecdsa_extra/ecdsa_asn1.c	75.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1785      +/-   ##
==========================================
+ Coverage   78.34%   78.39%   +0.04%     
==========================================
  Files         581      582       +1     
  Lines       97343    97547     +204     
  Branches    13960    13988      +28     
==========================================
+ Hits        76268    76470     +202     
+ Misses      20455    20454       -1     
- Partials      620      623       +3

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

### Description of changes: 1. Breaking changes to the ENGINE API - made the function signatures match OpenSSL. Removed method_size as a parameter since the method can no longer be statically allocated. 2. Got rid of old code supporting reference counting for METHOD structs as it never existed in OpenSSL and was no-ops/unused in BoringSSL 3. Removed static allocation enforcement for METHOD structs. Now consumers can only dynamically allocate these structs via funcs like EC_KEY_METHOD_new and RSA_METHOD_new which are added [here](#1785) and [here](#1790). ### Call-outs: First PR in a series of 3 to refactor and expand support for ENGINE, RSA_METHOD, and EC_KEY_METHOD structs ### Testing: No significant tests can be written yet. The memory model will be tested further in the PRs that follow. By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and the ISC license.

crypto/fipsmodule/ec/ec_key.c

crypto/engine/engine.c

include/openssl/ec_key.h

crypto/fipsmodule/ec/internal.h

tests/ci/integration/openvpn_patch/aws-lc-openvpn2-6-x.patch

include/openssl/ec_key.h

tests/ci/integration/openvpn_patch/aws-lc-openvpn2-6-x.patch

crypto/fipsmodule/ec/internal.h

include/openssl/ec_key.h

crypto/fipsmodule/ec/internal.h

include/openssl/ec_key.h

crypto/fipsmodule/ec/internal.h

include/openssl/ec_key.h

crypto/fipsmodule/ecdsa/ecdsa.c

nebeid

Thank you for updating the documentation. It is clearer to me now.

crypto/fipsmodule/ecdsa/ecdsa.c

### Issues `CryptoAlg-2482 ` ### Description of changes: This PR is the last in a series of three (prev PRs: [1st](#1776), [2nd](#1785)) to refactor and expand ENGINE, EC_KEY_METHOD and RSA_METHOD. This PR: 1. Expands the RSA_METHOD struct and changes the function signatures for encrypt, decrypt, sign_raw, and verify_raw to match OpenSSL 1.1.1. 2. Makes the struct definition for RSA_METHOD internal. This means static allocation of this struct is no longer possible. 3. Adds various functions to get/set, create, free, and manipulate RSA_METHOD ### Callout: This PR includes the commits for the other 2 PRs. They should be reviewed and merged before this one. ### Testing: Tested with various fields initialized in RSA_METHOD to ensure that custom functionality is correctly invoked. By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and the ISC license.

@andrewhop

## What's Changed * Use OPENSSL_STATIC_ASSERT which handles all the platform/compiler/C s… by @andrewhop in #1791 * ML-KEM refactor by @dkostic in #1763 * ML-KEM-IPD to ML-KEM as defined in FIPS 203 by @dkostic in #1796 * Add KDA OneStep testing to ACVP by @skmcgrail in #1792 * Updating erroneous documentation for BIO_get_mem_data and subsequent usage by @smittals2 in #1752 * No-op impls for several EVP_PKEY_CTX functions by @justsmth in #1759 * Drop "ipd" suffix from ML-KEM related code by @dkostic in #1797 * Upstream merge 2024 08 19 by @skmcgrail in #1781 * ML-KEM move to the FIPS module by @dkostic in #1802 * Reduce collision probability for variable names by @torben-hansen in #1804 * Refactor ENGINE API and memory around METHOD structs by @smittals2 in #1776 * bn: Move x86-64 argument-based dispatching of bn_mul_mont to C. by @justsmth in #1795 * Check at runtime that the tool is loading the same libcrypto it was built with by @andrewhop in #1716 * Avoid matching prefixes of a symbol as arm registers by @torben-hansen in #1807 * Add CI for FreeBSD by @justsmth in #1787 * Move curve25519 implementations to fips module except spake25519 by @torben-hansen in #1809 * Add CAST for SP 800-56Cr2 One-Step function by @skmcgrail in #1803 * Remove custom PKCS7 ASN1 functions, add new structs by @WillChilds-Klein in #1726 * NASM use default debug format by @justsmth in #1747 * Add KDF in counter mode ACVP Testing by @skmcgrail in #1810 * add support for OCSP_request_verify by @samuel40791765 in #1778 * Fix GitHub/CodeBuild Purge Lambda by @justsmth in #1808 * KBKDF_ctr_hmac FIPS Service Indicator by @skmcgrail in #1798 * Update x509 tool to write all output to common BIO which is a file or stdout by @andrewhop in #1800 * Add ML-KEM to speed.cc, bump AWSLC_API_VERSION to 30 by @andrewhop in #1817 * Add EVP_PKEY_asn1_* functions by @justsmth in #1751 * Improve portability of CI integration script by @torben-hansen in #1815 * Upstream merge 2024 08 23 by @justsmth in #1799 * Replace ECDSA_METHOD with EC_KEY_METHOD and add the associated API by @smittals2 in #1785 * Cherrypick "Add some barebones support for DH in EVP" by @samuel40791765 in #1813 * Add KDA OneStep (SSKDF_digest and SSKDF_hmac) to FIPS indicator by @skmcgrail in #1793 * Add EVP_Digest one-shot test XOFs by @WillChilds-Klein in #1820 * Wire-up ACVP Testing for SHA3 Signatures with RSA by @skmcgrail in #1805 * Make SHA3 (not SHAKE) Approved for EVP_DigestSign/Verify, RSA and ECDSA. by @nebeid in #1821 * Begin tracking RelWithDebInfo library statistics by @andrewhop in #1822 * Move EVP ed25519 function table under FIPS module by @torben-hansen in #1826 * Avoid C11 Atomics on Windows by @justsmth in #1824 * Improve pre-sandbox setup by @torben-hansen in #1825 * Add OCSP round trip integration test with minor fixes by @samuel40791765 in #1811 * Add various PKCS7 getters and setters by @WillChilds-Klein in #1780 * Run clang-format on pkcs7 code by @WillChilds-Klein in #1830 * Move KEM API and ML-KEM definitions to FIPS module by @torben-hansen in #1828 * fix socat integration CI by @samuel40791765 in #1833 * Retire out-of-module KEM folder by @torben-hansen in #1832 * Refactor RSA_METHOD and expand API by @smittals2 in #1790 * Update benchmark documentation in tool/readme.md by @andrewhop in #1812 * Pre jail unit test by @torben-hansen in #1835 * Move EVP KEM implementation to in-module and correct OID by @torben-hansen in #1838 * More minor symbols Ruby depends on by @samuel40791765 in #1837 * ED25519 Power-on Self Test / CAST / KAT by @skmcgrail in #1834 * ACVP ML-KEM testing by @skmcgrail in #1840 * ACVP ECDSA SHA3 Digest Testing by @skmcgrail in #1819 * ML-KEM Service Indicator for EVP_PKEY_keygen, EVP_PKEY_encapsulate, EVP_PKEY_decapsulate by @skmcgrail in #1844 * Add ML-KEM CAST for KeyGen, Encaps, and Decaps by @skmcgrail in #1846 * ED25519 Service Indicator by @skmcgrail in #1829 * Update Allowed RSA KeySize Generation to FIPS 186-5 specification by @skmcgrail in #1823 * Add ED25519 ACVP Testing by @skmcgrail in #1818 * Make EDDSA/Ed25519 POST lazy initalized by @skmcgrail in #1848 * add support for PEM Parameters without ASN1 hooks by @samuel40791765 in #1831 * Add OpenVPN tip of main to CI by @smittals2 in #1843 * Ensure SSE2 is enabled when using optimized assembly for 32-bit x86 by @graebm in #1841 * Add support for `EVP_PKEY_CTX_ctrl_str` - Step #1 by @justsmth in #1842 * Added SHA3/SHAKE XOF functionality by @jakemas in #1839 * Migrated ML-KEM SHA3/SHAKE usage to fipsmodule by @jakemas in #1851 * AVX-512 support for RSA Signing by @pittma in #1273

smittals2 added 14 commits August 19, 2024 00:17

refactor engine API and memory around METHOD structs

9cb198e

added check in RSA_free and removed old comment

9c1b425

updated documentation

d9ce001

removed ECDSA_METHOD and first batch of EC_KEY_METHOD replacement

534e93e

updated documentation for EC_KEY_METHOD api

76633ab

refactored EC_KEY_is_opaque and updated documentation

b458ac2

refactored ECDSA_size as a result of removing ECDSA_METHOD. We don't …

e236789

…support *group_order_size custom functionality anymore

changed param type from unsigned int to int to match OpenSSL

ca46765

added function to set flags on EC_KEY_METHOD

0630da8

changed func sig

9b17db0

test for EC_KEY_METHOD

0686e44

added static default eckey meth

43a7315

cleaned up comments and code, changed static allocation

3429da0

added more assertions

f7fe3b4

smittals2 changed the title ~~Replace ECDSA_METHOD with EC_KEY_METHOD and associated API~~ Replace ECDSA_METHOD with EC_KEY_METHOD and add the associated API Aug 20, 2024

Merge branch 'main' into eckeymethod

8a68735

justsmth self-requested a review August 21, 2024 19:23

smittals2 mentioned this pull request Aug 22, 2024

Refactor RSA_METHOD and expand API #1790

Merged

smittals2 added 5 commits August 21, 2024 17:34

changed default init for EC_KEY_METHOD for deterministic FIPS hash

9bda4bb

fixed memory leak in test

2e2d6f3

removed cast for string

3ce0ec8

using ASSERT_STREQ for string literals instead of comapring pointers

f885475

updated patch file to account for sign_setup

fca2567

smittals2 mentioned this pull request Aug 24, 2024

Refactor ENGINE API and memory around METHOD structs #1776

Merged

smittals2 marked this pull request as ready for review August 26, 2024 07:34

smittals2 requested a review from a team as a code owner August 26, 2024 07:34

Merge branch 'main' into eckeymethod

83236f9

justsmth reviewed Aug 27, 2024

View reviewed changes

justsmth requested a review from nebeid August 27, 2024 17:13

removed unsused fields and updated documentation

89d7b75

smittals2 requested a review from justsmth August 28, 2024 06:45

smittals2 and others added 2 commits August 27, 2024 23:51

Merge branch 'main' into eckeymethod

474a36f

added static asserts for params that should not be set

46ccb04

justsmth reviewed Aug 28, 2024

View reviewed changes

tests/ci/integration/openvpn_patch/aws-lc-openvpn2-6-x.patch Show resolved Hide resolved

include/openssl/ec_key.h Outdated Show resolved Hide resolved

include/openssl/ec_key.h Outdated Show resolved Hide resolved

justsmth reviewed Aug 28, 2024

View reviewed changes

include/openssl/ec_key.h Outdated Show resolved Hide resolved

justsmth reviewed Aug 28, 2024

View reviewed changes

tests/ci/integration/openvpn_patch/aws-lc-openvpn2-6-x.patch Show resolved Hide resolved

smittals2 added 2 commits August 28, 2024 12:19

removed unused params and updated documetnation

404312c

using OPENSSL_STATIC_ASSERT and removed IS_NULL macro

63ca963

smittals2 requested a review from justsmth August 28, 2024 20:54

justsmth reviewed Aug 29, 2024

View reviewed changes

crypto/fipsmodule/ec/internal.h Outdated Show resolved Hide resolved

commented out more unsused fields

6c1f2e7

smittals2 requested a review from justsmth August 29, 2024 17:17

fixed set_method and removed old fields

c687981

justsmth previously approved these changes Aug 29, 2024

View reviewed changes

nebeid reviewed Aug 29, 2024

View reviewed changes

updated documentation

cbe8a5a

smittals2 dismissed justsmth’s stale review via cbe8a5a August 29, 2024 23:24

smittals2 requested a review from nebeid August 29, 2024 23:25

nebeid approved these changes Aug 30, 2024

View reviewed changes

crypto/fipsmodule/ecdsa/ecdsa.c Outdated Show resolved Hide resolved

justsmth approved these changes Aug 30, 2024

View reviewed changes

smittals2 merged commit b925242 into aws:main Aug 30, 2024
107 of 108 checks passed

smittals2 mentioned this pull request Sep 15, 2024

prepare for v1.35.0 release #1853

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Replace ECDSA_METHOD with EC_KEY_METHOD and add the associated API #1785

Replace ECDSA_METHOD with EC_KEY_METHOD and add the associated API #1785

smittals2 commented Aug 20, 2024 •

edited

Loading

codecov-commenter commented Aug 21, 2024 •

edited

Loading

nebeid left a comment

Replace ECDSA_METHOD with EC_KEY_METHOD and add the associated API #1785

Replace ECDSA_METHOD with EC_KEY_METHOD and add the associated API #1785

Conversation

smittals2 commented Aug 20, 2024 • edited Loading

Issues

Description of changes:

Testing:

codecov-commenter commented Aug 21, 2024 • edited Loading

Codecov Report

nebeid left a comment

Choose a reason for hiding this comment

smittals2 commented Aug 20, 2024 •

edited

Loading

codecov-commenter commented Aug 21, 2024 •

edited

Loading