Skip to content

Pq fips fenrir - #11359

Open
jackctj117 wants to merge 17 commits into
wolfSSL:masterfrom
jackctj117:PQ-FIPS-Fenrir
Open

jackctj117 wants to merge 17 commits into
wolfSSL:masterfrom
jackctj117:PQ-FIPS-Fenrir

Conversation

@jackctj117

@jackctj117 jackctj117 commented Sep 2, 2026 •

Copy link
Copy Markdown
Contributor

Companion to wolfSSL/fips#420. FIPS v7 only; non-FIPS and older FIPS builds are unchanged.

What changes

  • ECC key generation: refused on curves below 224 bits (SP 800-131A Rev. 2 Table 2).
  • ECDSA signing: refused on curves below 224 bits, including through crypto callbacks and hardware backends. Verification on those curves still works (legacy use).
  • KCAPI HMAC: adds a KCAPI wc_HmacSetKey_ex() so HKDF and PBKDF2 set the key on the same backend that runs update/final.
  • Tests: cover the two ECC refusals, and expect the HKDF SHA-1 refusal only when fips.h defines WC_HAVE_FIPS_INDICATOR.

Testing

--enable-fips=ready on macOS: testwolfcrypt and unit.test pass. The KCAPI change was built and linked on Linux but not run.

@jackctj117 jackctj117 self-assigned this Sep 2, 2026
Copilot AI lite review requested due to automatic review settings September 2, 2026 20:05

Copilot AI left a comment

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.

🟡 Changes recommended

The new ECC signing gate returns a misleading error code (SIG_TYPE_E) and the DRBG reseed helper should better align with existing SMALL_STACK_CACHE behavior and optional additional_input semantics.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR tightens FIPS 140-3 / SP 800-131A Rev. 2 enforcement in wolfCrypt (notably for ECC KAS/KeyGen/Sign, HMAC key sizing, and DRBG reseed entropy sourcing) and updates the wolfCrypt test suite to assert the new approved-mode behaviors and expected error codes.

