9:30 - 12:00 Kontekstinhallinta

1. 9:30 - 12:00 Kontekstinhallinta • Minimikontekstinhallinnan määrittely, versio 3 (alustus Mika Tuomainen, KuY) • Alueellisen kontekstinhallinnan käyttö (alustus Tommi Rissanen, Mediconsult) • Keskustelu • Jatkotoimenpiteet: kontekstinhallinta versio 3 lausuntokierroksen käynnistys • Taustamateriaali osoitteessa: www.centek.fi/serapi/mater/HL7cssig/ SerAPI

2. Minimikontekstinhallinnan määrittely, versio 3 Common Services SIG 12.12.2005 Mika Tuomainen, Kuopion yliopisto

3. Sisältö • Pohjadokumentit • Minimikontekstinhallinnan määrittely, versio 3 - lisäykset ja täydennykset • Yleisesti • CreateSession-metodi • Sessioavain • Tietoturva • Muita tarkennuksia • Alueellinen kontekstinhallinta • Avoimet kysymykset SerAPI

4. Minimikontekstinhallinnan määrittely, versio 3 • olemassa olevien väliversio 2.1.1 ja tietoturvallisen soveltamisohjeen yhdistäminen Minimikontekstinhallinnan määrittely - organisaation sisäiseen käyttöön, väliversio 2.1.1 Minimikontekstinhallinnan määrittely, v3 + = Tietoturvallinen kontekstinhallinta -soveltamisohje, v1 SerAPI

5. Väliversion 2.1.1 jatkokehitysehdotukset • Tietoturva -> esitetty tietoturvaratkaisu, jonka pohjana Tietoturvallinen kontekstinhallinta - soveltamisohje • Työaseman identifioiminen myös sessioavaimen avulla -> lisätty uusi CreateSession -metodi, jolla voi pyytää koordinaattoria luomaan session ja palauttamaan sessioavaimen SerAPI

6. Väliversion 2.1.1 jatkokehitysehdotukset • Alueellisen käytön tarpeiden huomioiminen -> alueellisesta käytöstä oma luku, joka pohjautuu Tietoturvallinen kontekstinhallinta - soveltamisohjeeseen • Pollaukset ja aikakatkaisu -> ehdotettu esimerkki, kuinka voidaan toteuttaa nykyisten rajapintojen avulla SerAPI

7. Tietoturvallinen kontekstinhallinta -soveltamisohjeen jatkokehitysehdotukset • Sessioavaimen luominen koordinaattorissa -> CreateSession-metodi • Käyttäjätunnuksen yksilöllisyys alueellisessa käytössä -> huomioitu alueellinen kontekstinhallinta luvussa SerAPI

8. Sisältö • Pohjadokumentit • Minimikontekstinhallinnan määrittely, versio 3 - lisäykset ja täydennykset • Yleisesti • CreateSession-metodi • Sessioavain • Tietoturva • Muita tarkennuksia • Alueellinen kontekstinhallinta • Avoimet kysymykset SerAPI

9. Minimikontekstinhallinnan määrittely, versio 3 - lisäykset • Lisätty luku työpöytäintegraatiosta johdannoksi. • Lisätty CreateSession-metodi ContextManager-rajapintaan ja päivitetty sen seurauksena vaikutukset dokumentin muihin kohtiin. • Lisätty erillinen tietoturvaluku. • Lisätty erillinen luku alueellisesta kontekstinhallinnasta. SerAPI

10. Minimikontekstinhallinnan määrittely, versio 3 - täydennykset • Aiemmin ollut yleisluku kontekstinhallinnan toiminnoista rajapintojen tekniikkariippumattoman kuvauksen yhteyteen. • Käyttäjäsubjekti • suositus, ettei subjektin arvoissa käytetä erikoismerkkejä • lisätty tarkennusta, ettei koordinaattori vastaa käyttäjätunnusten vastaavuustaulukoinnista • Potilassubjekti • suositus, ettei subjektin arvoissa käytetä erikoismerkkejä • Termi Context manager on korvattu läpi dokumentin termillä koordinaattori. SerAPI

11. Minimikontekstinhallinnan määrittely, versio 3 - täydennykset • SetItemValues-metodi • kontekstitiedoille voidaan määritellä erilaisia sovelluskohtaisia asetusoikeuksia toteutuskohtaisesti. • GetItemValues-metodi • kontekstitiedoille voidaan määritellä erilaisia sovelluskohtaisia hakuoikeuksia toteutuskohtaisesti. • Rajapintojen eri virhetilanteita kuvattu metodien tarkemmin GeneralFailure kohtiin. • Poistettu sessionhallinta-luku http-teknisistä määrityksistä ja liitetty se omaan sessionhallintalukuun. • Kuvattu ratkaisua pollaukseen yleisellä tasolla. SerAPI

12. CreateSession-metodi: session ja sessioavaimen luominen • inputs • optional string applicationName, • optional string hostAddress • outputs • string sessionKey • raises • GeneralFailure, • NotImplemented SerAPI

13. CreateSession-metodi: session ja sessioavaimen luominen • CreateSession-metodin avulla sovellus voi pyytää kontekstinhallintapalvelulta sessioavaimen. • Kontekstin luominen ja yksilöinti perustuu tällöin tähän sessioavaimeen. • Koordinaattori luo kontekstin tällöin jo kun sovellus kutsuu metodia, ei vasta kun ensimmäinen sovellus liittyy kontekstinhallintaan. • Metodin käyttö ei ole pakollista • sessioavaimen voi luoda myös ensimmäinen kontekstiin liittyvä sovellus (esimerkiksi perusjärjestelmä) tai se voidaan luoda jossain muualla kuin koordinaattorissa. • Jos sessioavain luodaan muualla kuin koordinaattorissa, on varmistuttava avaimen yksilöllisyydestä SerAPI

14. Sessioavain • Sessioavainta tarvitaan työasemakohtaisen kontekstisession tunnistamiseen, jos työaseman ip-osoitetta ei voida käyttää työasemaa yksilöivänä tunnisteena. • Sessioavaimen avulla voidaan toteuttaa tarvittaessa myös useita kontekstisessioita samalta työasemalta. • Sessioavain välitetään kontekstipalvelimelle JoinCommonContext-metodissa sovelluksen liittyessä kontekstiin. • Sessioavaimen on oltava vaikeasti arvattava ja yksilöitävä tiettyä kontekstia. SerAPI

15. Sessioavaimen välittäminen • Minimikontekstinhallinnan määrittelyssä ei oteta kantaa, kuinka sessioavain saadaan välitettyä eri sovelluksille, jotka haluavat liittyä tiettyyn tietyllä sessioavaimella yksilöityyn kontekstisessioon • (Alueellisen kontekstinhallinnan yhteydessä sessioavaimen välittäminen web-sovellukselle) • Sessioavaimen välittäminen on ratkaistava toteutuskohtaisesti. • Sessioavaimen välittäminen sitä tarvitseville muille sovelluksille voi olla esim. perusjärjestelmän vastuulla SerAPI

16. Tarkennukset kontekstiin liittymiseen • JoinCommonContext-metodilla voi liittyä kontekstiin nyt seuraavilla parametreilla (applicationName aina pakollinen): • hostAddress: kontekstisession yksilöinti perustuu työaseman ip-osoitteeseen. • sessionKey: kontekstisession yksilöinti perustuu sessioavaimeen. • molemmat parametrit: sovellusten liittyminen kontekstiin voidaan sallia molempien parametrien avulla. On huomioitava, että tämä lähestymistapa ei käy, jos samalta työasemalta on tarve käynnistää useita sessioita * • ilman parametreja, jolloin kontekstisessio yksilöidään sovelluksen palvelukutsusta saatavan työaseman ip-osoitteen perusteella. SerAPI

17. * Molempien parametrien käyttäminen • Ei käy, jos samalta työasemalta on tarve käynnistää useita sessioita. • Tällöin on riski, että koordinaattori menee sekaisin, mihin sessioavaimella yksilöitävään kontekstisessioon sovellus pitäisi liittää -> hyödynnettäessä mahdollisuutta luoda useita sessioita samalta työasemalta, on aina käytettävä sessioavainta. • ip-osoite • sessioavain • ip-osoite • sessioavain1 • sessioavain2 • sessioavain3 SerAPI

18. Tietoturvaratkaisu • Ratkaistaan kontekstipalvelun ja siihen liittyvien sovellusten välistä tietoturvaa. • Tietoturvaratkaisua voidaan käyttää niin organisaation sisäiseen kontekstinhallintaan kuin tilanteeseen, jossa kontekstinhallintaan on tarve liittyä organisaation ulkopuolelta. • Myös mahdollisen alueellisti keskitetyn kontekstipalvelun ja siihen liittyvien järjestelmien välinen tietoturva voidaan toteuttaa tällä ratkaisulla. SerAPI

19. Tietoturva - kaksisuuntainen SSL • Kontekstinhallinnan minimitoteutuksessa toteutettava tietoturva varmistetaan käyttämällä kaksisuuntaista SSL-protokollaa http-protokollan alla. • SSL-tekniikalla kontekstipalvelun ja siihen liittyvät järjestelmät voivat varmistaa ja toteuttaa • osapuolten identiteetit • tiedon eheyden • liikenteen salauksen • Kontekstipalvelimen ja siihen liittyvien järjestelmien välinen http-liikenne on näin suojattua. SerAPI

20. SerAPI

21. Tietoturva - kaksisuuntainen SSL • SSL:ssä käytettävät varmenteet ovat tässä ratkaisussa sovelluskohtaisia varmenteita. • Ne siis yksilöivät tietyn sovelluksen. • Ne eivät yksilöi käyttäjää eivätkä työasemaa. • Organisaation sisäisen kontekstinhallinnan tietoturvan yhdenmukaisessa ratkaisemisessa on ongelmana kahdenlaisten sovelluksien olemassaolo • työasemasovelluksia • web-sovelluksia. SerAPI

22. Tietoturva - kaksisuuntainen SSL • Web-sovellusten osalta • Varmennepohjainen ratkaisu OK palvelimien väliseen liikenteeseen • Varmenteet tarvitsee jaella ainoastaan sovellusten web-palvelimille. • Työasemasovellusten osalta • Varmennepohjainen ratkaisu tarkoittaa varmenteiden jakelua kaikille työasemalla oleville sovelluksille. • Tällöin ongelmaksi nousee varmenteiden ylläpito ja hallinnointi. • Asia voidaan kiertää esimerkiksi toteuttamalla työasemasovelluksen ja kontekstipalvelimen välille välitysohjelma SerAPI

23. Välitysohjelma toimii työasemasovelluksen ja kontekstipalvelun välissä. • Välitysohjelman toteuttaminen sovelluskohtaista ja tämän määrityksen ulkopuolella, tämä mukana määrityksessä esimerkkinä. SerAPI

24. Tietoturva - muita huomioitavia kohtia • Kontekstin luominen CreateSession-metodilla, • määriteltävä koordinaattorille, mikä sovellus saa luoda • Kontekstin luominen liityttäessä kontekstiin JoinCommonContext-metodilla • määriteltävä koordinaattorille, mikä sovellus saa luoda • Kontekstiin liittyminen • määriteltävä koordinaattorille, mikä sovellus saa liittyä • Käyttäjätunnuksen asettaminen kontekstiin & luotettu sovellus • määriteltävä koordinaattorille, mikä sovellus saa asettaa käyttäjätunnuksen kontekstiin • Em. kohtien määrittely ratkaistava toteutuskohtaisesti SerAPI

25. Tietoturva - muita huomioitavia kohtia • Sessioavain välitettävä turvallisesti • Sessioavaimen yksilöllisyys, varsinkin tilanteessa, jossa sessioavaimen on voinut luoda muualla kuin kontekstipalvelusta pyytämällä • Kontekstin tuhoaminen • kun viimeinenkin sovellus eroaa kontekstista • käyttäjäkontekstin poisto suositeltavaa, kun luotettu sovellus eroaa kontekstista • Subjektikohtaiset oikeudet hakea ja asettaa kontekstietoja voidaan määritellä toteutuskohtaisesti, jos katsotaan tarpeelliseksi • huom. käyttäjäsubjekti SerAPI

26. Käyttäjä- ja potilassubjekti -erotinmerkit • Erotinmerkkien osalta on huomioitava yhteensopivuus minimikontekstihallinnan määrittelyn eri versioiden kohdalla. • Minimikontekstinhallinnan versioissa 1, 2 ja 2.1 on Id-tietojen tietotyypiksi kuvattu ainoastaan string, jota ei ole tarkemmin kuvattu. • Ei aiheudu ongelmaa (?), sillä on epätodennäköistä, että käyttäjätunnus tai potilastunnus (User.Id.Logon, Patient.Id.NationalIdNumber) pitäisi sisällään erotinmerkkejä (|, ^, &, ~, \ ) • Suositus, että User.Id.Logon ja Patient.Id.NationalIdNumber ei saa sisältää erotinmerkkejä SerAPI

27. Käyttäjäsubjekti -käyttäjätunnukset • Liittyvien ohjelmien on huolehdittava itse kontekstinhallintaan asettamiensa käyttäjätunnusten yksilöllisyydestä ja muiden järjestelmien kontekstinhallintaan asettamien käyttäjätunnusten tunnistamisesta. • Minimitason kontekstinhallintaratkaisussa koordinaattori ei huolehdi käyttäjän eri käyttäjätunnusten vastaavuustaulukoinnista (mappaus). • Etuna käyttäjätunnusten mappauksen tarpeettomuus kontekstinhallinnassa. • Tosin mappaus jää järjestelmien omalle vastuulle. SerAPI

28. SetItemValues ja GetItemValues • SetItemValues-metodi • maininta, että kontekstitiedoille voidaan määritellä koordinaattorissa erilaisia sovelluskohtaisia asetusoikeuksia toteutuskohtaisesti (huom. käyttäjätunnuksen asetukseen oltava tietty ennalta määrätty sovellus). • GetItemValues-metodi • maininta, että kontekstitiedoille voidaan määritellä koordinaattorissa erilaisia sovelluskohtaisia hakuoikeuksia toteutuskohtaisesti. SerAPI

29. Pollaus - ongelmat • Palvelinpohjaisessa ratkaisussa on otettava huomioon seuraavat kaksi web-tekniikasta seuraavaa ongelmaa: • Mikäli kontekstinhallintapalvelussa on ongelmia, esim. palvelu itse kaatunut, palvelin on kaatunut, on sovelluksen osattava toimia ilman kontekstinhallintaa. • Mikäli kontekstinhallintaan liittyneessä sovelluksessa on ongelmia, esim. web-palvelimella oleva sovellus on kaatunut tai palvelin on kaatunut, muodostuu ongelmaksi kontekstinhallintapalveluun roikkumaan jäävät turhat sovellukset. Kontekstinhallintapalvelu mahdollisesti olettaa, että kontekstia pitää vielä pitää yllä, koska kaikki sovellukset eivät ole eronneet kontekstinhallinnasta. SerAPI

30. Pollaus - yksi ratkaisuesimerkki • Yksi keino ensimmäisen ongelman ratkaisuun on toteutettavissa nykyisillä metodeilla: • Sovellus kutsuu esim. GetItemValues-metodia ja jos kontekstipalvelin vastaa kutsuun, voi sovellus varmistua sen toiminnasta. • Toinen ongelma on ratkaistavissa aikakatkaisulla: • Kontekstinhallintaan määritellään sovellukselle aikaleima, jonka voimassaoloa kontekstipalvelin tarkistaa. • Jos sovelluksen palvelulle lähettämien kyselyjen välillä kuluu enemmän aikaa kuin sille on määritelty aikakatkaisuksi, voidaan sovellus katsoa suljetuksi ja poistaa kontekstinhallinnasta. SerAPI

31. Alueellinen kontekstinhallinta • oma luku dokumentin viimeisenä kappaleena • käydään läpi, mitä erityisesti huomioitava alueellisessa käytössä • jätetäänkö luku tähän dokumenttiin vai omaksi erilliseksi dokumentiksi? • Tommi Rissanen käy tarkemmin läpi SerAPI

32. Sisältö • Pohjadokumentit • Minimikontekstinhallinnan määrittely, versio 3 - lisäykset ja täydennykset • Yleisesti • CreateSession-metodi • Sessioavain • Tietoturva • Muita tarkennuksia • Alueellinen kontekstinhallinta • Avoimet kysymykset SerAPI

33. Avoimet kysymykset • CreateSession -metodin käytön vapaaehtoisuus / pakollisuus • Sessioavaimen välitys • voidaanko ratkaista yhdenmukaisella tavalla • web-sov ok, esim. alueellisessa kontekstinhallintaratkaisussa kuvatulla tavalla • työasemasovelluksille? • Alueellinen kontekstinhallinta mukaan tähän dokumenttiin? • nyt on mukana • jatkossa erilliseen soveltamisohjeeseen • Muuta SerAPI