build(secrets-ui): freeze UI 1.0.0 package inputs

This commit is contained in:
Joseph Doherty
2026-11-13 17:56:57 -05:00
parent 447f3c8bf0
commit bd257c6827
3 changed files with 102 additions and 0 deletions
+32
View File
@@ -146,6 +146,38 @@ SQL-Server store; once per node for per-node SQLite on a shared KEK). See the op
**metadata only**; revealing a value requires the `secrets:reveal` authorization policy and
is audited. Add/rotate/delete require `secrets:manage`.
### UI 1.0.0 integration
The UI release is independent of the Core/store/replicator versions. Its reviewed dependency set is
`ZB.MOM.WW.Secrets.Ui` 1.0.0, `ZB.MOM.WW.Secrets.Abstractions` 0.6.6 and `ZB.MOM.WW.Theme` 1.0.1.
Keep an older host’s Core/backend versions separate; update an explicit Abstractions pin together
with the UI to avoid a dependency downgrade. The global source version stays 0.6.6; this UI release
does not publish Core/backend 0.6.6 set.
Load Bootstrap before `<ThemeHead />`, and serve Razor class library static assets. The UI supplies
its own namespaced confirmation styling and imports its dialog/reveal DOM adapters from
`_content/ZB.MOM.WW.Secrets.Ui/js/`. No host Bootstrap modal plugin or separate scoped-CSS bundle
is required for those adapters. Use a supported modern browser with native `dialog.showModal`.
A globally interactive host can route the RCL page. A host with static routing must instead own
one `/admin/secrets` wrapper carrying `@rendermode InteractiveServer`, restate the manage policy,
and render `<SecretsPage />` as its child. Registering that wrapper and the RCL’s routable assembly
together creates a duplicate route; do not add a nested render mode to the RCL page.
The name filter searches loaded metadata only. Values remain hidden until an authorized,
successfully audited Reveal; they stay visible until Hide, row removal/filtering, or navigation.
A failed reveal audit withholds the value. Add/Rotate drafts and pending callbacks belong to their
exact target. A committed mutation whose metadata refresh fails is reported as saved with Retry
refresh; retry never replays the credential change. Manage and reveal policies remain distinct.
Abstractions 0.6.6 adds the default `IMasterKeyProvider.GetSnapshot()` contract and a caller-owned,
zeroed-on-disposal `MasterKeySnapshot`. Legacy providers still implement the original key/id
members; providers with rotating sources should implement an atomic snapshot. `SecretName` now
normalizes and limits names to 450 characters. Check legacy names longer than 450, including
tombstones, before adoption; this UI work includes no schema or data migration. Exact binary
compatibility results, package provenance and host acceptance are recorded in
[UI consistency validation](docs/ui-consistency-validation.md).
## Clustered deployments
Storage is local SQLite by default, which is correct for a single-process app and wrong the