Changes:

  • Enforces FIPS v7+ constraints: ECC KAS limited to P-256/P-384/P-521; ECC keygen/signing disallows <224-bit curves; HMAC rejects keys >1024 bits unless explicitly overridden.
  • Updates DRBG reseed in FIPS v7+ to always pull entropy from the module seed source and treat caller bytes as additional input.
  • Extends test coverage to validate new rejection/acceptance behaviors (HMAC long keys, RSA PKCS#1 v1.5 transport refusal, PBKDF2/HKDF/ECDSA “not approved” signaling).
File summaries
File Description
wolfssl/wolfcrypt/hmac.h Adds HMAC_FIPS_MAX_KEY constant for v7+ (1024-bit max) used to enforce approved-mode key-size limits.
wolfcrypt/src/hmac.c Enforces v7+ maximum HMAC key length when allowFlag is not set.
wolfcrypt/src/random.c Alters v7+ DRBG reseed to draw entropy internally and treat caller bytes as additional input; adds helper to reseed from seed source.
wolfcrypt/src/ecc.c Adds v7+ ECC curve gating for shared secret, shared secret (ex), key generation, and signing restrictions.
wolfcrypt/test/test.c Updates/extends tests for HMAC long-key rejection + override, RSA PKCS#1 v1.5 transport refusal behavior, and other v7+ non-approved indicators.
Review details
  • Files reviewed: 5/5 changed files
  • Comments generated: 3
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread wolfcrypt/src/ecc.c Resolved
Comment thread wolfcrypt/src/random.c Resolved
Comment thread wolfcrypt/src/random.c Resolved
@github-actions

github-actions Bot commented Sep 3, 2026 •

Copy link
Copy Markdown

MemBrowse Memory Report · Explore what changed →

gcc-arm-cortex-m0plus

  • FLASH: .text -28 B (-0.0%, 71,167 B / 262,144 B, total: 27% used)

gcc-arm-cortex-m3

  • FLASH: .text -32 B (-0.0%, 132,197 B / 262,144 B, total: 50% used)

gcc-arm-cortex-m4

  • FLASH: .text -64 B (-0.0%, 209,484 B / 262,144 B, total: 80% used)

gcc-arm-cortex-m4-crypto-only

  • FLASH: .text +512 B (+0.3%, 182,803 B / 262,144 B, total: 70% used)

gcc-arm-cortex-m4-dtls13

  • FLASH: .text +448 B (+0.2%, 196,952 B / 1,048,576 B, total: 19% used)

gcc-arm-cortex-m4-openssl-compat

  • FLASH: .rodata +24 B, .text +1,664 B (+0.2%, 803,804 B / 1,048,576 B, total: 77% used)

gcc-arm-cortex-m4-pkcs7

  • FLASH: .text +640 B (+0.3%, 224,020 B / 262,144 B, total: 85% used)

gcc-arm-cortex-m4-pq

  • FLASH: .text +512 B (+0.2%, 313,936 B / 1,048,576 B, total: 30% used)

gcc-arm-cortex-m4-rsa-only

  • FLASH: .text +384 B (+0.1%, 344,336 B / 1,048,576 B, total: 33% used)

gcc-arm-cortex-m4-tls12

  • FLASH: .text -64 B (-0.0%, 132,945 B / 262,144 B, total: 51% used)

gcc-arm-cortex-m4-tls13

  • FLASH: .text +512 B (+0.2%, 250,658 B / 262,144 B, total: 96% used)

gcc-arm-cortex-m7-pq

  • FLASH: .text +512 B (+0.2%, 314,768 B / 1,048,576 B, total: 30% used)

gcc-arm-cortex-m7-tls13

  • FLASH: .text +512 B (+0.2%, 250,658 B / 262,144 B, total: 96% used)

stm32-sim-stm32h753

  • FLASH: .text +952 B (+0.5%, 205,420 B / 2,097,152 B, total: 10% used)

No memory changes detected for:


Catch memory regressions in CI with MemBrowse. Free for open source.

@jackctj117

Copy link
Copy Markdown
Contributor Author

Jenkins retest this please.

@jackctj117

jackctj117 commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor Author

@claude review

Comment thread wolfcrypt/src/kdf.c Resolved
Comment thread wolfcrypt/src/hmac.c Resolved
Comment thread wolfcrypt/src/ecc.c Resolved
@jackctj117

Copy link
Copy Markdown
Contributor Author

Jenkins retest this please.

@jackctj117

Copy link
Copy Markdown
Contributor Author

https://github.com/wolfSSL/fips/pull/420 Has to merge first for this PR to pass Jenkins testing.

@jackctj117 jackctj117 added the For FIPS v7 Module Related to FIPS v7.0.0 module prep for submission label Nov 2, 2026
kaleb-himes added a commit to kaleb-himes/wolfssl that referenced this pull request Nov 8, 2026
kaleb-himes added a commit to kaleb-himes/wolfssl that referenced this pull request Nov 8, 2026
@kaleb-himes kaleb-himes mentioned this pull request Nov 9, 2026
1 of 4 tasks
kaleb-himes added a commit to kaleb-himes/wolfssl that referenced this pull request Nov 9, 2026
kaleb-himes added a commit to kaleb-himes/wolfssl that referenced this pull request Nov 9, 2026
kaleb-himes added a commit to kaleb-himes/wolfssl that referenced this pull request Nov 9, 2026
kaleb-himes added a commit to kaleb-himes/wolfssl that referenced this pull request Nov 9, 2026
kaleb-himes added a commit to kaleb-himes/wolfssl that referenced this pull request Nov 10, 2026
kaleb-himes added a commit to kaleb-himes/wolfssl that referenced this pull request Nov 10, 2026
@jackctj117
jackctj117 force-pushed the PQ-FIPS-Fenrir branch 2 times, most recently from 6fb9078 to 10b95fa Compare November 11, 2026 19:38
…since FIPS 198-1 Section 4 folds them to K0 = H(K) but they fall outside the module's CAVP-tested key range (Fenrir F-9546).
…elow 224 bits under FIPS v7 per SP 800-131A Rev. 2 Table 2, leaving signature verification with those curves available as legacy use (Fenrir F-7359).
…tyle test vectors and keep them covered through the wc_HmacSetKey_ex allowFlag escape (Fenrir F-9546).
The kernel's testmgr HMAC vectors use 131-byte keys, which the
HMAC_FIPS_MAX_KEY cap rejected on 6.0+ kernels.

Copilot AI left a comment

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.

🟡 Changes recommended

Critical active findings show that alternate hardware and callback implementations can bypass the new ECC curve-size and HMAC key-length restrictions, leaving the approved-mode enforcement incomplete.

3 open issues
3 resolved since last review

Review effort: Lite

Comment thread wolfcrypt/src/ecc.c Resolved
Comment thread wolfcrypt/src/hmac.c Resolved
Comment thread wolfssl/wolfcrypt/hmac.h Resolved

@wolfSSL-Fenrir-bot wolfSSL-Fenrir-bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Fenrir Automated Review — PR #11359

Scan targets checked: linuxkm-src, linuxkm-bugs, wolfcrypt-src, wolfcrypt-bugs, wolfssl-src, wolfssl-bugs
Coverage: 7 of 7 in-scope changed file(s) opened by the reviewer

Findings: 3
3 finding(s) posted as inline comments (see file-level comments below)

This review was generated automatically by Fenrir. Reported findings require changes before merge.

Review tier: Max

Comment thread linuxkm/lkcapi_sha_glue.c Resolved
Comment thread wolfcrypt/src/kdf.c Resolved
Comment thread wolfcrypt/src/ecc.c Resolved
…k and hardware dispatch

The gate sat only in the software wc_ecc_sign_hash_ex(), so wc_ecc_sign_hash() could hand a sub-224-bit key to a crypto callback or hardware backend first, and the STM32 PKA wc_ecc_sign_hash_ex() had no check at all. All three entry points now share one check.

Copilot AI left a comment

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.

🔵 Needs a closer look

Approval is blocked by two critical correctness issues: the HMAC key-length exemption applies to ordinary setkey calls, and curve validation accepts non-approved curves based solely on byte size.

No open issues 🎉

2 previously missed issues

In code that hasn't changed since last review

High severity Self-test build bypasses the HMAC maximum for normal callers

linuxkm/​lkcapi_sha_glue.c:1420

WC_LINUX_CONFIG_SELFTESTS is a compile-time configuration flag, so this path is also used for ordinary crypto_shash_setkey calls after the kernel self-tests finish. In FIPS v7, any key longer than HMAC_FIPS_MAX_KEY is therefore sent through allowFlag = 1, which bypasses the new maximum and lets normal callers use an overlong HMAC key whenever kernel self-tests are enabled. The self-test exemption needs to be scoped to the kernel's self-test invocation (or normal setkey calls must be validated before this override) rather than applied to every call in a self-test-enabled build.

High severity Key-size check permits non-approved ECC curves

wolfcrypt/​src/​ecc.c:6548

Checking only the byte size is not sufficient for the stated FIPS v7 approved-curve restriction. When a non-NIST curve such as ECC_SECP256K1 is compiled, wc_ecc_get_curve_size_from_id() returns 32, so this check passes and _ecc_make_key_ex() generates a key on that non-approved curve. Please gate explicit curve IDs with the module's approved-curve allowlist (while preserving the default-curve resolution).

3 resolved since last review

Review effort: Lite

@wolfSSL-Fenrir-bot wolfSSL-Fenrir-bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Fenrir Automated Review — PR #11359

Scan targets checked: linuxkm-src, linuxkm-bugs, wolfcrypt-src, wolfcrypt-bugs, wolfssl-src, wolfssl-bugs
Failed targets: wolfcrypt-port-bugs
Coverage: 3 of 4 in-scope changed file(s) opened by the reviewer; not opened: tests/api/test_ecc.c

Findings: 1
1 finding(s) posted as inline comments (see file-level comments below)

This review was generated automatically by Fenrir. Reported findings require changes before merge.

Review tier: Lite

@jackctj117

Copy link
Copy Markdown
Contributor Author

@claude review

Copilot AI left a comment

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.

🔵 Needs a closer look

Human assessment is needed because multiple critical hidden findings indicate that the approved-mode restrictions can be bypassed across HMAC, ECC, and KDF paths, with additional backend behavior implications.

No open issues 🎉

Review effort: Lite

@wolfSSL-Fenrir-bot wolfSSL-Fenrir-bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Fenrir Automated Review — PR #11359

Scan targets checked: linuxkm-src, linuxkm-bugs, wolfcrypt-src, wolfcrypt-bugs, wolfcrypt-port-bugs, wolfssl-src, wolfssl-bugs
Coverage: 5 of 5 in-scope changed file(s) opened by the reviewer

Fenrir result: Approved ✅

No new issues found in the changed files.

Advisory only — this automated result does not count as a GitHub approval.

Review tier: Lite

@wolfSSL-Fenrir-bot
wolfSSL-Fenrir-bot dismissed stale reviews from themself November 12, 2026 16:50

Fenrir's latest completed scan found no issues; clearing the prior automated change request.

Comment thread wolfcrypt/src/kdf.c Resolved
Comment thread wolfcrypt/src/ecc.c Resolved
…t runs update and final

In a WOLFSSL_KCAPI_HMAC build wc_HmacSetKey_ex() was the software implementation while wc_HmacUpdate() and wc_HmacFinal() were the KCAPI ones, so a caller of the _ex form (the FIPS v7 TLS PRF, HKDF, PBKDF2) keyed one backend and then updated a KCAPI handle that was never created. The software form is now wc_HmacSetKey_ex_Software() in those builds and kcapi_hmac.c provides wc_HmacSetKey_ex(), with wc_HmacSetKey() calling it.
…olves the key's curve

A key referenced by id or label has no curve until the callback fills it in, so it passed the check made before dispatch. A signature made on a sub-224-bit curve is now wiped and SIG_TYPE_E returned.
…keys up to 2048 bits

The cap made wc_HmacSetKey() return BAD_LENGTH_E for the 129- and 256-byte keys in harness/vectors-v2/HMAC/req/HMAC.req, failing PRB-fips-repo-and-harness-test. Removes the cap, the PRF and linuxkm exemptions that existed only to work around it, and the tests that expected the rejection.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

For FIPS v7 Module Related to FIPS v7.0.0 module prep for submission

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants