Skip to content

Document the AWS-LC provider - #3434

Open
geedo0 wants to merge 2 commits into
provider-sha256from
provider-readme
Open

Document the AWS-LC provider#3434
geedo0 wants to merge 2 commits into
provider-sha256from
provider-readme

Conversation

@geedo0

@geedo0 geedo0 commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

Description of changes:

This change documents how to build, test, install, activate, and verify the
AWS-LC provider. It includes configuration-file and programmatic activation
examples, explains the optional ?provider=awslc preference and default-provider
fallback, and describes the frontend/backend source layout.

It also adds ALGORITHM_SUPPORT.md, organized by OpenSSL operation class, with
SHA2-256 recorded as the provider's initial supported algorithm.

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.

@github-actions

Copy link
Copy Markdown
Contributor

🔒 Security ReviewView Report

Please review before merging.

@codecov-commenter

codecov-commenter commented Aug 20, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 78.51%. Comparing base (c8b2e7f) to head (bff703b).

Additional details and impacted files
@@                 Coverage Diff                 @@
##           provider-sha256    #3434      +/-   ##
===================================================
+ Coverage            78.27%   78.51%   +0.24%     
===================================================
  Files                  698      699       +1     
  Lines               124590   124622      +32     
  Branches             17288    17291       +3     
===================================================
+ Hits                 97519    97850     +331     
+ Misses               26147    25846     -301     
- Partials               924      926       +2     

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

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@geedo0
geedo0 marked this pull request as ready for review August 20, 2026 16:31
@geedo0
geedo0 requested a review from a team as a code owner August 20, 2026 16:31
Comment thread provider/README.md Outdated
@@ -0,0 +1,160 @@
# aws-lc-provider

An OpenSSL 3.x [provider](https://docs.openssl.org/3.0/man7/provider/) that implements no

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • We say "3.x" and link to "3.0" documentation, but we only support versions >= 3.5+?
  • Will the provided be compatible with OpenSSL 4.x?

@geedo0 geedo0 Aug 24, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch, let me rework this section by hand. The significance of 3.x is the introduction of the provider interface and new APIs. 3.5 is the minimum required version for aws-lc-provider due to its introduction of the KEM operation. We will be compatible with 4.x and beyond for as long as OpenSSL maintains forward compatibility.

justsmth
justsmth previously approved these changes Aug 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants