Generated from
who-iris/processes/iris-cdn-sign-publish.bpmnbygen-processes-viz.ts— do not edit here. All processes · who-iris processes
Sign and publish an IRIS CDN release
Process_IrisCdnSignPublish · strict (defaulted) · 8 step(s)
Turn a candidate payload into a signed release on Cloudflare: each changed library item gets a detached JWS over its own manifest, and the BagIt bag (RFC 8493) whose tagmanifest pins every item manifest and signature is signed once with a detached JWS (RFC 7515 Appendix F, ES256 per RFC 7518), the key published as a verificationMethod of a did:web DID document whose publicKeyJwk carries an x5c chain to the WHO signing key. Nothing unchanged is re-uploaded or re-signed; an empty diff ends the process with no commit.
How it connects
- Called by: IRIS CDN initial load, IRIS CDN nightly change ingest, IRIS CDN weekly reconciliation
- Calls: none
- Presented on: no docs page section shows this diagram
- Running instances: none recorded
Lanes — who acts
Steps
2 of 8 step(s) carry no documentation — activity-documented lists them.
| step | lane | skill / sub-process | what it does |
|---|---|---|---|
Write the BagIt tag files (sorted, no dates)Task_BuildBag | Build pipeline | iris-cdn-signing | scripts/iris-cdn/bag.ts tagFiles: manifest-sha256.txt sorted by path, bag-info.txt with Payload-Oxum and no Bagging-Date. |
Diff against the published manifestTask_Diff | Build pipeline | iris-cdn-signing | — |
Store new objects (never overwrite)Task_Upload | Release signer | iris-cdn-exporter | Content-addressed: an object whose SHA-256 is already stored is skipped. Published objects are never deleted by a nightly run. |
Sign each changed item manifest (ES256)Task_SignItems | Release signer | iris-cdn-signing | A signature on each library item: items/<handle>/manifest-sha256.txt lists the item record and its files; its detached JWS sits beside it. Only items whose manifest bytes changed are signed: ES256 is randomised, so re-signing an unchanged item would be churn. The item manifests and their signatures join the payload, so the tag files are refreshed to cover them before the release is signed. |
Sign the release tag manifest (ES256)Task_Sign | Release signer | iris-cdn-signing | scripts/iris-cdn/signing.ts signDetached. kid is a did:web DID URL listed under assertionMethod. |
Commit tag files and signature, lastTask_PublishTags | Release signer | iris-cdn-signing | One commit to the Cloudflare git repository, after every payload object is in place, so a reader never sees a manifest naming bytes that are not there yet. |
Resolve did:web; verify JWS and digestsTask_Verify | Verifier | iris-cdn-signing | scripts/iris-cdn/run.ts checkRelease: every tag file against tagmanifest-sha256.txt, then scripts/iris-cdn/signing.ts verifyDetached against the DID document fetched from its did:web URL. |
Revert to the previous releaseTask_Revert | Verifier | iris-cdn-signing | — |
Decisions
2 of 2 decision(s) carry no documentation — gateway-documented lists them.
| decision | what decides it | branches |
|---|---|---|
Anything changed?GW_Empty | — | no → Unchanged: no commit yes → Store new objects (never overwrite) |
Verified?GW_Verified | — | yes → Release published and verified no / unknown → Revert to the previous release |