Skip to content

[Async AE 2] Add async crypto utilities - #5079

Open
cheenamalhotra wants to merge 4 commits into
dev/cheena/async-ae-key-cachefrom
dev/cheena/async-ae-crypto-utilities
Open

cheenamalhotra wants to merge 4 commits into
dev/cheena/async-ae-key-cachefrom
dev/cheena/async-ae-crypto-utilities

Conversation

@cheenamalhotra

@cheenamalhotra cheenamalhotra commented Nov 16, 2026 •

Copy link
Copy Markdown
Member

Description

Layer 2/5 split from #4585; depends on #5077. Adds async CEK decryption and CMK signature verification in SqlSecurityUtility, preserving provider selection, candidate fallback, error wrapping, cancellation precedence, and signature-cache publication. Production changes match the original source delta; newer-main changes remain intact. No call-site wiring or public API changes. Retains milestone 8.1.0-preview1.

Review follow-up adds six isolated global-provider cases covering canceled true/false results completing inline or asynchronously, retry after cancellation, and positive/negative cache publication and reuse. A non-parallel collection and reversible registration/cache scope prevent shared-state leakage. Includes layer 1's explanatory comments and post-wait cache-recheck race fix through prerequisite merges.

  • Tests added or updated
  • Public API changes documented (none)
  • Verified against customer repro (not applicable to this isolated layer)
  • Ensure no breaking changes introduced

Issues

Relates to #3672. Split from #4585, which remains untouched. Depends on #5077.

Testing

Utility tests were relocated from the original source with focused scenarios, XML summaries, and stronger error assertions; cache-only coverage stays in layer 1. Current focused suite: 51 passed, 0 failed, 0 skipped in both Debug and Release (34 utility + 17 cache cases).

Each command passed at head c75f65fc:

dotnet test src/Microsoft.Data.SqlClient/tests/UnitTests/Microsoft.Data.SqlClient.UnitTests.csproj -f net10.0 -c Debug --no-restore --filter 'FullyQualifiedName~SqlSecurityUtilityTests|FullyQualifiedName~SymmetricKeyCacheTests' --blame-hang-timeout 10m
dotnet test src/Microsoft.Data.SqlClient/tests/UnitTests/Microsoft.Data.SqlClient.UnitTests.csproj -f net10.0 -c Release --no-restore --filter 'FullyQualifiedName~SqlSecurityUtilityTests|FullyQualifiedName~SymmetricKeyCacheTests' --blame-hang-timeout 10m

Latest net462 compile check passed with 0 warnings/errors:

dotnet build src/Microsoft.Data.SqlClient/tests/UnitTests/Microsoft.Data.SqlClient.UnitTests.csproj -f net462 -c Debug --no-restore

Cumulative CI: #5085, build 192590, tested aa9fadbf including every lower layer. UnitTests passed: Linux net10 2668/0 failed, Windows net10 2692/0, net462 2588/0. Simulated-server tests ran; none of the stack's tests were skipped. AE manual tests: 246 passed, 0 failed; only enclave tests were skipped because CI has no enclave server.

Local validation was on macOS, without SQL Server, AKV, or net462 runtime execution. Command/enclave integration belongs to later layers.

Guidelines

Please review the contribution guidelines before submitting a pull request:

cheenamalhotra and others added 2 commits November 16, 2026 12:05
Split layer 2 from #4585: decrypt CEKs and verify CMK signatures asynchronously, preserving provider fallback and cancellation behavior.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 16, 2026 19:05
@github-project-automation github-project-automation Bot moved this to To triage in SqlClient Board Nov 16, 2026
@cheenamalhotra cheenamalhotra added this to the 8.1.0-preview1 milestone Nov 16, 2026

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 signature-cache miss/publication path lacks tests proving canceled verification results stay out of the shared cache and uncanceled results are published and reused.

1 open issue
What changed in this PR

Adds the second foundation layer for async Always Encrypted support, building on the async key cache in #5077. Command integration remains deferred to later layers; no public APIs change.

Changes:

  • Adds async column-encryption key decryption with provider selection and candidate fallback.
  • Adds async column-master-key signature verification with cancellation handling and shared-cache publication.
  • Adds unit tests for provider dispatch, fallback, error wrapping, cancellation, and cached signature results.
File Description
src/​Microsoft.Data.SqlClient/​tests/​UnitTests/​Microsoft/​Data/​SqlClient/​SqlSecurityUtilityTests.cs Adds regression coverage for async cryptographic utilities.
src/​Microsoft.Data.SqlClient/​src/​Microsoft/​Data/​SqlClient/​SqlSecurityUtility.cs Adds async key-decryption and signature-verification helpers.

Review effort: Balanced

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

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

Required review-policy references were unavailable from a trusted immutable source, preventing verification of repository-specific review gates.

1 open issue

Review effort: Balanced

@codecov

codecov Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 96.80000% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 70.27%. Comparing base (16919af) to head (c75f65f).

Files with missing lines Patch % Lines
...src/Microsoft/Data/SqlClient/SqlSecurityUtility.cs 96.80% 4 Missing ⚠️
Additional details and impacted files
@@                        Coverage Diff                        @@
##           dev/cheena/async-ae-key-cache    #5079      +/-   ##
=================================================================
+ Coverage                          70.07%   70.27%   +0.19%     
=================================================================
  Files                                314      314              
  Lines                              69893    70018     +125     
=================================================================
+ Hits                               48981    49202     +221     
+ Misses                             20912    20816      -96     
Flag Coverage Δ
sqlclient-pr 70.27% <96.80%> (+0.19%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ 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.

Add isolated global-provider coverage for canceled inline and suspended verification results, retry, and positive/negative result reuse.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 16, 2026 20:20

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

Repository-specific review gates remain unverified because no trusted immutable source was established for the required policy references.

No open issues 🎉

1 resolved since last review

Review effort: Balanced

@cheenamalhotra
cheenamalhotra marked this pull request as ready for review November 17, 2026 06:28
@cheenamalhotra
cheenamalhotra requested a review from a team as a code owner November 17, 2026 06:28
@cheenamalhotra cheenamalhotra changed the title Add async Always Encrypted crypto utilities (2/5) [Async AE 2] Add async crypto utilities Nov 17, 2026
@cheenamalhotra cheenamalhotra added the Hotfix 8.0.0 PRs that must be backported to release/8.0 label Nov 17, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Hotfix 8.0.0 PRs that must be backported to release/8.0

Projects

Status: To triage

Development

Successfully merging this pull request may close these issues.

4 participants