HL7 Czech Health information exchange Implementation Guide
0.0.1 - ci-build
HL7 Czech Health information exchange Implementation Guide
0.0.1 - ci-build
HL7 Czech Health information exchange Implementation Guide, published by HL7 Czech Republic. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7-cz/HIE/ and changes regularly. See the Directory of published versions
Tato kapitola popisuje české národní rozšíření (pro akreditované afinitní domény – AAfD) pro transakci „Send Audit Resource Request Message – RESTful interaction ITI-20“, definovanou v profilu RESTful ATNA (doplňek „Add RESTful ATNA (Query and Feed)“ v režimu IHE Trial Implementation). Úložiště auditních záznamů (Audit Record Repository) MUSÍ podporovat volbu ATX: FHIR Feed Option.
Aktor: libovolný aktor či aplikace seskupená se Secure Node nebo Secure Application (Audit Creator).
Role: vytvoří auditní záznam a odešle jej do Úložiště auditních záznamů (Audit Record Repository).
Aktor: Audit Record Repository.
Role: přijme auditní záznam od Audit Record Creator a uloží jej pro potřeby auditu.
„Send Audit Resource Request Message – FHIR Feed Interaction“ se používá pro auditování zdroje FHIR AuditEvent prostřednictvím RESTful protokolu.
Interakční diagram pro [ITI‑20]:
Tato zpráva se odesílá, když aktor seskupený se Secure Node nebo Secure Application, případně Audit Record Forwarder, potřebuje odeslat jednu nebo více AuditEvent resource do Úložiště auditních záznamů.
Auditní události transakcí MHD MUSÍ odpovídat těmto profilům:
| Transakce | Aktor | Profil |
|---|---|---|
| Provide Document Bundle [ITI-65] | Document Source | CZ Audit Event for [ITI-65] Document Source |
| Provide Document Bundle [ITI-65] | Document Recipient | CZ Audit Event for [ITI-65] Document Recipient |
| Find Document Lists [ITI-66] | Document Consumer | CZ Audit Event for [ITI-66] Document List Consumer |
| Find Document Lists [ITI-66] | Document Responder | CZ Audit Event for [ITI-66] Document List |
| Find Document References [ITI-67] | Document Consumer | CZ Audit Event for [ITI-67] Document Consumer |
| Find Document References [ITI-67] | Document Responder | CZ Audit Event for [ITI-67] Document Responder |
| Retrieve Document [ITI-68] | Document Consumer | CZ Audit Event for [ITI-68] Document Consumer |
| Retrieve Document [ITI-68] | Document Responder | CZ Audit Event for [ITI-68] Document Responder |
Obsah auditních událostí, které AAfD zpřístupňuje Žurnálu činností, popisuje Volume 3.
Každá auditní událost MUSÍ zachytit, kdo se při komunikaci prokázal certifikátem (mTLS) a přístupovým tokenem (IUA):
| Údaj | Zdroj | Element AuditEvent |
|---|---|---|
| Volající systém (uzel) | Klientský certifikát mTLS [ITI-19] | Agent volajícího systému (Document Source / Document Consumer): who.identifier – identita z certifikátu (u AAfD její HCID), network.address – IP adresa nebo hostname |
| Volaný systém (uzel) | Serverový certifikát mTLS [ITI-19] | Agent volaného systému (Document Recipient / Document Responder): who.identifier, network.address |
| Poskytovatel zdravotních služeb (PZS) | Identifikace PZS v přístupovém tokenu IUA | agent[pzs].who.identifier – IČO PZS (https://ncez.mzcr.cz/fhir/sid/ico) |
| Identifikátor přístupového tokenu | Claim jti tokenu IUA |
agent[pzs].policy ve tvaru urn:ietf:params:oauth:jti:<jti> (dle IHE BALP) |
| Zdravotnický pracovník | Identifikace ZP předaná IS PZS (KRZP) | agent[mainUser].altId, agent[mainUser].name |
| Účel použití | Kontext volání | agent[mainUser].purposeOfUse |
| Zprostředkující AAfD (komunikace mezi AAfD) | Claim act tokenu získaného výměnou dle RFC 8693 a certifikát mTLS |
Agent volajícího systému: who.identifier – HCID volající AAfD |
| Pacient | RID nebo DRID | entity[patient].what.identifier |
| Korelace transakce | Hlavička traceparent |
entity[traceparent] |
Přístupový token ani jeho část se do auditní události neukládá, zaznamenává se pouze jeho identifikátor (jti).
Pokud server odmítne spojení nebo požadavek, MUSÍ zaznamenat auditní událost s výsledkem (outcome) jiným než 0 (úspěch):
type = DCM#110113 "Security Alert", subtype = DCM#110126 "Node Authentication",type = DCM#110114 "User Authentication", subtype = DCM#110122 "Login".Tyto události slouží k vyhodnocení bezpečnostních událostí (např. opakované přístupy s neplatnými nebo kompromitovanými tokeny).
Platí stejné sémantiky zpráv a očekávané akce, jak jsou popsány v transakci ITI‑20.
Úložiště auditních záznamů AAfD uloží auditní událost do svého auditního logu a zároveň ji předá do centrální komponenty ATNA elektronického zdravotnictví (AAfD v roli Audit Record Forwarder). Účastníci AAfD (IS PZS) mohou své auditní události odesílat do úložiště auditních záznamů své AAfD touto transakcí.
CapabilityStatement pro Audit Creator: ATNA Audit Creator. CapabilityStatement pro Audit Record Repository: ATNA Audit Record Repository.
Transakce MUSÍ být zabezpečena protokolem TLS 1.3 (minimálně TLS 1.2 se silnými šifrovacími sadami) se vzájemnou autentizací uzlů (mTLS) dle transakce ATNA Authenticate Node [ITI-19]. Klient i server se prokazují certifikátem X.509 vydaným certifikační autoritou MZČR.
Odesílá-li auditní událost IS PZS do úložiště auditních záznamů AAfD, MUSÍ současně předat přístupový token IUA získaný transakcí Get Access Token [ITI-71] v hlavičce Authorization: Bearer dle transakce Incorporate Access Token [ITI-72]. Úložiště auditních záznamů (IUA Resource Server) token validuje stejně jako u transakcí MHD (viz Bezpečnostní hlediska ITI-65).
Předávání auditních událostí z AAfD do centrální komponenty ATNA probíhá přes mTLS se systémovým přístupovým tokenem AAfD.