Skip to content

crypto: migrate sha2/hmac/subtle usage to aws-lc-rs#35853

Draft
jasonhernandez wants to merge 28 commits intoMaterializeInc:mainfrom
jasonhernandez:jason/sec-206-migrate-sha2-hmac-subtle-awslcrs
Draft

crypto: migrate sha2/hmac/subtle usage to aws-lc-rs#35853
jasonhernandez wants to merge 28 commits intoMaterializeInc:mainfrom
jasonhernandez:jason/sec-206-migrate-sha2-hmac-subtle-awslcrs

Conversation

@jasonhernandez
Copy link
Copy Markdown
Contributor

Summary

  • Replace sha2, hmac, subtle, and sha1 crate usage with aws-lc-rs equivalents across 11 crates to consolidate on a single FIPS 140-3 validated crypto backend
  • sha2 removed from: mz-adapter, mz-avro, mz-catalog, mz-expr, mz-fivetran-destination, mz-license-keys, mz-npm, mz-orchestrator-kubernetes, mz-orchestratord, mz-persist, mz-storage
  • hmac migrated in: mz-expr (SHA-1/224/256/384/512 → aws_lc_rs::hmac; MD5 HMAC retained with hmac crate since aws-lc-rs doesn't provide HMAC-MD5)
  • subtle removed from: mz-expr → aws_lc_rs::constant_time
  • sha1 removed from: mz-expr → aws_lc_rs::digest::SHA1_FOR_LEGACY_USE_ONLY
  • digest crate removed from: mz-avro (fingerprint API changed from fingerprint::<Sha256>() generic to fingerprint(&digest::SHA256) parameter)
  • mz-persist: removed sha2 "asm" performance dep (aws-lc-rs uses native assembly)

SEC-206

Test plan

  • cargo check passes on all 11 affected crates
  • cargo test -p mz-avro -- test_schema_fingerprint passes
  • cargo fmt clean
  • cargo deny check passes (bans + licenses)
  • CI green

Checklist

  • Tests pass
  • Lint clean
  • Release notes updated (internal crypto migration, not user-visible)

Generated with Claude Code

jasonhernandez and others added 12 commits April 2, 2026 10:10
Add bin/lint-openssl to detect all openssl dependencies, feature flags,
and source imports across the workspace. This is the first step toward
migrating from openssl to rustls—it serves as a tracking tool for
migration progress and can later be promoted to a CI gate.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Add migration plan (doc/developer/openssl-to-rustls-migration.md) with
tiered breakdown of all 28 affected crates, dependency graph, replacement
crate mapping, and links to Linear issues (SEC-176 through SEC-200).

Include raw linter output snapshots (.txt and .json) as baseline for
tracking progress.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Replace all non-FIPS crypto crate recommendations (ring, sha2, hmac,
pbkdf2, subtle, rsa, ed25519-dalek, aes+cbc) with aws-lc-rs equivalents.
Add FIPS 140-3 strategy section, workspace fips feature flag (SEC-201),
and updated replacement crate mapping table.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Add [[bans.deny]] entries for crypto crates that are not FIPS 140-3
validated: sha2, hmac, subtle, ring, pbkdf2, ed25519-dalek, aes, cbc,
rsa. All new crypto code must use aws-lc-rs instead.

Existing workspace and third-party usage is allowed via wrappers, with
TODO comments to remove them as each crate is migrated to aws-lc-rs.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Add bin/lint-fips-containers to scan Dockerfiles for FIPS 140-3
compliance gaps: non-FIPS base images, crypto-relevant package
installations, and non-FIPS algorithms in cert generation scripts.

Distinguishes production images (must comply) from test/dev
(informational). Supports --strict and --json flags.

Current results: 8 production findings across 4 base images.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Covers all three compliance layers: Rust binaries (137 openssl findings
across 28 crates + sha2/hmac/subtle), container images (8 production
findings across 4 base images), and Kubernetes/Helm deployment (Ed25519,
image validation, external services, FIPS toggle).

Includes full issue inventory (SEC-176 through SEC-213), remediation
strategy, recommended execution order, and FIPS validation caveat.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Remove the rustls ban from deny.toml, unblocking all openssl-to-rustls
migration work.

Add `aws-lc-rs` as an optional dependency in mz-ore with two feature
flags:
- `crypto`: enables aws-lc-rs in standard mode
- `fips`: enables aws-lc-rs with FIPS 140-3 validated module

mz-ore is the natural distribution channel since every crate in the
workspace depends on it. Downstream crates enable `mz-ore/crypto`
(or `mz-ore/fips` for FIPS builds) to get the validated backend.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
The `fips` feature on mz-ore enables `aws-lc-rs/fips`, which pulls in
`aws-lc-fips-sys`. That crate builds BoringSSL's FIPS module via cmake,
requiring Go for integrity verification. Since cargo-test runs with
`--all-features`, Go must be available in the CI builder.

Fixes SEC-232.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
uuid 1.23.0 changed error message format which breaks the
fmt_ids test in mz-persist-types.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

Thanks for opening this PR! Here are a few tips to help make the review process smooth for everyone.

PR title guidelines

  • Use imperative mood: "Fix X" not "Fixed X" or "Fixes X"
  • Be specific: "Fix panic in catalog sync when controller restarts" not "Fix bug" or "Update catalog code"
  • Prefix with area if helpful: compute: , storage: , adapter: , sql:

Pre-merge checklist

  • The PR title is descriptive and will make sense in the git log.
  • This PR has adequate test coverage / QA involvement has been duly considered. (trigger-ci for additional test/nightly runs)
  • If this PR includes major user-facing behavior changes, I have pinged the relevant PM to schedule a changelog post.
  • This PR has an associated up-to-date design doc, is a design doc (template), or is sufficiently small to not require a design.
  • If this PR evolves an existing $T ⇔ Proto$T mapping (possibly in a backwards-incompatible way), then it is tagged with a T-proto label.
  • If this PR will require changes to cloud orchestration or tests, there is a companion cloud PR to account for those changes that is tagged with the release-blocker label (example).

@jasonhernandez jasonhernandez force-pushed the jason/sec-206-migrate-sha2-hmac-subtle-awslcrs branch from a57c483 to f95d199 Compare April 2, 2026 21:46
jasonhernandez and others added 4 commits April 2, 2026 14:56
Pin three deps that were inadvertently bumped during Cargo.lock
regeneration:
- os_info 3.11.0: avoids objc2 0.6.x which causes E0275 on macOS
- chrono-tz 0.8.1: avoids Egypt timezone data change that breaks
  test_pg_timezone_abbrevs
- serde_path_to_error 0.1.8: avoids error message format change
  that breaks test_mcp_observatory

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Switch TLS backend from openssl/native-tls to rustls:
- mz-cloud-resources: kube openssl-tls → rustls-tls
- mz-npm: reqwest native-tls-vendored → rustls-tls-webpki-roots-no-provider
- mz-testdrive: reqwest native-tls-vendored → rustls-tls-webpki-roots-no-provider

Uses the -no-provider variant for reqwest to avoid pulling in ring,
allowing aws-lc-rs to serve as the crypto provider instead.

Deferred: tiberius (SEC-223, fork needs rustls fix), segment and duckdb
(no rustls feature available), storage-types (has direct native-tls dep).

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
The client-legacy feature was previously activated transitively. After
Cargo.lock regeneration, the transitive activation stopped and
`hyper_openssl::client` became configured out. Enable it explicitly.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
@jasonhernandez jasonhernandez force-pushed the jason/sec-206-migrate-sha2-hmac-subtle-awslcrs branch from f95d199 to 1543175 Compare April 2, 2026 22:00
jasonhernandez and others added 11 commits April 2, 2026 16:16
The webpki-roots 1.0.6 crate uses the CDLA-Permissive-2.0 license, which
is already allowed in deny.toml but was missing from about.toml (the
cargo-about config that must be manually kept in sync).

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
- mz-aws-util: remove custom hyper-tls HTTP client override; the AWS SDK
  already uses rustls by default, so the native-TLS override was
  unnecessary
- mz (CLI): reqwest default-tls → rustls-tls-webpki-roots-no-provider
- mz-persist: reqwest default-tls → rustls-tls-webpki-roots-no-provider

Deferred: mz-dyncfg-launchdarkly (LD SDK takes hyper_tls::HttpsConnector
directly — needs upstream/fork change), mz-persist openssl-sys removal
(has openssl_sys::init() hack that needs investigation), mz CLI
openssl-probe removal (needs source changes for cert discovery).

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Remove references to native-TLS policy override and hyper-tls dep in
generated docs. The AWS SDK's default rustls client is now used directly.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
The client-legacy feature was previously activated transitively through
hyper-tls in mz-ore. After replacing hyper-tls with hyper-rustls, the
transitive activation stopped and `hyper_openssl::client` became
configured out. Enable it explicitly.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
The PR removed the custom hyper-tls HTTP client from aws-util but
didn't enable the `default-https-client` feature on aws-config. With
default-features = false, no HTTP client was bundled, causing
environmentd to crash on startup.

Also pin os_info to 3.11.0 to avoid pulling in objc2 0.6.x which
causes E0275 overflow on macOS clippy due to its blanket
IntoIterator impl on Retained<T>.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
…eature

Add a `telemetry` feature (default-enabled) to mz-adapter that gates
`launchdarkly-server-sdk` and `mz-segment` as optional deps. Add #[cfg]
guards on LD-specific code in config.rs and config/frontend.rs.

WIP: segment client refs in client.rs, coord.rs, coord/ddl.rs, and
coord/message_handler.rs still need cfg guards. The pattern is proven
but the threading is extensive — see SEC-229 for remaining work.

Compiles with default features. Does not yet compile with
--no-default-features (missing segment cfg guards).

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
…for FIPS

In FIPS mode, non-essential third-party SDKs must be excluded from the
binary at compile time (not just disabled at runtime). This adds a
`telemetry` Cargo feature to mz-adapter, mz-environmentd, and
mz-balancerd, plus a `sentry` feature to mz-ore, mz-orchestrator-tracing,
and mz-service.

When these features are disabled:
- Segment analytics client is compiled out via SegmentClient type alias
- LaunchDarkly SDK and dyncfg sync are excluded
- Sentry error reporting and panic integration are excluded
- CLI args are still accepted but values are ignored

All features are default-enabled so standard builds are unaffected.
FIPS builds use `--no-default-features` to exclude them.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Add a section to the FIPS compliance report documenting the Cargo feature
flags that gate third-party telemetry SDKs (Segment, LaunchDarkly, Sentry)
for FIPS builds.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
Replace all openssl cryptographic primitives in src/auth/src/hash.rs
with aws-lc-rs equivalents to ensure FIPS 140-3 compliance:

- openssl::rand::rand_bytes -> aws_lc_rs::rand::SystemRandom
- openssl::memcmp::eq -> aws_lc_rs::constant_time::verify_slices_are_equal
- openssl::pkey::PKey::hmac + openssl::sign::Signer -> aws_lc_rs::hmac
- openssl::sha::sha256 -> aws_lc_rs::digest
- openssl::pkcs5::pbkdf2_hmac -> aws_lc_rs::pbkdf2

Removes the openssl dependency from mz-auth entirely.

Part of SEC-198.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
### Motivation

This is a stacked PR for OIDC login PR:
MaterializeInc#35440
This PR let's the user retrieve the ID token for psql connection string

Changes that would go in are from the last commit 

### Description

- Added OIDC Connection modal similar to Connect modal for cloud console
to show the connection instructions and ID token

<img width="2680" height="1598" alt="image"
src="https://github.com/user-attachments/assets/494b2949-827f-489d-afd9-6ca86bf890b5"
/>



### Verification
Once logged in using SSO, take the connection string and put that in the
terminal. You will be prompted to put in a password so copy and paste
the id token to get authenticated
Replace sha2, hmac, and subtle crate usage with aws-lc-rs equivalents
to consolidate on a single FIPS 140-3 validated crypto backend.

Changes by crate:
- mz-adapter: sha2::Sha256 → aws_lc_rs::digest
- mz-avro: sha2/digest traits → aws_lc_rs::digest (fingerprint API
  changed from generic type parameter to algorithm reference)
- mz-catalog: sha2::Sha256 → aws_lc_rs::digest
- mz-expr: sha2/sha1 digests → aws_lc_rs::digest, hmac (sha1-512) →
  aws_lc_rs::hmac, subtle::ConstantTimeEq → aws_lc_rs::constant_time
  (hmac crate retained for MD5 HMAC only)
- mz-fivetran-destination: sha2::Sha256 → aws_lc_rs::digest
- mz-license-keys: sha2::Sha256 → aws_lc_rs::digest
- mz-npm: sha2::Sha256 → aws_lc_rs::digest
- mz-orchestrator-kubernetes: sha2::Sha256 → aws_lc_rs::digest
- mz-orchestratord: sha2::Sha256 → aws_lc_rs::digest
- mz-persist: removed sha2 "asm" perf dependency (aws-lc-rs uses
  native assembly)
- mz-storage: sha2 Digest trait → aws_lc_rs::digest::Context

Dependencies removed: sha2 (10 crates), subtle (1 crate), sha1 (1
crate), digest (1 crate). The hmac crate remains in mz-expr for
HMAC-MD5 (not available in aws-lc-rs).

Part of SEC-206.

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
@jasonhernandez jasonhernandez force-pushed the jason/sec-206-migrate-sha2-hmac-subtle-awslcrs branch from 1543175 to 71feb0b Compare April 2, 2026 23:43
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