This page describes the core business processes and workflows for the Personal Health Wallet (PHW) Implementation Guide, integrating IHE IT Infrastructure Privacy Consent on FHIR (PCF) v1.1.0 (https://profiles.ihe.net/ITI/PCF/1.1.0/) and IHE IT Infrastructure Verifiable Health Links (VHL) v1.0.0-comment (https://profiles.ihe.net/ITI/VHL/1.0.0-comment/).

A business process is a set of related activities or tasks performed together by system actors and human personas to achieve a health information exchange objective. Each workflow below is authored in BPMN 2.0 (input/business-processes/PHW.A.bpmn, input/business-processes/PHW.B.bpmn, input/business-processes/PHW.C.bpmn) with full BPMN Diagram Interchange (bpmndi:BPMNDiagram) layout and drawn from it to SVG (input/images/PHW.A.svg and so on) by tools/render-bpmn/render_bpmn.ts; never edit a drawing, change the BPMN. The data sharing agreement processes D to H, below, take the same form.

Architectural Principles

  1. Trust-Anchor Neutrality: Every process models PKI key publication ([ITI-YY1]) and trust list retrieval ([ITI-YY2]) against an abstract Trust Anchor actor (https://profiles.ihe.net/ITI/VHL/ActorDefinition/TrustAnchor). The WHO Global Digital Health Certification Network (GDHCN) is one possible Trust Anchor implementation among others (such as national health PKI roots, regional cross-border trust networks, or bilateral federation anchors).
  2. Explicit IHE PCF and VHL Transaction Binding: Every cross-actor task names its normative IHE transaction ([ITI-108] Access Consent, [ITI-YY1] Submit PKI Material with DID, [ITI-YY2] Retrieve Trust List with DID, [ITI-YY3] Generate VHL, [ITI-YY4] Provide VHL, [ITI-YY5] Retrieve Manifest).
  3. No IHE IUA Claim: Consent management and enforcement operate over IHE PCF [ITI-108] Access Consent and VHL [ITI-YY1]–[ITI-YY5] without claiming conformance to IHE Internet User Authorization (IUA [ITI-71]).
  4. Three-Valued Consent Decision and PROV-O Provenance: During VHL redemption (Process C), patient privacy consent directives retrieved via [ITI-108] are translated to W3C ODRL 2.2 policies (consentToOdrl()) and evaluated via three-valued decide() (permit deny unknown), recording a W3C PROV-O prov:Activity citing Consent.id and Consent.meta.versionId.

Overview of Key Business Processes

The following table summarizes the three BPMN 2.0 consent and Verifiable Health Link business processes defined in this Implementation Guide. The data sharing agreement processes are summarized in their own section below.

# Process Name Process ID Personas Objectives
A Record and Manage Patient Privacy Consent PHW.A Holder, Consent Recorder, Consent Registry Capture, update, or revoke a patient privacy consent directive (IHE.PCF.consentBasic or IHE.PCF.consentIntermediate) in a PCF Consent Registry via [ITI-108] Access Consent (Post, Put, Delete).
B Issue Consent-Backed Verifiable Health Link PHW.B Holder, VHL Sharer, Consent Registry, Trust Anchor Register VHL Sharer signing keys with a Trust Anchor ([ITI-YY1]), verify or record active patient consent ([ITI-108]), and generate a signed Verifiable Health Link ([ITI-YY3]) stored in the Holder’s Personal Health Wallet.
C Present and Redeem Verifiable Health Link with PCF Consent Enforcement PHW.C Holder, VHL Receiver, Trust Anchor, VHL Sharer, Consent Registry Present a VHL ([ITI-YY4]), verify cryptographic trust via a Trust Anchor ([ITI-YY2]), request the manifest ([ITI-YY5]), query active PCF Consent ([ITI-108]), and enforce three-valued (permit / deny / unknown) ODRL consent evaluation with PROV-O provenance.

Workflows

Process A — Record and Manage Patient Privacy Consent (PCF [ITI-108])
Activity ID Lane / Actor Task Name IHE PCF / VHL Transaction & Conformance Profile
PHW.A.1 VHL Holder (Patient / Personal Health Wallet) Select base policy & disclosure scope (PCF Basic / Intermediate Consent) Selection of base policy (Consent.policy.uri), PCFPurposeOfUseVS purpose of use, authorized actors, validity period, and clinical data scope
PHW.A.2 PCF Consent Recorder (Wallet / VHL Sharer) Construct FHIR Consent & Provenance (IHE.PCF.consentBasic / Intermediate) https://profiles.ihe.net/ITI/PCF/StructureDefinition/IHE.PCF.consentBasic, IHE.PCF.consentIntermediate, IHE.PCF.provenance
PHW.A.3 PCF Consent Recorder (Wallet / VHL Sharer) Create consent directive [ITI-108] Access Consent: Post [ITI-108] Access Consent (POST [base]/Consent or transaction Bundle with Provenance)
PHW.A.4 PCF Consent Recorder (Wallet / VHL Sharer) Update or revoke directive [ITI-108] Access Consent: Put / Delete [ITI-108] Access Consent (PUT [base]/Consent/[id] or DELETE [base]/Consent/[id])
PHW.A.5 PCF Consent Registry Validate, version & persist Consent + Provenance [ITI-108] Access Consent [ITI-108] Access Consent responder (IHE.PCF.consentRegistry), assigning Consent.id and Consent.meta.versionId
PHW.A.6 VHL Holder (Patient / Personal Health Wallet) Confirm recorded Consent.id & versionId [ITI-108] Access Consent response [ITI-108] Access Consent response (201 Created / 200 OK)

Process A is the person-side view of the data sharing agreement’s consent process (P9). The owner set four rules on 2026-10-30:

  1. Legal basis. Only an agreement whose legal basis is consent asks for consent. Treatment, public-health law and research waivers do not rest on consent.
  2. Version pinning. The person consents to one fixed version of the agreement: Consent.policy.uri is that version’s URL. If the agreement is amended to widen use, the new version needs new consent. An amendment that narrows use does not.
  3. Plain language. The person is shown the agreement’s plain-language summary, published and hashed with the agreement. That summary is what they consent to (task PHW.A.1).
  4. Scale. Where the person has recorded nothing, the jurisdiction’s chosen PCF implicit default policy applies: opt-in (for example Policy-deny) or opt-out (for example Policy-basic-normal or Policy-all-normal). Registry lookups may be cached (task PHW.C.5), but withdrawing a Consent (status becomes inactive, task PHW.A.4) ends every cached result that holds it at once.

Process B — Issue Consent-Backed Verifiable Health Link (VHL [ITI-YY1], [ITI-YY3], PCF [ITI-108])
Activity ID Lane / Actor Task Name IHE PCF / VHL Transaction & Conformance Profile
PHW.B.1 VHL Sharer (grouped with PCF Consent Recorder) Submit Sharer PKI signing key [ITI-YY1] Submit PKI Material with DID [ITI-YY1] Submit PKI Material with DID (https://profiles.ihe.net/ITI/VHL/Requirements/PublishPKIMaterial)
PHW.B.2 Trust Anchor (e.g. GDHCN, national, or regional anchor) Publish key in Trust Anchor trust list [ITI-YY1] (GDHCN or other anchor) [ITI-YY1] Submit PKI Material with DID (https://profiles.ihe.net/ITI/VHL/CapabilityStatement/IHE.VHL.TrustAnchor)
PHW.B.3 VHL Holder (Patient / Personal Health Wallet) Request VHL generation [ITI-YY3] Generate VHL ($generate-vhl) [ITI-YY3] Generate VHL (https://profiles.ihe.net/ITI/VHL/OperationDefinition/GenerateVHL)
PHW.B.4 VHL Sharer (grouped with PCF Consent Recorder) Query or record active Consent [ITI-108] Access Consent: Search / Post [ITI-108] Access Consent (GET [base]/Consent?patient=...&status=active or POST [base]/Consent)
PHW.B.5 PCF Consent Registry Return active PCF Consent (Consent.id + versionId) [ITI-108] Access Consent [ITI-108] Access Consent responder (IHE.PCF.consentRegistry)
PHW.B.5a VHL Sharer (grouped with PCF Consent Recorder) B5a. Add the consent directives to the shared documents (process M, optional) Optional (owner, 2026-11-07): before the VHL payload is assembled and signed, process M adds the consent directives the documents are shared under, explicit (the Consent returned at B5) or implied (the trust domain’s default policy), as consent entries listed in each document’s Advance Directives section. The copy in the document is evidence for the receiver; the Consent Registry copy is the one enforced.
PHW.B.6 VHL Sharer (grouped with PCF Consent Recorder) Assemble & sign VHL payload bound to Consent [ITI-YY3] Generate VHL [ITI-YY3] Generate VHL (IHE.VHL.VHLSharer), signing with [ITI-YY1] key material
PHW.B.7 VHL Holder (Patient / Personal Health Wallet) Store signed VHL in Personal Health Wallet [ITI-YY3] Generate VHL [ITI-YY3] Generate VHL response received by VHLHolder

Process C — Present and Redeem Verifiable Health Link with PCF Consent Enforcement (VHL [ITI-YY2], [ITI-YY4], [ITI-YY5], PCF [ITI-108])
Activity ID Lane / Actor Task Name IHE PCF / VHL Transaction & Conformance Profile
PHW.C.1 VHL Holder (Patient / Personal Health Wallet) Present VHL payload to Receiver [ITI-YY4] Provide VHL [ITI-YY4] Provide VHL (https://profiles.ihe.net/ITI/VHL/Requirements/UtilizeVHL)
PHW.C.2 VHL Receiver (Verifier / Relying Party) Request Trust Anchor key list [ITI-YY2] Retrieve Trust List with DID [ITI-YY2] Retrieve Trust List with DID (https://profiles.ihe.net/ITI/VHL/Requirements/RetrievePKIMaterial)
PHW.C.3 Trust Anchor (e.g. GDHCN, national, or regional anchor) Return signed trust list [ITI-YY2] (GDHCN or other Trust Anchor) [ITI-YY2] Retrieve Trust List with DID (IHE.VHL.TrustAnchor)
PHW.C.4 VHL Receiver (Verifier / Relying Party) Verify VHL signature & request manifest [ITI-YY5] Retrieve Manifest [ITI-YY5] Retrieve Manifest (https://profiles.ihe.net/ITI/VHL/Requirements/RequestVHLDocuments)
PHW.C.5 VHL Sharer (grouped with PCF Consent Authorization Server) Query active patient Consent [ITI-108] Access Consent: Search [ITI-108] Access Consent: Search (GET [base]/Consent?patient=...&status=active)
PHW.C.6 PCF Consent Registry Return active PCF Consent Bundle [ITI-108] Access Consent [ITI-108] Access Consent responder (IHE.PCF.consentRegistry), returning Consent.id and Consent.meta.versionId
PHW.C.7 VHL Sharer (grouped with PCF Consent Authorization Server) Evaluate PCF Consent (ODRL decide: permit / deny / unknown) & PROV-O log consentToOdrl() + three-valued decide() (permit | deny | unknown) + W3C PROV-O prov:Activity citing Consent.id and Consent.meta.versionId
PHW.C.8 VHL Sharer (grouped with PCF Consent Authorization Server) Return authorized manifest & documents [ITI-YY5] Retrieve Manifest (permit) [ITI-YY5] Retrieve Manifest (200 OK Bundle of DocumentReference / clinical resources when decision is permit)
PHW.C.9 VHL Sharer (grouped with PCF Consent Authorization Server) Refuse disclosure with OperationOutcome [ITI-YY5] (deny or unknown) [ITI-YY5] Retrieve Manifest (403 Forbidden OperationOutcome when decision is deny or unknown)
PHW.C.10 VHL Receiver (Verifier / Relying Party) Process clinical documents or refusal notice [ITI-YY5] response [ITI-YY5] Retrieve Manifest consumer (IHE.VHL.VHLReceiver)

Data Sharing Agreement Processes (Server to Server)

Processes D to H implement a data sharing agreement (DSA) between a data provider and a data recipient. Each one is a technical process from the DSA process analysis for folio-assistant#2702 (P4, P5, P11, P12 and P13). The owner chose this IG as their home on 2026-10-30 (19:59Z). They apply to every agreement, whether it is computable (a W3C ODRL 2.2 Agreement derived from the legal text) or document-only (a signed PDF). The only difference is where the access rule comes from: the ODRL Agreement, or a configuration an administrator sets by hand from the PDF.

What every process relies on:

# Process Name Process ID DSA process Objectives
D Register a Server Client under a Data Sharing Agreement PHW.D P4 Register the recipient’s server as an OAuth client (RFC 7591, UDAP via HL7 SSRAA, or by an administrator), authenticated by mTLS (RFC 8705) or a JWT assertion (RFC 7523; with UDAP, private_key_jwt with an x5c chain), and record which agreement versions it may act under.
E Server-to-Server Access under a Data Sharing Agreement PHW.E P5 Issue a short-lived, key-bound token (DPoP, RFC 9449) for an RFC 9396 authorization_details request whose identifier (§2.2) is the agreement’s fixed-version URL, after the access decision.
F Access Decision under a Data Sharing Agreement PHW.F P11 Run permits() on the verified grant and the agreement. A consent-based agreement also needs an active PCF Consent. The result is permit, deny or unknown, and unknown is never permit.
G Audit, Provenance and Duty Checks under a Data Sharing Agreement PHW.G P12 Record each decision as a W3C PROV-O record that cites the agreement, and as an IHE ATNA audit event ([ITI-20]). Record duty fulfilment and review it.
H Revocation and Suspension under a Data Sharing Agreement PHW.H P13 Stop grants (Bitstring Status List), tokens and clients (RFC 7009), and keys (trust list or CRL).

In the tables, † marks a section number cited from standing knowledge and not re-checked when this page was written. The RFC 9396, RFC 9449, RFC 8693, W3C VC 2.0, W3C Bitstring Status List and DCAT 3 sections were checked against the published specifications on 2026-10-30.

D. Register a Server Client under a Data Sharing Agreement

Process D — Register a Server Client under a Data Sharing Agreement (DSA P4)
Activity ID Lane / Actor Task Name Standard and section
PHW.D.1 Data Recipient System (OAuth client) Prepare client key or certificate under an accepted trust anchor Key published under an accepted anchor (DSA P3): DID Core 1.0 + did:web, or RFC 5280
PHW.D.2 Data Recipient System (OAuth client) Send dynamic client registration request (RFC 7591) RFC 7591 §3.1†; private_key_jwt metadata RFC 7523 §2.2†; tls_client_auth RFC 8705 §2.1†. RFC 7592 is Experimental and needs owner approval
PHW.D.3 Data Provider Administrator (person) Enter client by hand, scopes from the signed agreement text Document-only route. The change record cites the agreement URL and its SHA-256
PHW.D.4 Provider Authorization Server Validate client key or certificate against the accepted trust anchor DID document, RFC 5280 §6† path validation, or a local list. UDAP route: UDAP DCR §4‡ (SSRAA §3.2.3): software statement signature, x5c chain to the trust community’s anchor, requested parameters
PHW.D.5 Trust Anchor (GDHCN or another accepted anchor) Return trust list or certificate status GDHCN did:web:tng-cdn.who.int:v2:trustlist; CRL RFC 5280 §5†
PHW.D.6 Provider Authorization Server Record which agreement versions the client may act under Gap: neither RFC 7591 nor the SSRAA software statement has a field for this, so it is the server’s own configuration. It is keyed by the fixed-version URL, the same value as RFC 9396 identifier (§2.2)
PHW.D.7 Provider Authorization Server Issue client_id RFC 7591 §3.2.1†. UDAP route: 201 Created per UDAP DCR §5.1‡, error per §5.2‡ (SSRAA §3.2.3); modify or cancel per SSRAA §3.4
PHW.D.8 Data Recipient System (OAuth client) Read authorization server metadata RFC 8414 §3†. UDAP route: already read in PHW.D.9; token requests use SSRAA §5.2.1–§5.2.2
PHW.D.9 Data Recipient System (OAuth client) Discover UDAP server metadata (GET {baseURL}/.well-known/udap) HL7 SSRAA §2.1, §2.2, §2.3 (signed_metadata), §2.4; UDAP Server Metadata §1‡
PHW.D.10 Data Recipient System (OAuth client) Send UDAP registration request with signed software statement HL7 SSRAA §3.1 (claims; iss = certificate SAN URI; token_endpoint_auth_method = private_key_jwt), §3.2.3 (request body, udap = 1), §3.3 (certifications); UDAP DCR §2‡

UDAP route (owner approval, 2026-10-30 20:28Z). UDAP is used as profiled by HL7 Security for Scalable Registration, Authentication, and Authorization (SSRAA), hl7.fhir.us.udap-security 2.0.0 (STU 2, canonical http://hl7.org/fhir/us/udap-security), the IG that VHL’s OAuth with SSRAA Option names. Its trust is X.509: the client’s certificate chains to an anchor of a trust community, so a national X.509 PKI can serve as the anchor without GDHCN. SSRAA section numbers were read from the IG source (HL7/fhir-udap-security-ig, tag 2.0.0, commit d8ac5a63): they follow its page order, and they agree with the IG’s own cross-references, which is also how ITI-YY5 cites them (“SSRAA Sections 2 and 3”, “Section 5.2.1”). The rendered pages at hl7.org were not reachable to check. SSRAA 2.0.0 is US realm; the source’s main branch now builds a universal-realm successor, hl7.fhir.uv.fast-security 3.0.0 (STU 3 post-ballot CI build), not yet published. ‡ marks a section of a UDAP.org specification (UDAP Dynamic Client Registration STU1, UDAP Server Metadata STU1, UDAP JWT-Based Client Authentication STU1) as SSRAA links it; udap.org was not reachable to check it.

E. Server-to-Server Access under a Data Sharing Agreement

Process E — Server-to-Server Access under a Data Sharing Agreement (DSA P5)
Activity ID Lane / Actor Task Name Standard and section
PHW.E.1 Data Recipient System (OAuth client) Request token with authorization_details naming the agreement, plus DPoP proof or mTLS RFC 9396 §2 (type defined by the API), §2.2 (actions, locations, datatypes, identifier = fixed-version URL); DPoP proof jti, htm, htu, iat RFC 9449 §4.2; mTLS RFC 8705†; across domains Token Exchange RFC 8693 §2.1
PHW.E.2 Provider Authorization Server Authenticate client (private_key_jwt or mTLS) and check DPoP proof RFC 7523 §2.2†; RFC 8705 §2†; RFC 9449 §4.3†
PHW.E.3 Provider Authorization Server Decide access under the agreement Process F
PHW.E.4 Provider Authorization Server Issue short-lived key-bound token with granted details cnf / jkt RFC 9449 §6.1; granted details RFC 9396 §7, may be fewer than asked §7.1
PHW.E.5 Provider Authorization Server Refuse token request (deny or unknown) RFC 6749 §5.2†; invalid_authorization_details RFC 9396 §5†
PHW.E.6 Data Recipient System (OAuth client) Call the API with token and DPoP proof RFC 9449 §4.2 (ath)
PHW.E.7 Provider Resource Server Validate token, key binding and granted details on every call Introspection RFC 7662 §2†; details RFC 9396 §9.2; key binding RFC 9449 §6.2
PHW.E.8 Provider Resource Server Record audit and provenance Process G
PHW.E.9 Provider Resource Server Return data or refusal —
PHW.E.10 Data Recipient System (OAuth client) Process response Duties recorded in process G

Gaps and open points in E. RFC 9396 has no field that holds an agreement’s URL and its hash. The fixed-version URL goes in identifier, and the SHA-256 published with that version fixes the bytes. No checked standard parameter carries the W3C VC 2.0 grant in a server-to-server token request. Until one is chosen, the client registration recorded in PHW.D.6 stands in for the grant. For a document-only agreement, scopes set by the administrator replace RAR details, and identifier can still carry the agreement URL for audit.

F. Access Decision under a Data Sharing Agreement

Process F — Access Decision under a Data Sharing Agreement (DSA P11)
Activity ID Lane / Actor Task Name Standard and section
PHW.F.1 Policy Decision Point (permits()) Collect inputs: verified requester, agreement version, grant, request Agreement versions: every one in force with the requester (PHW.D.6, PHW.I.4); a request MAY name some of them (RFC 9396 authorization_details[].identifier §2.2, or SSRAA consent_policy §5.2.1.1), which narrows the permissions it acts under. Grant: W3C VC 2.0 issuer §4.7, credentialSubject §4.8, validity §4.9, credentialStatus §4.10, relatedResource §5.3; principal: RFC 8693 act §4.1; purpose: HL7 PurposeOfUse
PHW.F.2 Policy Decision Point Verify the grant with smart-trust-tools against the accepted trust anchor litlfred/smart-trust-tools
PHW.F.3 Trust Anchor (GDHCN or another accepted anchor) Return trust list (DID document, X.509 roots or local list) DID Core 1.0 + did:web; RFC 5280†
PHW.F.4 Policy Decision Point Check grant status in the Bitstring Status List W3C Bitstring Status List §2.1 (revocation, suspension)
PHW.F.5 Grant Issuer Status List Return status list credential W3C Bitstring Status List
PHW.F.6 Policy Decision Point Fetch the agreement at its fixed-version URL; check SHA-256 and status SHA-256 against the catalogue’s spdx:checksum; a mismatch gives unknown
PHW.F.7 Agreement Publisher (DCAT catalogue) Return DCAT distribution with spdx:checksum and status DCAT 3 §6.8, §6.8.11, §6.8.20, §6.17; status §6.4.30 (RDF term unverified); versions §6.4.24, §11
PHW.F.8 Policy Decision Point Search active Consents for this agreement [ITI-108] Access Consent: Search [ITI-108]. A Consent counts when Consent.policy.uri equals the ODRL uid, or names an earlier version reached by dcat:previousVersion across narrowing amendments (fhir-harness#227, #228)
PHW.F.9 PCF Consent Registry Return matching Consents [ITI-108] Access Consent [ITI-108] responder (IHE.PCF.consentRegistry)
PHW.F.10 Policy Decision Point Evaluate permits() per applicable policy; combine with DMN PHW.DT.AgreementAccess ODRL 2.2; consentToOdrl(); document-only: the configuration from PHW.D.3. One result per agreement or Consent, combined by OMG DMN 1.5 decision PHW.DT.AgreementAccess (input/dmn/PHW.DT.AgreementAccess.dmn; the BPMN task’s implementation is the DMN 1.5 namespace)
PHW.F.11 Policy Enforcement Point Receive permit, deny or unknown; hand the decision to audit Process G

The consent path follows consent rules 1, 2 and 4 under process A. An agreement carries odrl:obtainConsent only when consent is its legal basis. The harness’s non-strict mode, which allows unknown and logs it, must not be used on data gated by an agreement.

Combining several agreements (DMN PHW.DT.AgreementAccess)

Several agreements, and several Consents, can be in force for one request at the same time. The owner decided how they combine on 2026-11-01 (decision D, card Q-DRAIN-4, 07:54Z), asked for the rule to be a DMN decision table (07:54Z), and made it a default that can be overridden (07:55Z).

The rule is the OMG DMN 1.5 decision PHW.DT.AgreementAccess in input/dmn/PHW.DT.AgreementAccess.dmn. DMN 1.5 (namespace https://www.omg.org/spec/DMN/20240513/MODEL/) is the version of the WHO SMART DAK decision tables, and the expressions are FEEL. Its usingTask links it to PHW.F.10 and PHW.I.5. Its one input, policyResults, has one row per agreement or Consent evaluated:

Component Type Content
policy string The agreement’s fixed-version URL (its ODRL uid), or the Consent’s URL with Consent.meta.versionId
outcome "permit", "deny", "unknown", "not-applicable" not-applicable when the policy’s target, purpose or assignee does not cover the request; otherwise decide() for this policy alone
conflict "perm", "prohibit", "invalid", or null The policy’s ODRL 2.2 odrl:conflict, or null when it declares none

Two FEEL literal expressions prepare the table: applicableResults = policyResults[item.outcome != "not-applicable"], and conflictStrategy, the strategy in force (override 1 below). The decision table outcome then runs once per request, with hit policy PRIORITY and output values in the order "deny", "unknown", "permit", "not-applicable":

# Any applicable Any deny Any unknown Any permit conflictStrategy outcome Annotation
1 – true – – "prohibit", "invalid" "deny" Prohibition overrides permission. Under invalid, a permit and a deny conflict, so the merged policy is void and nothing is permitted.
2 – true – false "perm" "deny" perm prefers a permission, but none permits.
3 – – true – – "unknown" Unknown is never permit.
4 – – – true – "permit" Wins only when rules 1 to 3 do not match.
5 false – – – – "not-applicable" No agreement applies: normal VHL rules (PHW.I.8).

deny and unknown lead to PHW.I.7 (403), permit to PHW.I.6, and not-applicable to PHW.I.8. Two more expressions, outside the table, give evaluatedPolicies (every policy) and permittingPolicies (the applicable ones that permitted) for the duties and the audit.

Why PRIORITY. The owner’s order (any deny, then any unknown, then any permit, then none applicable) is a ranking of outcomes, and PRIORITY is the DMN hit policy that returns the matching rule whose output comes first in the output’s ordered outputValues. Each rule then states one condition, and the ranking resolves overlaps; for example, a request with a deny and an unknown matches rules 1 and 3, and "deny" wins. Rules with the same output never overlap (rules 1 and 2 differ in conflictStrategy), so the result does not depend on rule order. COLLECT was not used: its aggregators (SUM, MIN, MAX, COUNT) work on numbers, so the outcomes would have to be coded as numbers that no standard defines. FIRST would also work, but it hides the ranking in the rule order. Every combination of up to three policies, with every outcome and strategy, was checked against the owner’s rule, and exactly one outcome results each time.

Why only one table. Each row is decided by decide() for that policy alone (PHW.F.10, with the PCF Consent path of PHW.F.8), and applicability is a check of the ODRL target, purpose and assignee. Neither is a decision table, so there is no per-row DMN table. The DMN decision combines the rows once per request.

Override 1: the policies. ODRL 2.2 lets each policy declare a conflict strategy with odrl:conflict: odrl:perm (permissions override prohibitions), odrl:prohibit (prohibitions override permissions) or odrl:invalid (the policy is void if any conflict is detected). These terms were checked against the ODRL 2.2 vocabulary and the pinned JSON-LD context (folio-assistant-core scripts/test-fixtures/dsa-contexts/odrl-2.2.context.json). When every applicable policy declares the same strategy, the table uses it. A policy that declares none counts as prohibit, the owner’s default D. If the applicable policies declare different strategies, conflictStrategy is invalid. ODRL 2.2 says a policy with several conflict values (after a merge or inheritance) is void when its rules conflict (W3C ODRL Information Model 2.2, Policy Conflict Strategy). This IG treats the applicable policies of one request as merged. The only declaration that changes an outcome is perm declared by every applicable policy. ODRL’s own default when nothing is declared is invalid, but the outcome is the same: with a conflict, invalid voids the policy and prohibit denies, and both are refused.

Override 2: the jurisdiction or Sharer. A jurisdiction or a Sharer MAY replace the decision outcome with its own DMN decision. The replacement is well defined when it has the same contract:

The decision used, default or replacement, is recorded in the ATNA event and the PROV-O record by its DMN namespace and decision id and by its file’s fixed-version URL and SHA-256. That is the same way an agreement is cited, since DMN 1.5 definitions has no version element of its own.

G. Audit, Provenance and Duty Checks under a Data Sharing Agreement

Process G — Audit, Provenance and Duty Checks under a Data Sharing Agreement (DSA P12)
Activity ID Lane / Actor Task Name Standard and section
PHW.G.1 Enforcement and Decision Points Write PROV-O record citing the agreement W3C PROV-O: prov:used = the agreement’s DCAT distribution with spdx:checksum (DCAT 3 §6.8, §6.8.20; bean yy40), plus the grant or token id; prov:wasAssociatedWith; prov:actedOnBehalfOf
PHW.G.3 Enforcement and Decision Points Send ATNA audit event citing the agreement [ITI-20] Record Audit Event [ITI-20] Record Audit Event (IHE ATNA, Final Text; ITI TF-2: 3.20†). Grouping as in VHL Volume 1 §1:XX.3 and §1:XX.6.1
PHW.G.5 Data Recipient (duty performer) Record duty fulfilment with evidence hash ODRL 2.2 duty §2.6.3
PHW.G.6 Enforcement and Decision Points Compare duties with records An unmet duty gives deny, and an unknowable one gives unknown
PHW.G.7 Auditor (person) Periodic human review and report to the provider odrl:inform, or a clause in the PDF

The Provenance Log and the ATNA Audit Record Repository are data stores, not lanes, because they only keep what the audit writers send (smart-trust-phw#22):

Data store Written by What it keeps Standard and section
PHW.G.ProvenanceLog Provenance Log (W3C PROV-O, hash-chained) PHW.G.1 One PROV-O record per decision; each carries the hash of the one before it W3C PROV-O. The hash chain is a local extension (bean B4), not a standard
PHW.G.AuditRecordRepository ATNA Audit Record Repository PHW.G.3 One ATNA audit event per decision [ITI-20] Record Audit Event

Audit. The ATNA event cites the agreement’s fixed-version URL, the requester, the purpose of use, the data or documents released, and the decision. ATNA is reached in the same way the VHL profile reaches it. VHL Volume 1 §1:XX.3, Table XX.3-1, requires the VHL Sharer and VHL Receiver to be grouped with an ATNA Secure Node or Secure Application. §1:XX.6.1 covers the secure channel ([ITI-19]) and audit logging. Those sections are from the IHE/ITI.VHL source at commit 48201473, as snapshotted in litlfred/smart-trust-tools library/. IHE BALP (Basic Audit Log Patterns) is Trial Implementation and needs owner approval before this IG names its AuditEvent patterns. The PROV-O record (PHW.G.1) cites the same agreement URL, so the two logs agree.

H. Revocation and Suspension under a Data Sharing Agreement

Process H — Revocation and Suspension under a Data Sharing Agreement (DSA P13)
Activity ID Lane / Actor Task Name Standard and section
PHW.H.1 Data Provider (decides) Decide what to stop: revoke (final) or suspend (reversible) —
PHW.H.2 Grant Issuer (W3C Bitstring Status List) Set the grant’s bit in the Bitstring Status List W3C Bitstring Status List §2.1. The IETF Token Status List is a draft and is not used
PHW.H.3 Provider Authorization Server Revoke tokens and disable the client RFC 7009 §2†; introspection active: false RFC 7662 §2.2†; the client from process D
PHW.H.4 Trust Anchor (GDHCN or another accepted anchor) Remove key from trust list or revoke certificate (CRL) RFC 5280 §5†; GDHCN key (DSC) deletion
PHW.H.5 Data Provider (decides) Record the revocation or suspension Process G

A withdrawn Consent needs no step in H: the person sets status to inactive (PHW.A.4), and PHW.F.8 then finds no active Consent. A VHL or HCERT QR code cannot be revoked on its own. It expires (exp, claim key 4), and the VHL Sharer can stop serving the link.

The VHL Sharer is the organisation or system that holds the documents. It may already have a data sharing agreement with the organisation or application that receives a VHL. When that receiver resolves the link ([ITI-YY5] Retrieve Manifest, then [ITI-68]), the Sharer decides the request under that agreement. It uses the same decision as process F, audits as process G does, and revokes as process H does. The owner set this case on 2026-10-30 (20:01Z and 20:04Z):

# Process Name Process ID Objectives
I Decide a Verifiable Health Link Request under an Existing Data Sharing Agreement PHW.I Authenticate the VHL Receiver ([ITI-YY5]), find the agreements and Consents in force from its verified identity, decide under every applicable one (process F, DMN PHW.DT.AgreementAccess), and record an IHE ATNA audit event ([ITI-20]) that cites every one evaluated.

Process I — Decide a Verifiable Health Link Request under an Existing Data Sharing Agreement (VHL [ITI-YY5], [ITI-YY2], ATNA [ITI-20])
Activity ID Lane / Actor Task Name IHE VHL / ATNA transaction, standard and section
PHW.I.1 VHL Receiver Send Retrieve Manifest authenticated by the VHL option in use [ITI-YY5] [ITI-YY5], with one of: HTTP Message Signatures, RFC 9421 (ITI-YY5 §2:3.YY5.4.1.3, §2:3.YY5.5.2; Sign Manifest Request Option, Vol 1 §1:XX.2.1); Verifiable Credential Option (ITI-YY5 §2:3.YY5.4.1.5); OAuth with SSRAA Option (ITI-YY5 §2:3.YY5.4.1.4, §2:3.YY5.5.3; HL7 SSRAA §2, §3, §5.2), approved by the owner on 2026-10-30
PHW.I.2 VHL Sharer Authenticate the receiver against the trust list [ITI-YY5] ITI-YY5 §2:3.YY5.4.1.7, step 2; for SSRAA, the checks of ITI-YY5 §2:3.YY5.5.3
PHW.I.3 Trust Anchor (GDHCN or another anchor) Return receiver key [ITI-YY2] Retrieve Trust List with DID [ITI-YY2] (IHE.VHL.TrustAnchor)
PHW.I.4 VHL Sharer Find the agreements and Consents in force; mark which apply Verified identity (keyid, VC issuer DID, or SSRAA client_id and certificate SAN URI, SSRAA §3.1, §3.4) mapped to the fixed-version URLs of every agreement held with this receiver: the same configuration as PHW.D.6 (open point 1). Each is applicable only if its ODRL target, purpose and assignee cover the request; otherwise not-applicable, not a deny. Agreements the receiver names in SSRAA consent_policy (§5.2.1.1), and policies it names in its VC’s termsOfUse (each checked against its Trust Domain’s terms-of-use ValueSet, then matched to Consent.policyRule by system and code), narrow the permissions it acts under, never another agreement’s prohibition. Where Consents carry the policy (Consent.policyRule), they are the policy and no lookup is needed. Decided, owner 2026-11-01 07:54Z
PHW.I.5 VHL Sharer Decide under every applicable agreement (process F) Process F for each applicable agreement or Consent, combined by DMN PHW.DT.AgreementAccess (default odrl:prohibit; overridable). The duties of every permitting agreement apply. Plus VHL’s own checks in ITI-YY5 §2:3.YY5.4.1.7, step 3
PHW.I.6 VHL Sharer Return manifest and documents [ITI-YY5] / [ITI-68] [ITI-YY5] 200 OK; [ITI-68] (MHD Document Responder, Vol 1 §1:XX.3)
PHW.I.7 VHL Sharer Refuse with OperationOutcome [ITI-YY5] (deny or unknown) [ITI-YY5] 403 Forbidden
PHW.I.8 VHL Sharer Apply the normal VHL rules (no agreement applies) Unauthenticated: 401 (ITI-YY5 §2:3.YY5.4.1.7). Verified receiver, no agreement: process C from PHW.C.5
PHW.I.9 VHL Sharer Send ATNA audit event citing the agreement [ITI-20] Record Audit Event Cites every agreement and Consent evaluated, which permitted, and the combining DMN decision used. [ITI-20] (IHE ATNA, Final Text; ITI TF-2: 3.20, cited from standing knowledge); grouping per VHL Vol 1 §1:XX.3, Table XX.3-1, and §1:XX.6.1
PHW.I.11 VHL Receiver Process documents or refusal [ITI-YY5] response [ITI-YY5] consumer (IHE.VHL.VHLReceiver)

PHW.I.9 writes the audit event to the ATNA Audit Record Repository (PHW.I.AuditRecordRepository), a data store as in process G, by [ITI-20].

Which VHL options identify the receiver. VHL 1.0.0-comment names three authentication options for [ITI-YY5]. The table cites the IHE/ITI.VHL source at commit 48201473, as snapshotted in litlfred/smart-trust-tools library/; the published 1.0.0-comment text has not been compared with it.

Option VHL section Identity the Sharer verifies Status
HTTP Message Signatures (RFC 9421) ITI-YY5 §2:3.YY5.4.1.3, §2:3.YY5.5.2; Vol 1 §1:XX.2.1 Sign Manifest Request Option keyid in Signature-Input, resolved in the trust list RFC 9421 is a final IETF standard
Verifiable Credential Option ITI-YY5 §2:3.YY5.4.1.5; Vol 1 §1:XX.2 The DID URL in proof.verificationMethod of a self-issued W3C VC with a DataIntegrityProof W3C VC 2.0 and Data Integrity 1.0
OAuth with SSRAA Option ITI-YY5 §2:3.YY5.4.1.4, §2:3.YY5.5.3 The client_id from SSRAA (UDAP) registration (PHW.D.9, PHW.D.10), the x5c certificate chain of the JWT client assertion, and the certificate’s SAN URI. The hl7-b2b extension (SSRAA §5.2.1.1) adds organization_id and purpose_of_use HL7 SSRAA 2.0.0, the FHIR profile of UDAP. Approved by the owner, 2026-10-30 20:28Z. VHL has no plain-OAuth option. The RFC 9396 route of process E is not a VHL option.

Audit. Once an agreement applies, PHW.I.9 records an IHE ATNA audit event ([ITI-20] Record Audit Event). It cites the fixed-version URL of every agreement and Consent evaluated, which of them permitted, the combining DMN decision used (by namespace, decision id, and its file’s fixed-version URL and SHA-256), the receiver, the purpose of use, and the documents released (or the refusal). This follows the VHL profile’s own ATNA grouping: Vol 1 §1:XX.3 requires the VHL Sharer and the VHL Receiver to be grouped with an ATNA Secure Node or Secure Application for [ITI-YY5], and §1:XX.6.1 gives that grouping its audit logging. VHL itself says the Sharer SHOULD log access (ITI-YY5 §2:3.YY5.5.6) and MAY record the Audit Event – Accessed Health Data (ITI-YY5 §2:3.YY5.4.1.7). Under an agreement, the event is always recorded. IHE BALP needs owner approval (Trial Implementation). The PROV-O record of process G (PHW.G.1) cites the same agreement URLs and DMN decision, so the ATNA log and the PROV log agree.

Open points (owner):

  1. The lookup has no standard element. No existing VHL, OAuth or VC element maps a verified receiver to an agreement. The mapping is the Sharer’s own configuration, keyed by the agreement’s fixed-version URL, the same configuration as PHW.D.6. No field is invented.
  2. Several agreements with one receiver. Decided (owner, 2026-11-01 07:54Z, card Q-DRAIN-4, option D; 07:55Z, overridable default). Every agreement and Consent held with the receiver is evaluated, and one that does not cover the request is not applicable. The results are combined by the DMN decision PHW.DT.AgreementAccess: by default permit if at least one applicable policy permits and none prohibits (ODRL 2.2 odrl:prohibit). Policies may declare another odrl:conflict, and a deployer may replace the decision under the same contract. The duties of every permitting agreement apply, and the audit cites every agreement evaluated.
  3. Purpose of use in the audit event. With the SSRAA option, the purpose can come from the token request: purpose_of_use, a required array of codes in the hl7-b2b extension of the receiver’s JWT client assertion (SSRAA §5.2.1.1; HL7 v3 PurposeOfUse is encouraged, §5.2.1.2). SSRAA does not constrain the access token’s format (§5.2.3), so the Sharer has the purpose directly when its own authorization server issued the token; how a separate authorization server would pass it on is not specified. Without SSRAA, [ITI-YY5] carries no purpose, and it comes from the agreement or from the PCF Consent recorded at [ITI-YY3] (Consent.provision.purpose). Which source the event records, and which one wins when they differ, is open.
  4. Possible ballot comments. The VHL Verifiable Credential Option example uses issuanceDate and expirationDate, which are VC 1.1 terms. VC 2.0 uses validFrom and validUntil. In the OAuth with SSRAA Option example (ITI-YY5 §2:3.YY5.4.1.4), the decoded client assertion gives purpose_of_use as a single string, where SSRAA §5.2.1.1 requires an array, and the token request omits the udap=1 parameter that SSRAA §5.2.2.2 requires. VHL says its workflow is informative and SSRAA takes precedence.
  5. consent_policy in hl7-b2b. Decided (owner, 2026-11-01 07:54Z, card Q-DRAIN-4, option D). SSRAA §5.2.1.1 lets a client name policy URIs in consent_policy, an optional array, and FHIR Consent URLs in consent_reference. A receiver MAY list one or more agreements’ fixed-version URLs in consent_policy. This narrows the permissions it acts under (PHW.I.4) but never escapes another applicable agreement’s prohibition. Naming is optional, so the HTTP Message Signatures and Verifiable Credential options, which have no such field, still work. Nothing is added to any standard.

Shared Certificate Processes

These two processes are shared blocks for any certificate type (BPMN reuse proposal, Q-BPMN-1 A). A trust domain or another IG calls them instead of copying their steps. Their steps come from the smart-icvp issuing and verifying diagrams.

# Process Name Process ID Objectives
J Issue a Verifiable Digital Health Certificate PHW.J Ask the holder for consent, collect what the certificate profile (a data input) needs, issue and sign the certificate, issue its VHL (process B), and deliver it to the wallet.
K Verify a Certificate and its Status PHW.K Receive the claim; redeem a VHL through process C, check by hand, or decode the QR code, get the issuer key from the Trust Anchor ([ITI-YY2]), verify the signature, and check the registry.

J. Issue a Verifiable Digital Health Certificate

Process J — Issue a Verifiable Digital Health Certificate (calls process B)
Activity ID Lane / Actor Task Name Source
PHW.J.1 Certificate Issuer (health worker or issuing system) J1. Inform the holder and ask for consent to issue smart-icvp: ‘Inform traveller and request consent to digitize’ and ‘Counsel patient on consent’. This is consent to issue the certificate. Consent to share it later is recorded by process A and checked by process B.
PHW.J.2 Certificate Issuer (health worker or issuing system) J2. Collect the data the certificate profile needs smart-icvp: ‘Capture Vaccination Data’, ‘Collate ICVP data’, ‘Conduct data entry from physical card into system’. What is collected is set by the certificate profile input.
PHW.J.2a Certificate Issuance Service J2a. Add the consent directives to the certificate (process M, optional) Optional (owner, 2026-11-07): before the certificate is signed, process M adds the consent directives it is issued under, explicit (PHWExplicitConsent, recorded by process L) or implied (PHWImpliedConsent, the trust domain’s default policy), as consent entries listed in the Advance Directives section. The copy in the certificate is evidence for a receiver; the Consent Registry copy is the one enforced.
PHW.J.3 Certificate Issuance Service J3. Issue and sign the certificate smart-icvp: ‘Issue Digital ICVP Card’. Signed with the issuer’s key registered with the trust anchor.
PHW.J.4 Certificate Issuance Service J4. Issue a consent-backed VHL (process B) smart-icvp: ‘Configure VHL’. Reuses process B: consent check [ITI-108] and Generate VHL [ITI-YY3].
PHW.J.5 Certificate Issuance Service J5. Generate the QR code smart-icvp: ‘Generate QR Code’.
PHW.J.6 Certificate Holder (person / Personal Health Wallet) J6. Receive the certificate in the wallet smart-icvp: ‘Receive Digital ICVP Card’, ‘Digital ICVP Card issued and available for use’.

K. Verify a Certificate and its Status

Process K — Verify a Certificate and its Status ([ITI-YY2]; calls process C)
Activity ID Lane / Actor Task Name Source
PHW.K.1 Verifier (with or without a status checking application) K1. Receive the claim smart-icvp: ‘Receive claim of vaccination status’.
PHW.K.VHL Certificate Holder (person / Personal Health Wallet) K2. Present and redeem the VHL (process C) Reuses process C: [ITI-YY4], [ITI-YY2], [ITI-YY5] with consent enforcement.
PHW.K.Manual Verifier (with or without a status checking application) K3. Check by hand and decide the claim smart-icvp: ‘Perform Manual Check and decide the status of the claim’. Done by the Verifier when no checking application is used.
PHW.K.4 Verifier (with or without a status checking application) K4. Decode the QR code and find the key id smart-icvp: ‘Deserialize the QR Code and identify the Key Id’.
PHW.K.5 Trust Anchor (GDHCN or another accepted anchor) K5. Return the issuer’s public key [ITI-YY2] smart-icvp: ‘Retrieve public key from WHO GDHCN’. [ITI-YY2] Retrieve Trust List with DID.
PHW.K.6 Verifier (with or without a status checking application) K6. Verify the signature and the claim smart-icvp: ‘Verify QR code signature’ and ‘Verify Certificate claim’.
PHW.K.7 Issuing Public Health Authority (certificate registry) K7. Find the certificate in the registry and return it smart-icvp: ‘Identify Certificate in Certificate Registry’, ‘Retrieve Certificate from Certificate Repository’, ‘Return Certificate’.
PHW.K.8 Verifier (with or without a status checking application) K8. Communicate the result smart-icvp: ‘Communicate Result back to Verifier’.

Explicit and implied consent are described on the Consent page. Process L records an explicit consent. Process M adds the consent directives, explicit or implied, to a document when it is shared (process B, step B5a) or issued (process J, step J2a). Adding them is optional.

# Process Name Process ID Objectives
L Record Explicit Consent PHW.L Show the trust domain’s consent text (code and version); when the holder agrees, record the act as evidence and post a PHWExplicitConsent with [ITI-108]; when the holder does not, the trust domain’s default policy applies (implied consent).
M Add Consent Directives to a Shared or Issued Document PHW.M Optionally, before signing: find the active explicit Consents ([ITI-108]), or else the trust domain’s default as a PHWImpliedConsent; add them as consent entries and list them in the Advance Directives section.

Process L — Record Explicit Consent ([ITI-108])
Activity ID Lane / Actor Task Name Description
PHW.L.1 PCF Consent Recorder (wallet or health worker) L1. Show the trust domain’s consent text (code and version) The text is the definition of the consent code in the trust domain’s terms-of-use code system, at the version shown, in the holder’s language. For Hajj: IPS.HAJJ.CONSENT, for example CONSENT-MYS at 2.1.0.
PHW.L.2 Holder (person / Personal Health Wallet) L2. Read the text and decide The holder decides who may see what, for what purpose and for how long (provision.actor, provision.purpose, provision.period).
PHW.L.3 PCF Consent Recorder (wallet or health worker) L3. Record the holder’s act as evidence The wallet confirmation or the signed form (a DocumentReference or QuestionnaireResponse): the Consent’s source[x].
PHW.L.4 PCF Consent Recorder (wallet or health worker) L4. Post the explicit Consent [ITI-108] Access Consent A PHWExplicitConsent: policyRule = the trust domain’s consent code with the version shown; source = the evidence of L3; status active.
PHW.L.5 PCF Consent Registry L5. Store the Consent; return Consent.id and versionId [ITI-108] The registry copy is the one enforced (processes C, F, I).
PHW.L.6 Holder (person / Personal Health Wallet) L6. Keep a copy in the wallet So the holder can read back what they agreed to and withdraw it (process A, Delete or Put).

Process M — Add Consent Directives to a Shared or Issued Document ([ITI-108])
Activity ID Lane / Actor Task Name Description
PHW.M.1 Document source (VHL Sharer or Certificate Issuance Service) M1. Search active Consents for the holder [ITI-108] Access Consent Explicit consents for this trust domain: policyRule in the domain’s terms-of-use ValueSet.
PHW.M.2 PCF Consent Registry M2. Return the active Consents [ITI-108] With Consent.id and meta.versionId.
PHW.M.3 Document source (VHL Sharer or Certificate Issuance Service) M3. Add the explicit Consents, or the trust domain’s default as an implied Consent PHWExplicitConsent for each active explicit consent; when there is none, a PHWImpliedConsent naming the trust domain’s default policy (normally an IHE PCF implicit policy) with the domain’s published policy as source.
PHW.M.4 Document source (VHL Sharer or Certificate Issuance Service) M4. List them in the Advance Directives section Composition.section (LOINC 42348-3) entries reference each consent entry, with a human-readable summary in the section text.

Shared Processes and Their Addresses

Another IG calls a process here with a BPMN call activity: it imports this IG’s namespace with bpmn:import (namespace="http://smart.who.int/trust-phw/bpmn") and sets calledElement to the process id, prefixed with the import’s namespace prefix (Q-BPMN-2 A).

Shared block What it does Process ID
B3 Record and manage consent PHW.A
B4 Issue a certificate PHW.J
B5 Issue a consent-backed VHL PHW.B
B6 Present and redeem a VHL PHW.C
B7 Verify a certificate and its status PHW.K
B8 Decide access under an agreement PHW.F, PHW.I
B9 Audit and provenance PHW.G
B10 Revoke or suspend PHW.H
B11 Record explicit consent PHW.L
B12 Add consent directives to a document PHW.M

For a worked example of processes A, B, C, F and I in one case, see Worked Example: IPS Pilgrimage (Hajj).

Edit this page on GitHub