Dokumentinformation

Inledning

Detta dokument ska hjälpa till att beskriva vad leveransen av Säkerhetstjänster 2.x består av inklusive en kort beskrivning av de olika funktionerna/tjänsterna som paketet Säkerhetstjänster består av.

Målgrupp

Målgruppen som detta dokument vänder sig till är dels de som vill få en överblick av Säkerhetstjänsterna, dels applikationer/system som avser att ansluta sig till någon av de tjänster som levereras av Säkerhetstjänster.

1.1      Revisionshistorik

Inledning

Säkerhetstjänsterna levereras som nationella tjänster och fristående tjänster. De fristående tjänsterna kan installeras lokalt inom ett landsting eller hos en vårdgivare.

Ingående tjänster enligt figur nedan:

Följande tjänster ingår i den ”nationella leveransen”, dvs levereras såsom en tillgänglig IT-tjänst:

• Autentisering (Nationella IdP’n) - Autentiseringstjänsten har brutits ut till en egen tjänst. Ny sida med information finns här: Autentisering via SITHS eID
• Samtyckestjänst (”hotelltjänst” för samtyckeshantering)
• Patientrelation (”hotelltjänst” för hantering av patientrelation) - Tjänsten patientrelation togs bort som nationell tjänst i release 2.16 (september 2017)
• Spärrtjänst (dels som ”hotelltjänst”, dels som ”nationell toppnod” för replikerade spärrar. Spärrtjänsten har brutits ut till en egen tjänst under mars 2021.  Dokument för den nya tjänsten hittas nu här: Dokumentation Spärr
• Loggtjänst (nationell tjänst för att lagra åtkomstloggar och nationell tjänst för loggrapporter)

Samtliga tjänster kan laddas ned från CGIs FTP-site [se Adresser] för lokal installation av landsting. Detta kräver dock ett ”Avtal för användning av Säkerhetstjänster” som tecknas med Inera.

Erforderlig dokumentation finns dels på RIV TA-siten (tjänstekontrakt & tjänstekontraktsbeskrivningar) på www.rivta.se samt på www.inera.se

Exempel på referensapplikationer –hur man använder RIV TA- finns på RIV TA-siten. Se ref [R20] & [R21]

Översikt

Tjänstebeskrivning

Autentiseringstjänsten

Spärrtjänsten

Samtyckestjänsten

Sammanfattning

Samtyckestjänsten syftar till att stödja processen att hantera relationen patient till vårdpersonal samt samtycke till direktåtkomst inom sammanhållen journalföring enligt Patientdatalagen. Modellen för detta baserar sig på PDLiP-arbetet (Patientdatalagen i Praktiken) som CeHis initierat och som resulterat i RIV-specifikation PDLiP [R14]. Tjänster med motsvarande funktionalitet är idag i drift som stöd till Nationell Patientöversikt för att där hantera PDLs krav på samtycke.

Leverans

Samtyckestjänsten levereras dels som:

• En nationell ”hotelltjänst” som man kan nyttja såsom vårdgivare med sitt vårdsystem om man ej önskar implementera en egen lokal instans
• Lokal Samtycketjänst (nedladdningsbar tjänst, Linux & Windows, för anslutning till lokala vårdsystem)
• Nationella Tjänstekontrakt (se ref [R9] & [R10])

För adresser till produktion, acceptanstest & utvecklingsmiljöer, se Adresser.

Den nationella hotelltjänsten sparar samtycken i tjänsten sju dagar efter det att de blivit ogiltiga. Då det är rekommenderat att logga skapandet av Samtycken till Loggtjänsten görs uppföljningar av historiska samtycken lämpligen i Loggrapporttjänsten.

Förutsättningar för att använda Samtyckestjänsten

När en lokal installation av Samtyckestjänst installeras och man inte vill ha beroenden till Nationella Säkerhetstjänster installeras lokala implementationer av Autentisering, Åtkomstkontroll, Loggning och Loggrapporttjänsten. Alternativt kan man använda sig av Nationella Säkerhetstjänsternas tjänster.

Samtyckestjänsten anropas via Nationella tjänstekontrakt, enligt RIV TA 2.1. Kommunikation sker via Tjänsteplattformen. För mer information kring tjänsterna, se ref [R9 & R10].

OBS! Det åligger även det system som registrerar Samtycke att logga denna händelse då tjänsten i sig ej gör detta.

Kommunikation förutsätter SITHS funktionscertifikat. För information om aktuell SITHS-version, kontakta Säkerhetstjänsternas förvaltning. Anropande system måste ha ett HSA-id.

En lokal implementation av Samtyckestjänsten behöver vara ansluten till HSA-katalog via HSA-TK [R15] samt Personuppgiftstjänsten  [R16]

Loggtjänsten

Sammanfattning

Säkerhetstjänsterna Central loggtjänsthantering syftar till att stödja processen att hantera kraven på uppföljning av verksamhetens åtkomst till patientinformation enligt Patientdatalagen och SOSFS 2008:14 §11 & §12. Modellen för detta baserar sig bl.a på PDLiP-arbetet samt utredningar av AL-S (AL-S Loggning i NPÖ) samt ett antal kravmöten med AL-S.
Tjänster med motsvarande funktionalitet är idag i drift som stöd till Nationell Patientöversikt för att där hantera PDLs krav på loggning av åtkomst till vårdinformation.

Leverans

Loggtjänsten (se SAD, ref [R7]) levereras dels som:

• En nationell lagringstjänst för lagring av åtkomstinformation (åtkomstloggar) [R11]
• Läsande tjänster för åtkomst av åtkomstinformation [R11]
• Hämtningstjänst via REST-API för ”bulkhämtning” av en vårdgivares åtkomstloggar för uppföljning i lokalt loggsystem [R17]
• GUI och loggrapporter för manuell uppföljning av åtkomstloggar [R7]

För adresser till produktion, acceptanstest & utvecklingsmiljöer, se Adresser.

Förutsättningar för att använda Loggtjänsten

Den nationella loggtjänsten anropas dels via Nationella tjänstekontrakt, enligt RIV TA 2.1, och dels via ett speciellt tjänstekontrakt (ej RIV TA) såsom en Hämtningstjänst för överföring av åtkomstloggar till ett lokalt logguppföljningssystem. För mer information kring tjänsterna, se ref [R11 & R17]. Kommunikation för RIV-TA tjänster sker via Nationell Tjänsteplattform, medans tjänster som inte är enligt RIV-TA (utan REST) kräver direktanslutning, dvs ej via Tjänsteplattformen

Kommunikation förutsätter SITHS funktionscertifikat. För information om aktuell SITHS-version, kontakta Säkerhetstjänsternas förvaltning. Anropande system måste ha ett HSA-id.

Loggtjänsten finns från och med version 2.3 även som lokal tjänst.

Adresser/URL

Exempelkod och nedladdningssite

Adresser tjänster för nationell Spärr, Samtycke och Logg för olika miljöer. 

Hur adressen till en tjänst ser ut beror på följande saker:

1. Miljö
2. Om anropet går via Sjunet eller Internet
3. Om anropet går via Tjänsteplattformen eller ej
4. Namnet på själva tjänsten

Miljöerna Utvtest och Acctest har ingen koppling till Tjänsteplattformen.

Loggtjänsterna är f. n inte upplagda på Tjänsteplattformen i någon miljö.

Anropen till Säkerhetstjänsterna från Tjänsteplattformen går alltid via Sjunet.

För att förstå hur kopplingarna fungerar se 4.2.1 och 4.3.1. Användningen av de olika miljöerna styrs av förvaltningen av Säkerhetstjänster.

Miljö för konsumenter på Sjunet

Miljö för konsumenter på Internet

Spärr version 4 

Spärrtjänsten har brutits ut till en egen tjänst. För information om nya Spärrtjänsten se Guide till Ineras Spärrlösning

Logg version 2

(

konsument anropar via Tjänsteplattformen)

Nytt från och med Säkerhetstjänster 2.16 med stöd för reservidentiteter.

www.rivta.se/domains/ehrinformationsecurity_auditing_blockinglog.html

Denna domän utvecklas inte längre och kommer vara avvecklad 01 Jun 2020 ; för nyutveckling, support och buggrättningar hänvisas till version 4 nedan (observera ny domän).