[freshtonic]

Layer 7 of the CIP-5203 stack. Implements CIP-5309.

• New crate stack-kms-azure: Key Vault REST 7.4 wrapkey/unwrapkey. RSA keys use RSA-OAEP-256; Managed HSM oct-HSM keys use A256KW. Both key modes.
• Azure has no AAD, so the AAD is bound with stack_kms_vendor::bound. The wrapped key is padded to 72 bytes.
• The stored form carries the versioned kid, so an unwrap needs no extra lookup.
• Credentials: client secret, workload identity, managed identity (IMDS and App Service), and a static token. Client-certificate auth is deferred.
• The shipped crate does not use rsa; it is only a dev-dependency, used by the emulator.
• Opt-in live workflow integration-azure-key-vault.yml. It needs the variable STACK_KMS_AZURE_LIVE_KEY (optionally also STACK_KMS_AZURE_LIVE_HSM_KEY) and the secrets STACK_KMS_AZURE_TENANT_ID, STACK_KMS_AZURE_CLIENT_ID and STACK_KMS_AZURE_CLIENT_SECRET.

Decisions are in docs/plans/2026-11-05-key-vendor-backends-decisions.md (CIP-5309 section).

[changeset-bot]

⚠️ No Changeset found

Latest commit: c905ced

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

[github-actions]

Mutation testing (cargo-mutants, --in-diff, stack-auth + stack-encrypt)

No mutants were generated for the changed lines.

[freshtonic]

Scope reduced (2026-11-12). This branch was rebuilt from one final tree by path, and the follow-up PRs #1555 to #1563 were folded in. The plan is docs/plans/2026-11-12-key-vendor-backends-scope-reduction.md; the decision log's "Scope reduction" section records each change. Decisions: no stack-encrypt change, no v2 leaf, and the wrapped data key mode deferred.

In this PR: no same_key. The AAD fixtures were computed again by a separate script. The fixture key name fix (#1555) is folded in.

[freshtonic]

Replaced by #1629, in the new stack #1633. The code is the same, rebased onto the latest next. The ADRs are now ADR-0013 and ADR-0014, and the text about the wrapped data key mode is removed.