checkId: doctor.evidence.timestamp.revocation.cache-fresh family: doctor-check/v1 service: evidence-web scope: installation severity: warning tags: [timestamping, revocation, cache, freshness, evidence]
Revocation Cache Fresh
Stella Ops is self-hosted software. It does not issue electronic time stamps or provide any qualified trust service. This deployment performs local verification using operator-supplied evidence. Unless an approved jurisdiction-, provider-, service-, and deployment-specific claim profile applies, qualified status is not determined.
Checks that the validated revocation material Evidence holds (the OfflineKit bundle’s OCSP and CRL snapshot) is inside its freshness budget and that every REQUIRED kind is present. An empty cache has no stale entry, which is why the installation must state what should have been cached. Default severity when it fails: warning. Installation-scoped: one result per estate, served on the Evidence doctor path and probed on the worker schedule revocation-refresh (hourly).
What it measures
- Fails when a kind named by
RequiredRevocationKinds(ocsp,crl) has no entry. - Fails when any entry is older than its budget:
OcspCacheMaxAge(default 12 h) orCrlCacheMaxAge(default 7 d).
The check never reports a pass for a value it does not have. When its source cannot be read it reports unhealthy with the message Source unavailable (<reason>): <detail>. No verdict can be reported. and the evidence keys source.state=unavailable, source.reason (one of source-not-configured, source-configuration-invalid, unavailable-by-sealed-policy, source-material-invalid, source-read-failed) and source.detail.
Evidence keys
revocationCache.entryCountrevocationCache.missingRequiredKindsrevocationCache.staleEntryCount
Every value is a bounded measurement or pointer; no token bytes, trust material or credentials appear in evidence.
Common causes
- No bundle is configured (
source-not-configured). - The bundle was not refreshed inside the budget.
- The bundle carries a CRL but the installation requires OCSP too.
Configuration
Trust material never comes from a configured date or a bare URL. Online estates may point the TSA path at a PEM anchor file (Evidence__TimestampAssurance__Adapters__TrustAnchorBundlePath); a sealed estate mounts the OfflineKit timestamp-trust-bundle/v1 artifact, which is signature-verified before any part of it is read:
Evidence__TimestampAssurance__TrustBundle__BundleDirectory: "/mnt/offline-kit/timestamp-trust-bundle"
Evidence__TimestampAssurance__TrustBundle__Anchors__0__KeyId: "offline-kit-2026"
Evidence__TimestampAssurance__TrustBundle__Anchors__0__PublicKeyPemFilePath: "/mnt/offline-kit/keys/offline-kit-2026.pub"
Evidence__TimestampAssurance__TrustBundle__AcceptedProducers__0: "stellaops-offline-kit"
Evidence__TimestampAssurance__TrustBundle__RequiredRevocationKinds__0: "crl"
With a bundle configured, trust anchors and the revocation snapshot are answered from the artifact and the TSA-path measurements from the local responder; a bundle that fails validation makes every artifact-dependent check unavailable with reason source-material-invalid and the rejection code as detail. A replaced artifact is re-read within a minute.
Thresholds live in Evidence__TimestampAssurance__Policy__* and default to the values the retired Doctor plugin used (carried verbatim so a cadence or threshold change is always a visible edit).
How to verify
The 17 installation checks are served by evidence-web on the shared doctor-check/v1 path and need the ops.health scope. Probe the service DIRECTLY from inside the estate network: the gateway’s unprefixed /doctor/evidence/checks resolves to whichever service registered that template first, not to Evidence.
curl -sS -H "Authorization: Bearer $OPS_HEALTH_TOKEN" \
http://evidence-web.stella-ops.local:8080/doctor/evidence/checks \
| jq '.checks[] | select(.checkId == "doctor.evidence.timestamp.revocation.cache-fresh")'
Once the Evidence doctor registration is activated (it is off by default in a sealed estate), the same result is also visible through the Platform doctor aggregator under the evidence service.
Related checks
- OCSP Responder (
doctor.evidence.timestamp.revocation.ocsp-responder) - CRL Distribution Point (
doctor.evidence.timestamp.revocation.crl-distribution) - Trusted List Fresh (
doctor.evidence.timestamp.eidas.trust-list-fresh)
This is a local evidentiary classification of the token and issuing service at the stated time. It is not the output of a qualified validation or qualified preservation service and does not determine the legal effect of the underlying release, document, or transaction.
