Expand description
Webizen trust store — user-controlled trust anchors (P1).
The software provides the means to import, enable, disable, and evaluate roots; it does not silently redefine the OS PKI. Default suggested set is empty until the principal coins a bundle (AU community roots, etc.).
Honest scope of this module:
- Persist anchors (PEM certs, DID / front-door identifiers, labels).
- Produce a trust verdict for a URL (scheme + store membership + notes).
- Supply PEM material for our TLS clients (agent fetch via rustls/reqwest).
- OS WebView cert-override (WebView2
ServerCertificateErrorDetected) is a platform hook layered inwebizen-desktop; this store is the policy source.
Structs§
- Signed
Suggested Catalog - Envelope for a suggested catalog signed by the principal.
- Suggested
Anchor - One suggested anchor. Never auto-enabled unless
enabled_by_defaultis true (must stay false until the principal explicitly curates a default). - Suggested
Trust Catalog - Trust
Anchor - Trust
Store - Trust
Verdict
Enums§
- Anchor
Kind - Cert
Override Decision - Host / session / chain policy decision for cert-override (swarm-2).
Constants§
- CATALOG_
VERSION - SUGGESTED_
CATALOG_ FILE - Suggested catalog (empty until principal curates). Relative to storage or bundled.
- TRUST_
STORE_ FILE
Functions§
- bundled_
catalog_ path - Path to repo/package empty catalog when present.
- catalog_
signing_ payload - Canonical bytes for signing: JSON of catalog with sorted keys (serde_json value dump).
- cert_
override_ decision - Policy for ServerCertificateErrorDetected handlers (store only — no session).
Prefer
cert_override_decision_fullfor production hooks. - cert_
override_ decision_ full - Full policy: store + optional session allow-once + optional chain verify result.
- decision_
allows - Whether the decision should allow the WebView TLS connection.
- decision_
reason - Audit-friendly reason string.
- evaluate_
url - Evaluate how our store thinks about this URL (does not replace OS TLS for WebView).
- host_
deny_ material - Soft-deny material:
host-deny:<host> - import_
suggested_ into_ store - Import a suggested entry into the live store.
force_enabledoverridesenabled_by_default(UI “Enable now”). - load_
signed_ catalog_ path - Load signed catalog from path; unsigned plain catalog still loads via SuggestedTrustCatalog.
- spki_
pin_ material - SPKI pin material:
spki-pin:<host>:<sha256hex> - verify_
signed_ catalog - Verify Ed25519 signature over the catalog payload.