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 část odpovídá transakci [ITI-66] technického rámce IHE. Transakce [ITI-66] je používána aktéry Document Consumer a Document Responder. Tato transakce se používá k vyhledání a vrácení metadat pro dříve uložené sady nebo složky odeslaných dokumentů.
Transakce Find Document Lists [ITI-66] se používá k vyhledání seznamů zdrojů, které splňují sadu parametrů. Je ekvivalentní:
Výsledkem dotazu je balíček obsahující seznam zdrojů, které odpovídají parametrům dotazu.
Tabulka 1: Role aktérů
| Aktér | Role |
|---|---|
| Spotřebitel dokumentů | Žádá o seznam zdrojů, které odpovídají zadaným kritériím, od respondenta dokumentů |
| Odesílatel dokumentů | Vrací seznam zdrojů, které odpovídají vyhledávacím kritériím poskytnutým spotřebitelem dokumentů |
FHIR-R4 HL7 FHIR Release 4.0
Obrázek 1: Interakce vyhledávání seznamů dokumentů
Odpověď MUSÍ odpovídat struktuře CZ MHD Najít odkazy na dokumenty Komplexní odpověď.
Pokud odesílatel neodpoví, MUSÍ být k agregovaným výsledkům přidána operace OperationOutcome s varováním o závažnosti, které označuje, že komunita neodpovídá.
U shodných odkazů na dokumenty vrácených odesílatelem MUSÍ odesílatel zajistit přepsáním identifikátoru a adresy attachment.url, že následné čtení, aktualizace nebo načtení dokumentů bude zpracováno stejným aktérem dokumentového respondenta. Jakékoli přepsání identifikátoru nebo adresy URL MUSÍ být řešitelné po dobu alespoň jedné hodiny.
Zdrojem CapabilityStatement pro Spotřebitele seznamů dokumentů je Spotřebitel seznamů dokumentů MHD.
Zdrojem CapabilityStatement pro Odpovídajícího na seznamy dokumentů je Odpovídající na seznamy dokumentů MHD.
Zabezpečení transakce vychází ze Standardu akreditovaných afinitních domén (AAfD). Transportní vrstva (mTLS) a aplikační vrstva (přístupový token IUA) se používají vždy současně, nejde o alternativy.
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 a každá strana ověřuje platnost certifikátu protistrany. mTLS se používá pro veškerou komunikaci: mezi IS PZS a AAfD, mezi AAfD navzájem i mezi AAfD a centrálními službami elektronického zdravotnictví.
Klient MUSÍ v každém požadavku předat přístupový token dle profilu IHE IUA ve formátu JSON Web Token (JWT):
Authorization: Bearer dle transakce Incorporate Access Token [ITI-72].Předává-li domovská AAfD požadavek do jiné AAfD, získá pro cílovou AAfD nový přístupový token mechanismem OAuth 2.0 Token Exchange dle RFC 8693: subject_token je přístupový token PZS, actor_token je systémový token volající AAfD. Cílová AAfD ověří v Katalogu služeb, že volající AAfD je akreditovaná, a vydá token, který obsahuje identitu PZS (sub) a identitu zprostředkující AAfD (act). Přímé předávání tokenu PZS do jiné AAfD bez validace není dovoleno.
Aktéři MUSÍ podporovat zpracování hlavičky traceparent dle W3C Trace Context.
Aktéři MUSÍ zaznamenat auditní událost a odeslat ji transakcí Record Audit Event [ITI-20]:
Auditní událost MUSÍ zachytit identitu uzlů z mTLS a údaje z přístupového tokenu IUA podle pravidel v kapitole Zaznamenání zabezpečení komunikace. AAfD zaznamená dotaz a jeho výsledek (PZS, ZP, RID nebo DRID, parametry dotazu).