Sammanhållen Vaccinationsinformation Anslutningsinstruktion

Transkript

1 Sammanhållen Vaccinationsinformation Anslutningsinstruktion - Integrationsarkitektur och anslutningsanvisningar för system som används för journalföring av vaccinationer Version P1.1

2 1. Innehåll 1. Innehåll Figurförteckning Dokumentinformation Versionshistorik Referenser Förkortningar och begrepp Introduktion Målgrupp Sammanhållen Vaccinationsinformation Nationella Tjänsteplattformen, NTjP Tjänstekontrakt Säkerhet Informationsöverföring Informationsåtkomst Lös koppling Aggregerad tjänst Tillgängliggöra data via Syfte Teknisk checklista för QA - testmiljön Certifikat Nät Anslutning som producent av Anslut som konsument av engagemangsindex Teknisk checklista PROD - produktionsmiljön Certifikat Nät Anslutning som producent av Anslut som konsument av engagemangsindex Hämta data via Syfte Sid 1/22

3 9.2 Teknisk checklista QA - testmiljön Certifikat Nät Anslutning som konsument av aggregerad tjänst Teknisk checklista PROD - produktionsmiljön Certifikat Nät Anslutning som konsument av aggregerad tjänst Nödvändiga avtal Vårdgivare med vaccinationsjournalsystem anslutet till NTjP Anslutning av konsument av tjänstekontraktet för EI Update Anslutning av producent av tjänstekontraktet för GVH Anslutning av konsument av tjänstekontraktet för GVH Etablering av samverkan mellan anslutet källsystem (producent) och konsumentsystem Svevac Vårdgivares aktivering av Svevac Figurförteckning Figur 1. De tre intressentkategorierna... 9 Figur 2. Schematisk beskrivning av NTjP som baseras på den öppna koden SKLTP Figur 3. Viktiga dokument som förklarar RIV-TA Figur 4. Schematisk bild över tjänstekontraktet för vaccinationshistorik i NTjP Sid 2/22

4 3. Dokumentinformation 3.1 Versionshistorik Version Datum Beskrivning av ändringar Författare Skapad Göran Oettinger Tillägg NTjP, avtal Marcus Claus Tillagda referenser. Rättning av blanketthantering Göran Oettinger Granskat, justerat, lagt till läsanvisning Marcus Claus kompletterat med synpunkter från SKL, Lars M, bakgrund till arbetet, effektmål, bilder, referens säkerhetstjänsterna. Remiss till Lars M SKL, Michael Ö, Thord A, Inera. P Beslutad av förvaltninsggruppen att tillgängliggöras till intressenter P1.1 Uppdatering av NTjP portar på Sjunet från till 443. Tillägg av förstudiemall som krav vid anslutning mot NTjP. Korrigering av inaktuella länkar. Marcus Claus Thord Arbin, Rita Bodin Göran Oettinger 3.2 Referenser Nr Dokumentnam n Kommentar R1 RIV-TA RIV Tekniska Anvisningar; dokumentation, tjänstekontraktsbeskrivnin gar med mera. R2 RIV-TA Översikt RIV Tekniska Anvisningar, Översikt. Här beskrivs mål, omfattning och strategier för kommunikation mellan system och tjänsteplattformar inom vård och omsorg. Länk i/specs/riv_tekniska_anvisningar _Oversikt.pdf Sid 3/22

5 R3 RIV TA Exempelapplikation Här finns mallapplikationer för Java och.net, när det gäller att kommunicera med gemensamma tjänsteplattformen (och den nationella). R4 T-boken Principerna som styr hur vi integrerar och vilken roll en tjänsteplattform har. R5 SKLTP Beskrivning av öppenkällkodsprojektet för tjänsteplattformen R6 TKB GVH Tjänstekontraktsbeskrivnin g clinicalprocess:actprescrip tion:actoutcome R7 TKB EI Tjänstekontraktsbeskrivnin g itintegration:engagementin dex R8 Svevac Svevac vaccinationsjournalsystem R9 R10 SITHS funktionscertifikat SITHS rootcertifikat SITHS funktionscertifikatsbeställni ng SITHS rootcertifkat R11 Blanketter Blanketter för anslutning till Nationella Tjänsteplattformen R12 R13 Projektplan Sammanhålle Vaccinationsinfor mation Säkerhetstjänster na SKL och Inera; Projektdokument Autentisering, Logg, Samtycke, Spärrtjänst, Patientrelation R14 Hälsa för mig E-hälsomyndighetens planerade invånartjänst R15 Anslutning Nationella Anslutningsförfarande för Bp21ReferenceApplication s/dokumentarkiv/referensarkitektu r_vard_omsorg_vitbokens_tekniska_arkitektur_rapp ort_110314_rev_b.pdf ss_activityprescription_actoutcome.html _engagementindex.html PROJEKT/Svevac/ PROJEKT/SITHS/ PROJEKT/SITHS/ PROJEKT/SITHS/ Kan erhållas genom projektledning hos SKL/Inera PROJEKT/Sakerhetstjanster/ ehalsotjanster/invanartjanster/hals aformig---ett-personligthalsokonto/ PROJEKT/ICC-Integration- Sid 4/22

6 Tjänsteplattforme n producent Competence-Center/Anslutning-till- Tjansteplattformen/Anslutning-avproducent---Bestallning-C/ R16 Anslutning Nationella Tjänsteplattforme n Anslutningsförfarande för konsument PROJEKT/ICC-Integration- Competence-Center/Anslutning-till- Tjansteplattformen/Anslutning-avkonsument---Bestallning-B/ 3.3 Förkortningar och begrepp Begrepp Betydelse Kommentar NTjP Nationella tjänsteplattformen för svensk vård- och omsorg, som tillhandahålls av Inera AB RTP Regional tjänsteplattform som tillhandahålls av vårdgivarhuvudmannen (SLL m.fl.) Teknisk arkitektur och infrastrukturella tjänster för kommunikation och informationsåtkomst Teknisk arkitektur och infrastrukturella tjänster för kommunikation och informationsåtkomst EI Engagemangsindex En central tjänst i NTjP/RTP som ger information om vad för slags information som finns om en patient, hos en viss vårdenhet vid en viss tidpunkt GVH Tjänstekontrakt för att ge vaccinationsinformation om en patient. Finns i NTjP/RTP som både virtuell och aggregerad tjänst, och produceras (=stöds) av (vissa) journalsystem bl.a. Svevac Svevac Vaccinationsjournalsystem som tillhandahålls av SKL genom Inera (sedan 1/1-2014) Framtaget och har tillhandahållits av Smittskyddsinstitutet (sedan 1/ Folkhälsomyndigheten) i flera år. Används av stort antal vaccinatörer i Sverige PUL Personuppgiftslagen En lag som trädde i kraft 1998 i syfte att skydda människor mot att deras personliga integritet kränks när personuppgifter behandlas. NVR Nationella Vaccinationsregistret /12:123; Ny ordning för rapportering av genomförandet av nationella vaccinationsprogram Sid 5/22

7 TK, TKB RIV-TA Tjänstekontrakt, Tjänstekontraktsbeskrivning Regelverk för interoperabilitet i vård och omsorg Tekniska Anvisningar Beskrivning av informationsinnehåll, fältregler och meddelandeformat samt icke-funktionella krav och verksamhetsregler för åtkomst till/förmedling av information enligt webservices, enligt RIV-TA Vårdens tekniska regler för hur informationsarkitektur skall utformas. Förvaltas av Inera. Sid 6/22

8 4. Introduktion Sammanhållen Vaccinationsinformation (SKL, Inera) är ett utvecklingsprojekt för SKL/Ineras övertagande av såväl systemet Svevac från Folkhälsomyndigheten, som etablering av en långsiktig arkitektur för att åstadkomma tillgång till sammanhållen vaccinationsinformation via den nationella tjänstearkitekturen för vård och omsorg. Projektet beskrivs översiktligt nedan. Detta dokument beskriver hur system som används för journalföring i vaccinationsverksamhet ansluts till nationella tjänsteplattformen (NTjP) och interagerar med dess tjänst Engagemangsindex (EI) och producerar respektive konsumerar tjänstekontraktet för vaccinationshistorik (, GVH), i syfte att tillgängligöra vaccinationsinformation till andra vaccinatörer, och ge sina användare tillgång till vaccinationsinformation från andra vaccinatörer (sammanhållen vaccinationsjournal). Härigenom stöds det övergripande målet att tillgängliggöra sammanhållen vaccinationsinformation för intressenterna vårdgivare och vårdpersonal, patienter och i vissa fall myndigheter med ansvar för uppföljning av smittskydd och stöd till vårdens aktörer, på ett enhetligt och standardiserat sätt genom användning av den gemensamma tjänstearkitekturen. Anvisningarna i detta dokument underlättar arbetet med att planera och förbereda användning av tjänstekontrakten för vaccinationsinformation och hänvisar i förekommande fall till instruktioner och blanketter som finns att ladda ner från Ineras hemsida [R5, R6, R8, R9, R10]. Vaccinationsjournalsystemet Svevac [R7] som används i stor utsträckning i Sverige, är redan anslutet till tjänsteplattformen som producent (sedan 2013) och konsument (2015 kvartal 1). Detta betyder att vaccinatörer som använder Svevac inte behöver göra några särskilda anpassningar hos sig utan endast beställa aktivering av Svevac gentemot vårdgivar- och invånartjänster. Avsnitt 11 vänder sig särskilt till vårdgivare som använder Svevac och beskriver hur sådan aktivering beställs av Svevac-förvaltningen. 5. Målgrupp Detta dokument riktar sig till följande slag av läsare: huvudmännens (vårdgivarnas) verksamhetsansvariga för smittskydd och vaccinationsverksamhet: vårdgivarnas systemägare och förvaltare av system som används för journalföring av vaccinationer leverantörer av journalsystem systemintegratörer utvecklare av andra applikationer och tjänster och för vårdpersonal, invånare och för uppföljning Inledningsvis presenteras och förklaras den nationella tjänsteplattformens arkitektur och mekanismer för säker informationsåtkomst översiktligt. Sid 7/22

9 Därefter beskrivs steg för steg hur vaccinationsinformation tillgängliggörs från ett system till andra (produktion), och hur ett system får tillgång vaccinationsinformation via tjänsteplattformen från andra journalsystem som är anslutna till den (konsumtion). Verksamhetsansvariga rekommenderas att ta del av avsnitt 6 samt, om man är användare av Svevac även avsnitt 11, och om man (även) använder andra journalsystem i vaccinationsverksamhet avsnitten 8, 8.1, 9, 9.1 samt 10. Integratörer och systemleverantörer rekommenderas att läsa samtliga avsnitt i detta dokument. Sid 8/22

10 6. Sammanhållen Vaccinationsinformation Sammanhållen Vaccinationsinformation (SKL, Inera) är ett utvecklingsprojekt för SKL/Ineras övertagande av såväl systemet Svevac från Folkhälsomyndigheten, som etablering av en långsiktig arkitektur för att åstadkomma tillgång till sammanhållen vaccinationsinformation via den nationella tjänstearkitekturen för vård och omsorg. Vaccinationer spelar en central roll för att upprätthålla en god folkhälsa och skydda individer och samhälle mot såväl allvarliga utbrott av epidemier och pandemier, som mot infektioner med mera begränsad smittsamhet. Behovet av en sammanhållen informationshantering kring vaccinationer har påtalats under många år, av olika intressenter och ur olika perspektiv. Samhället behöver genom sina myndigheter ha kunskap om invånarnas skydd mot epidemiska sjukdomar och vårdgivare behöver kunna följa upp sin verksamhet, t ex effekt och resultat av givna behandlingar. För vårdpersonal är kännedom om patientens vaccinationer en del i underlaget för medicinsk bedömning, rådgivning och behandling. För individen själv är det värdefullt att kunna överblicka det egna skyddet mot farliga infektionssjukdomar, t ex i samband med resor eller vid utbrott av epidemier och pandemier. Figur 1. De tre intressentkategorierna Arbetet syftar till att öka tillgången till vaccinationsinformation för såväl invånare som vårdpersonal och ansvariga för uppföljning. 1177/Mina Vårdkontakter (MVK), Journal på Nätet samt arbetet med en samlad Journal- och Läkemedelsportal (SIVO; Inera) är viktiga samverkansprojekt. Kommunikation med olika kategorier av användare invånare, Sid 9/22

11 vårdpersonal och ansvariga för uppföljning och utveckling är central, liksom att konsolidera en långsiktigt hållbar teknisk och informatisk arkitektur [R12]. I Sverige finns bara en lagstadgad skyldighet för vårdgivare att rapportera vaccinationer som ligger inom det nationella vaccinationsprogrammet, vilket i nuläget omfattar de vaccinationer som erbjuds inom barn- och skolhälsovård. Denna rapportering ska göras till ett särskilt nationellt vaccinationsregister, som hålls av Folkhälsomyndigheten. Det är ett hälsodataregister, som inte får användas av vårdgivare som stöd för vård och behandling. Det är heller inte tillgängligt för att invånare ska kunna överblicka sina egna vaccinationer. Det koncept för Sammanhållen Vaccinationsinformation, som SKL och CeHis tog fram 2013 bygger på att vårdgivare frivilligt, inom ramen för Sammanhållen journalföring (enl. Patientdatalagen), tillgängliggör vaccinationsinformation för andra vårdgivare och att invånare ges tillgång till sina uppgifter via direktåtkomst till journalinformation (via den nationella tjänsteplattformen). Redan sommaren 2013 testades framgångsrikt punkt-till-punkt åtkomst av vaccinationsinformation (från Svevac), via tjänsteplattformens tjänstekontrakt, i invånartjänsterna Mina Vårdflöden och Prenumerationstjänsten för Hälsa för Mig [R14]. Sedan dess ger även Journalen vaccinationsinformation i sin tjänst. Regeringen beslutade under 2013 särskilda medel för att användas av Sveriges Kommuner och Landsting för att ta över och utveckla såväl systemet Svevac från dåvarande Smittskyddsinstitutet (SMI), som att verka för det övergripande målet att möjliggöra att alla vaccinationer ska registreras på sådant sätt att informationen kan göras tillgänglig för invånare, vårdpersonal och myndigheter med ansvar för uppföljning och utveckling genom den gemensamma tjänstearkitekturen (NTjP, RIV-TA). Projektet bidrar till att uppgifter om individers vaccinationer blir tillgängliga för individen själv, behörig vårdpersonal samt myndigheter med ansvar för uppföljning genom att anpassa, ansluta och etablera förvaltning av Svevac till den nationella gemensamma tjänsteplattformen (NTjP), samt stödja anslutning av andra journalsystem och IT-stöd där vaccinationsinformation registreras och presenteras, via tjänstekontrakt i NTjP. Detta beskrivs i återstoden av detta dokument. Sid 10/22

12 7. Nationella Tjänsteplattformen, NTjP NTjP baseras på den öppna källkoden SKLTP [R5]. Integrationer för informationsåtkomst och -utbyte via NTjP sker för att möjliggöra interaktion mellan system och åtkomst av information och samtidigt behålla en lös koppling mellan konsumenter och producenter. Det sker genom principer som är gemensamma för Sveriges vårdgivare genom den s.k. nationella referensarkitekturen för vård och omsorg T-boken [R4]. Det innebär i praktiken att allt informationsutbyte sker enligt nationellt standardiserade utbytesformat som är paketerade som system-oberoende web-services. Figur 2. Schematisk beskrivning av NTjP som baseras på den öppna koden SKLTP Sid 11/22

13 7.1 Tjänstekontrakt Utbytesformaten i NTjP kallas tjänstekontrakt (TK) och representeras tekniskt som tjänsteorienterade XML-scheman. Den tekniska åtkomsten sker enligt den nationella standarden RIV Tekniska Anvisningar, Basic Profile 2.1 [R1, R2]. För leverantörer av de system som ska integreras innebär det att det finns en uppsättning färdiga WSDL-filer som hämtas hem från följande projektplats: TK levereras områdesvis som ZIP-filer. Varje ZIP-fil innehåller wsdl:er med tillhörande XMLscheman, ett dokument som beskriver alla regelverk för dem som ska använda eller skapa en tjänst enligt TK, samt skript för att generera programkod för.net och Java från WSDL-filerna. Där finns också ett generellt exempel-projekt i.net och Java som kan användas som mall när man vill bekanta sig med TK och RIV Tekniska Anvisningar [R3]. Det är i regel tillräckligt att sätta sig in i de olika TK. RIV Tekniska Anvisningar är i första hand till för dem som ska utveckla nya TK. Men det är ändå en rekommendation att läsa anvisningarna för en fördjupad förståelse för olika konstruktioner i TK speciellt de som rör versionshantering. Figur 3. Viktiga dokument som förklarar RIV-TA Sid 12/22

14 7.2 Säkerhet Den nationella arkitekturen delar in säkerheten i två huvudområden: Informationsöverföring (system - system) Informationsåtkomst (människa system) 7.3 Informationsöverföring Att kommunicera med och via NTjP innebär att följa säkerhetsreglerna för system-system. Det handlar då om följande funktioner: 1. Att genom PKI-autentisering styrka identiteten hos de kommunicerande systemen 2. Att skydda informationsöverföringen från insyn med hjälp av krypterad informationskanal 3. Att säkerställa att informationsägaren har kontroll över vilka tjänster som får åtkomst till informationen NTjP säkerställer alltså att informationsutbytet är krypterat och att informationsåtkomst behörighetstyrs till tjänster som informationsägaren godkänt. Båda dessa funktioner bygger på användningen av HTTPS/TLS d.v.s. krypterad kommunikationskanal med klient-autentisering. Det sker med hjälp av PKI-certifikat som utfärdas av SITHS. Dessa certifikat är av typen HCC Funktion [R8, R9]. Behörighetskontrollen sker i NTjP genom dess uppslag i sin behörighets- och adresseringskatalog. Säkerhetsmodellen bygger på s.k. organisationstillit. Varje vårdgivare har ansvar för att de system som verksamheten använder är korrekta i sin funktion i betydelsen att de utför det som användaren begärt. Säkerhetsmodellen skyddar inte mot onda system som förvanskar information i syfte att åstadkomma skada. 7.4 Informationsåtkomst Varje system ansvarar internt för att informationshantering sker enligt gällande lagar och förordningar. NTjP hanterar i detta avseende bara en regel nämligen att kommunikation över öppna nät ska vara insynsskyddad. Övriga krav som ställs enligt personuppgifts- och/eller patientdatalagen måste hanteras av systemet som betjänar slutanvändaren. Det kan ske med hjälp av stödtjänster som nås via NTjP, så som spärrtjänst, tjänst för kontroll av medgivanden, tjänst för kontroll patientrelationer och loggtjänst. NTjP är ingen aktiv part i att systemet följer PUL och PDL, utan tillgängliggör stödtjänster som systemet kan välja att integrera i syfte att tillmötesgå kraven från lagstiftaren. Sid 13/22

15 Autentiseringstjänster för slutanvändare (autentisering i syfte att logga in i ett system) hanteras inte av NTjP. Autentiseringstjänster kommunicerar istället punkt-till-punkt med verksamhetens tillämpning/e-tjänst. 7.5 Lös koppling NTjP uppträder som en fasad för underliggande informationskällor så som stödtjänster och journalsystem. NTjP agerar mellanhand mellan kommunicerande parter. Den tillför en funktion som kallas verksamhetsadressering. Eftersom det generellt, nationellt, regionalt och lokalt kan finnas ett antal journalsystem internt som kommunicerar med privata aktörer och som i sin tur har olika system för olika syften, har NTjP en viktig roll i att uppvisa en tjänst för varje informationsbehov, så att inte varje system som har behov av en information från verksamhet utanför det egna systemet behöver administrera vilka verksamheter som använder vilket system. För att kunna lösa den uppgifter har den NTjP tillgång till ett register (tjänsteadresseringskatalog) som håller en centralt administrerad konfiguration över vilka system som används av vilken verksamhet. På det sättet kan meddelanden förmedlas vidare till aktuellt system utan att avsändaren behöver känna till relationen mellan verksamheter och system. Nyckeln till detta kommunikationsmönster är att systemet som använder en tjänst i NTjP alltid fyller i ett adressfält som finns i alla TK. Adressfältet ska (med få undantag) innehålla mottagande verksamhets HSA-id. I samband med att ett meddelande förmedlas vidare görs också en kontroll av att informationsägaren godkänt utbyte med aktuellt system (systemet som använder tjänsten i NTjP). 7.6 Aggregerad tjänst Eftersom det finns många källsystem (journalsystem; producenter) som kan tillhandahålla vaccinationshistorik finns tjänstekontraktet också som en s.k. aggregerad tjänst i NTjP. Det innebär att en konsument (t.ex. en patient- eller vårdgivarportal eller annat journalsystem) kan hämta all vaccinationshistorik för en patient genom att anropa den aggregerade tjänsten (verksamhetsadresserad; Inera) istället för att anropa alla källsystem (producenter). Det är sålunda den aggregerade tjänstens uppgift att ta reda på i vilka källsystem (producenter) som en patient har vaccinationsdata, anropa dessa och sätta samma ett svar till konsumenten, med den kompletta vaccinationshistoriken. För att den aggregerade tjänsten ska veta vilka källsystem som ska anropas måste varje källsystem (producent) uppdatera NTjP:s engagemangsindex (EI) när data för en patient skapas, uppdateras eller raderas. Sid 14/22

16 8. Tillgängliggöra data via Detta avsnitt berör hur man tillgängliggör vaccinationshistorik via tjänsteplattformen med hjälp av tjänstekontraktet (GVH) [R5]. Figur 4. Schematisk bild över tjänstekontraktet för vaccinationshistorik i NTjP 8.1 Syfte Genom att ansluta sig som producent av tjänstekontraktet tillgängliggör man vaccinationsdata till andra anslutna system och tjänster. Genom att använda det framtagna kontraktet behövs endast en integration samtidigt som vaccinationshistoriken då blir tillgänglig för andra applikationer och tjänster via tjänsteplattformen. Det är ett krav enligt tjänstekontraktet att uppdatera engagemangsindex när vaccinationsinformation för en patient skapas och uppdateras. Utförlig information om hur uppdatering av engagemangsindex ska göras finns i tjänstekontraktsbeskrivningarna för [R5] och Engagemangsindex [R6]. 8.2 Teknisk checklista för QA - testmiljön Certifikat Beställ testversion av funktionscertifikat för användning från anropande klient mot Tjänsteplattformen [R8]. Sid 15/22

17 Certifikatet innehåller ett HSA-Id som används i anslutningsblanketterna (se och 4.2.4) För att lita på SITHS-testcertifikat krävs att servern som använder sig av certifikatet litar på SITHS rootcertifikat. SITHS rootcertifikat finns att ladda ner på SITHS hemsida [9] Nät Tjänsteplattformen kan anropas både via Internet och Sjunet. Sjunet rekommenderas i de fall det anslutande systemet har tillgång. Sjunet: Öppna upp brandvägg(ar) för http(s) trafik till qa.esb.ntjp.sjunet.org på port 443 Öppna upp brandvägg(ar) för http(s) trafik från qa.esb.ntjp.sjunet.org Internet: Öppna upp brandvägg(ar) för http(s) trafik till qa.esb.ntjp.se på port 443 Öppna upp brandvägg(ar) för http(s) trafik från qa.esb.ntjp.se Anslutning som producent av Fyll i en förstudiemall [R15] och skicka in till nationellkundservice@inera.se. Kontakta nationell kundservice (nationellkundservice@inera.se) för att få förifylld mall för anslutningsblankett C. Fyll i och skicka tillbaka till kundservice. Icke förifyllda blanketter finns på Ineras hemsida [R15]. Kundservice återkommer när anslutningen är gjord och anrop kan göras. För att godkänna och etablera samverkan med andra system och tjänster krävs att D-blanketter fylls i med information om både det egna systemet/tjänsten och det system/tjänst man vill samverka med. Tillvägagångssättet är samma som med C-blanketten Anslut som konsument av engagemangsindex För att ansluta till engagemangsindex tjänst för uppdatering krävs ifylld anslutningsblankett B och D för engagemangsindex [R10]. 8.3 Teknisk checklista PROD - produktionsmiljön Certifikat Beställ produktionsversion av funktionscertifikat för användning från anropande klient mot Tjänsteplattformen [R8]. Certifikatet innehåller ett HSA-Id som används i anslutningsblanketterna (se och 4.3.4). För att lita på SITHS-testcertifikat krävs att servern som använder sig av certifikatet litar på rootcertifikat. SITHS rootcertifikat finns att ladda ner på SITHS hemsida [9] Nät Tjänsteplattformen kan anropas både via Internet och Sjunet. Sjunet rekommenderas i de fall det anslutande systemet har tillgång. Sid 16/22

18 Sjunet: Öppna upp brandvägg(ar) för http(s) trafik till esb.ntjp.sjunet.org på port 443 Öppna upp brandvägg(ar) för http(s) trafik från esb.ntjp.sjunet.org Internet: Öppna upp brandvägg(ar) för http(s) trafik till esb.ntjp.se på port 443 Öppna upp brandvägg(ar) för http(s) trafik från esb.ntjp.se Anslutning som producent av Fyll i en förstudiemall [R15] och skicka in till nationellkundservice@inera.se. Kontakta nationell kundservice (nationellkundservice@inera.se) för att få förifylld mall för anslutningsblanketter C. Fyll i och skicka tillbaka till kundservice. Icke förifyllda blanketter finns på Ineras hemsida [R10] Kundservice återkommer när anslutningen är gjord och anrop kan göras. För att godkänna och etablera samverkan med andra system och tjänster krävs att D-blanketter fylls i med information om både det egna systemet/tjänsten och det system/tjänst man vill samverka med. Tillvägagångssättet är samma som med C-blanketten Anslut som konsument av engagemangsindex För att ansluta till engagemangsindex tjänst för uppdatering krävs ifylld förstudiemall, anslutningsblankett B och D för engagemangsindex [R16]. Sid 17/22

19 9. Hämta data via Detta avsnitt berör hur man gör för att som konsument hämta och visa vaccinationsdata från andra system via Tjänsteplattformen med hjälp av tjänstekontraktet och dess aggregerade tjänst. Det är konsumenten som ansvarar för att gällande regler och policys följs vad gäller att ge användaren tillgång till informationen som hämtats. Invånartjänster ansvarar för att information som markerats att den ej skall visas för patient, ej visas, och vårdgivartjänster måste kontrollera åtkomsten med hänsyn tagen till patientrelation, spärr och samtycke till sammanhållen journal (PDL och Säkerhetstjänsterna) [R13]. Tjänstekontraktsbeskrivningen beskriver detta mer i detalj [R6]. 9.1 Syfte Genom att ansluta sig som konsument av tjänstekontraktet kan man läsa vaccinationshistorik från andra system som är anslutna som producenter av kontraktet via tjänsteplattformen. Detta kan t.ex. användas för att åstadkomma sammanhållen journalföring för att ge en mer komplett vaccinationshistorik för varje enskild patient inom ramen för det egna journalsystemet. Denna teknik används också av tjänster som vårdgivarportalen för sammanhållen journal och av invånartjänster för att patienten skall kunna läsa och ta del av sin egen vaccinationshistorik oavsett var informationen finns dokumenterad. Genom att ansluta sig mot den aggregerade tjänsten kan man med ett tjänsteanrop få tillgång vaccinationshistorik från alla anslutna källsystem för en patient utan att behöva känna till var den finns lagrad och hur. 9.2 Teknisk checklista QA - testmiljön Certifikat Beställ testsversion av funktionscertifikat för användning från anropande klient mot Tjänsteplattformen [R8]. Certifikatet innehåller ett HSA-Id som används i anslutningsblanketterna (se 5.2.3). För att lita på SITHS-testcertifikat krävs att servern som använder sig av certifikatet litar på rootcertifikat. SITHS rootcertifikat finns att ladda ner på SITHS hemsida [9] Nät Tjänsteplattformen kan anropas både via Internet och Sjunet. Sjunet rekommenderas i de fall det anslutande systemet har tillgång. Sjunet: Öppna upp brandvägg(ar) för http(s) trafik till qa.esb.ntjp.sjunet.org på port 443 Internet: Öppna upp brandvägg(ar) för http(s) trafik till qa.esb.ntjp.se på port 443 Sid 18/22

20 9.2.3 Anslutning som konsument av aggregerad tjänst Fyll i en förstudiemall [R16] och skicka in till nationellkundservice@inera.se. Kontakta Nationell Kundservice (nationellkundservice@inera.se) för att få förifylld mall för anslutningsblanketter B och D för att bli konsument av den aggregerade tjänsten. Fyll i och skicka tillbaka till kundservice. Icke förifyllda blanketter finns på Ineras hemsida [R16]. Kundservice återkommer när anslutningen är gjord och anrop kan göras. För att godkänna och etablera samverkan med andra system och tjänster krävs att D-blanketter fylls i med information om både det egna systemet/tjänsten och det system/tjänst man vill samverka med. Tillvägagångssättet är samma som med C-blanketten. 9.3 Teknisk checklista PROD - produktionsmiljön Certifikat Beställ produktionsversion av funktionscertifikat för användning från anropande klient mot Tjänsteplattformen [R8]. Certifikatet innehåller ett HSA-Id som används i anslutningsblanketterna (se 5.3.3). För att lita på SITHS-testcertifikat krävs att servern som använder sig av certifikatet litar på rootcertifikat. SITHS rootcertifikat finns att ladda ner på SITHS hemsida [9] Nät Tjänsteplattformen kan anropas både via Internet och Sjunet. Sjunet rekommenderas i de fall det anslutande systemet har tillgång: Sjunet: Öppna upp brandvägg(ar) för http(s) trafik till esb.ntjp.sjunet.org på port 443 Internet: Öppna upp brandvägg(ar) för http(s) trafik till esb.ntjp.se på port Anslutning som konsument av aggregerad tjänst Fyll i en förstudiemall [R16] och skicka in till nationellkundservice@inera.se. Kontakta Nationell Kundservice (nationellkundservice@inera.se) för att få förifylld mall för anslutningsblanketter B och D. Fyll i och skicka tillbaka till Nationell Kundservice. Icke förifyllda blanketter finns på Ineras hemsida [R10] Kundservice återkommer när anslutningen är gjord och anrop kan göras. För att godkänna och etablera samverkan med andra system och tjänster krävs att D-blanketter fylls i med information om både det egna systemet/tjänsten och det system/tjänst man vill samverka med. Tillvägagångssättet är samma som med C-blanketten. Sid 19/22

21 10. Nödvändiga avtal 10.1 Vårdgivare med vaccinationsjournalsystem anslutet till NTjP Avtal och erhållet Funktionscertifikat från Inera, installerat i källsystemet (konsument/producent) Anslutning av konsument av tjänstekontraktet för EI Update Avtal med Inera enligt Beställning B. Center/Anslutning-till-Tjansteplattformen/Anslutning-av-konsument---Bestallning-B/ 10.3 Anslutning av producent av tjänstekontraktet för GVH Avtal med Inera enligt Beställning C. Center/Anslutning-till-Tjansteplattformen/Anslutning-av-producent---Bestallning-C/ 10.4 Anslutning av konsument av tjänstekontraktet för GVH Avtal med Inera enligt Beställning B. Center/Anslutning-till-Tjansteplattformen/Anslutning-av-konsument---Bestallning-B/ 10.5 Etablering av samverkan mellan anslutet källsystem (producent) och konsumentsystem Avtal med Inera enligt Beställning D. Center/Anslutning-till-Tjansteplattformen/Etablera-samverkan---Bestallning-D/ Notera att samverkan behöver beställas och etableras mellan producent och den/de konsumentsystem/-tjänster som vid tiden är aktuella att tillhandahålla vaccinationsinformation till. Det kan alltså röra sig om flera konsumenter, exempelvis invånartjänster så som Vårdhändelser, Journalen, vårdgivarportaler som SIVO/NPÖ och tjänster som API-gateway. Konsultera Inera för information om aktuella möjliga konsumenter. Sid 20/22

22 11. Svevac Vaccinationsjournalsystemet Svevac [R7] som används i stor utsträckning i Sverige, är redan anslutet till tjänsteplattformen som producent (sedan 2013) med etablerad samverkan med vårdgivar- och invånartjänster, och som konsument (från 2015 kvartal 1). Svevac-applikationen använder (sedan juni 2014) tjänsteplattformens säkerhetstjänster för kontroll av spärr, samtycke, patientrelation och loggning. Svevac stödjer informationsmängderna och tjänstekontrakten för vård- och omsorgskontakt (GetCareContacts) och strukturerad vaccinationshistorik () samt samverkar med Engagemangsindex enligt kraven hos dessa. Detta betyder att vaccinatörer som använder Svevac inte behöver göra några särskilda anpassningar hos sig utan endast beställa aktivering av Svevac gentemot vårdgivar- och invånartjänster Vårdgivares aktivering av Svevac Eftersom Svevac är ett system/tjänst som används av flera vårdgivare (landsting, kommuner, privata) och deras utförare av vaccinationsverksamhet, så behöver Svevac konfigureras så att information ges till konsumerande system via tjänsteplattformen bara i de fall som vårdgivaren (informationsägaren) beslutat att så skall ske för alla eller ett urval av de vaccinationsenheter som vårdgivaren ansvarar för. Det som behöver anges vid aktivering av att Svevac är identifierande information om informationsägare (vårdgivaren), identifierande information om enheter vars vaccinationsjournalinformation skall inkluderas i svar till konsumerande tjänster samt viss administrativ information. Aktiveringen görs genom att fylla i ett beställningsformulär för aktivering av Svevac gentemot konsumerande tjänster/system, och skicka det till Svevac-förvaltningen. För mer information och hjälp inför aktivering i Svevac, kontakta Svevac-supporten: incidenthantering/svevac/ Sid 21/22