Verifiable Health Links
1.0.0-comment - ballot
Verifiable Health Links, published by IHE IT Infrastructure Technical Committee. This guide is not an authorized publication; it is the continuous build for version 1.0.0-comment built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/ITI.VHL/ and changes regularly. See the Directory of published versions
| Active as of 2026-11-13 |
{
"resourceType" : "Requirements",
"id" : "RequestVHLDocument",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: Requirements RequestVHLDocument</b></p><a name=\"RequestVHLDocument\"> </a><a name=\"hcRequestVHLDocument\"> </a><p>These requirements apply to the actor <a href=\"ActorDefinition-VHLReceiver.html\">VHL Receiver</a></p><table class=\"grid\"><tr><td><b><a name=\"retrieve-health-document\"> </a></b>Retrieve an individual document</td><td>SHALL</td><td><div><p>Retrieve an individual health document referenced by a previously obtained manifest, using <a href=\"https://profiles.ihe.net/ITI/MHD/ITI-68.html\">MHD ITI-68 Retrieve Document</a></p>\n</div></td></tr><tr><td><b><a name=\"decrypt-document\"> </a></b>Decrypt the document</td><td>SHALL</td><td><div><p>Decrypt the retrieved binary using the symmetric key carried in the <code>key</code> field of the VHL payload</p>\n</div></td></tr><tr><td><b><a name=\"verify-digital-signature\"> </a></b>Verify digital signature</td><td>MAY</td><td><div><p>Verify the digital signature of the returned health document to confirm its authenticity, integrity, and provenance, as defined in the <a href=\"Requirements-VerifyDocumentSignature.html\">Verify Document Signature</a> requirement</p>\n</div></td></tr><tr><td><b><a name=\"record-audit-event\"> </a></b>Record audit event</td><td>MAY</td><td><div><p>Record an audit event documenting the access request by the Receiver, in accordance with the <a href=\"Requirements-AuditEventReceived.html\">Audit Event – Received Health Data</a> requirement</p>\n</div></td></tr></table></div>"
},
"url" : "https://profiles.ihe.net/ITI/VHL/Requirements/RequestVHLDocument",
"version" : "1.0.0-comment",
"name" : "RequestVHLDocument",
"title" : "Request VHL Document",
"status" : "active",
"date" : "2026-11-13T03:15:18+00:00",
"publisher" : "IHE IT Infrastructure Technical Committee",
"contact" : [
{
"telecom" : [
{
"system" : "url",
"value" : "https://www.ihe.net/ihe_domains/it_infrastructure/"
}
]
},
{
"telecom" : [
{
"system" : "email",
"value" : "iti@ihe.net"
}
]
},
{
"name" : "IHE IT Infrastructure Technical Committee",
"telecom" : [
{
"system" : "email",
"value" : "iti@ihe.net"
}
]
}
],
"description" : "Having obtained a manifest through [Retrieve Manifest [ITI-YY5]](ITI-YY5.html), the [VHL Receiver](ActorDefinition-VHLReceiver.html) SHALL retrieve each health document it needs from the location that manifest gives for it, using [MHD ITI-68 Retrieve Document](https://profiles.ihe.net/ITI/MHD/ITI-68.html).\n\nDocument binaries are encrypted. The Receiver decrypts each one using the symmetric key carried in the `key` field of the VHL payload.\n\n**Optional behaviors:**\n* The VHL Receiver MAY verify the digital signature of the returned health document to confirm its authenticity, integrity, and provenance, as defined in the [Verify Document Signature](Requirements-VerifyDocumentSignature.html) requirement.\n* The VHL Sharer MAY record an audit event documenting the access request by the Receiver, in accordance with the [Audit Event – Received Health Data](Requirements-AuditEventReceived.html) requirement.",
"jurisdiction" : [
{
"coding" : [
{
"system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
"code" : "001"
}
]
}
],
"statement" : [
{
"key" : "retrieve-health-document",
"label" : "Retrieve an individual document",
"conformance" : [
"SHALL"
],
"requirement" : "Retrieve an individual health document referenced by a previously obtained manifest, using [MHD ITI-68 Retrieve Document](https://profiles.ihe.net/ITI/MHD/ITI-68.html)"
},
{
"key" : "decrypt-document",
"label" : "Decrypt the document",
"conformance" : [
"SHALL"
],
"requirement" : "Decrypt the retrieved binary using the symmetric key carried in the `key` field of the VHL payload"
},
{
"key" : "verify-digital-signature",
"label" : "Verify digital signature",
"conformance" : [
"MAY"
],
"requirement" : "Verify the digital signature of the returned health document to confirm its authenticity, integrity, and provenance, as defined in the [Verify Document Signature](Requirements-VerifyDocumentSignature.html) requirement"
},
{
"key" : "record-audit-event",
"label" : "Record audit event",
"conformance" : [
"MAY"
],
"requirement" : "Record an audit event documenting the access request by the Receiver, in accordance with the [Audit Event – Received Health Data](Requirements-AuditEventReceived.html) requirement"
}
]
}