Kanta JSON Web Token (JWT) FHIR-rajapinnassa

Kanta-palvelujen FHIR toteutuksissa HL7 V3 Medical Records (MR)-sanomataso tulee korvautumaan REST-rajapinnan http headeriin vietävillä tiedoilla. MR-sanomatasolla tarkoitetaan alla olevassa kuvassa esitettyjä siirtokehystä, kontrollikehystä ja sanomatyyppiä. Kuvassa näkyviä CDA R2 asiakirjan rakenteiden esittämistä FHIR-resursseilla ei käsitellä tässä määrittelyssä.

MR-FHIR

Pääsynhallintaan ja lokitukseen tarvittavat tiedot, joiden osalta halutaan varmistaa oikeellisuus ja muuttumattomuus, viedään JWT:hen (RFC 7519: JSON Web Token). Kanta JWT:tä käytetään Potilastiedon arkiston (PTA) ja Sosiaalihuollon asiakastiedon arkiston (SHA) uusissa FHIR rajapinnoissa. Jatkossa Kanta JWT:n käyttö laajenee muihin rajapintoihin kuten Reseptin lääkityslista FHIR rajapintaan. Omatietovarannossa (OTV) Kanta JWT:tä käytetään OAuthin assertiona OTV:n tietojen ammattilaiskäyttörajapinnassa.

JWT:hen sisältyvien tietojen lisäksi MR-sanomatasolla aiemmin siirrettyjä tietoja sijoittuu myös muihin http header-kenttiin, nämä kentät ovat kuvattu tämän oppaan sivulla Kanta HTTP header-tiedot FHIR-rajapinnassa.

Määrittely saatavilla tällä hetkellä PDF-muodossa kanta.fi sivustolla: