Innehåll
1. Dokumentinformation
1.1. Inledning
Detta dokument ska hjälpa till att beskriva vad leveransen av PU-tjänsten består av inklusive en kort beskrivning av hur man kan använda tjänsten.
1.2. Målgrupp
Målgruppen som detta dokument vänder sig till är dels de som vill få en överblick av PU-tjänsten, dels applikationer/system som avser att ansluta sig till PU-tjänsten samt användere som vill använda Webb-GUI:t för att hämta personuppgifter.
1.3. Revisionshistorik
2. Beskrivning
Den Nationella PU-tjänsten är en personuppgiftstjänst där man kan hämta personuppgifter för någon genom deras personnummer (PNR), samordningsnummer (SNR), nationella reservidentitet (NRID) samt lokala reservidentitet (LRID). PU-tjänsten hämtar personuppgifter från Navet (Skatteverket, SKV) och cache:ar personuppgifterna i ett mellanlager för att minska kostnader och öka tillgänglighet för personuppgifterna. Dessa personuppgifter uppdateras kontinuerligt från Navet, antingen via SKV aviseringar, eller via onlineuppslag i de fall data inte ingår i aviseringar (exempelvis SNR).
Reservidentiteter (både nationella och lokala) tillförs PU-tjänsten via vården, och då antingen genom nyttjande av tjänstens administrativa GUI eller via integration och nyttjande av dess WS-gränssnitt i enlighet med RIV-TA [R7].
Observera
Denna guide avser enbart hur en aktör tar del av uppgifterna i PU-tjänsten genom s.k. "Lookup", vilket är realiserat i tjänstekontraktet: GetPersonsForProfile. Den är ej till som en detaljerad beskrivning av de ingående funktionerna och tjänstekontrakten, för detta se https://www.rivta.se/ för respektive domän och tjänstekontraktsbeskrivning (TKB) alternativt på tjänstens sida https://www.inera.se/personuppgiftstjansten
3. Förutsättningar PU
Man kan hämta personuppgifter från PU-tjänsten via ett webservice-gränssnitt (via tjänsteplattformen) eller via ett GUI i webbläsare.
3.1. Webservice gränssnitt
Webservice gränssnittet (WS) är till för de system som vill göra en integration där man hämtar personuppgifter till ett annat system. Detta alternativ kräver utveckling från konsumerande system.
Grundförutsättningar för att kunna nyttja WS-gränssnittet:
- Att konsumenten har ett klientcertifikat från SITHS.
- Att konsumenten har utvecklat anslutningen till Personuppgiftstjänsten enligt tjänstekontraktsbeskrivningen [R4]
- Att man är behörig beställare; endast regioner, kommuner, myndigheter och offentligt finaniserade privata vårdgivare är idag behöriga.
- Att man som konsument beställer access till tjänsten via tjänsteplattformen hos Inera, enligt stegen under "Beställ tjänst" på https://www.inera.se/personuppgiftstjansten
- Anslutning till REST-gränssnitten kräver dessutom extra behörighetsarbete. Se avsnittet Behörighet i dokumentet Filhantering för mer information.
3.2. Webb-GUI
Detta gränssnitt är till för personal som använder system som inte kan utveckla integration till webservicegränssnittet.
Grundförutsättningar för att kunna nyttja Webb-GUI:
- Att personen som ska nyttja GUI för PU har ett SITHS-kort,
- att personen även har minst ett tilldelat medarbetaruppdrag i HSA på VE-nivå. [R9] samt
- att personen har minst en av systemrollerna, se Instruktion för administrationsgränssnitt
4. Adresser/URL
4.1. Tjänstekontrakt
| Version | Adress | Beskrivning |
|---|---|---|
| 3.3 + 4.0 | https://bitbucket.org/rivta-domains/riv.strategicresourcemanagement.persons.person http://rivta.se/domains/strategicresourcemanagement_persons_person.html | Tjänstekontrakt Bitbucket Tjänstekontrakt RIV-TA |
4.2. Adresser för PU-tjänsten (Webservice)
Hur adressen till en tjänst ser ut beror på om anropet går via NTjP på Internet eller Sjunet (direktadressen är endast konsumerbar för NTjP)
- esb.ntjp.se - NTjP Internet
- esb.ntjp.sjunet.org - NTjP Sjunet
4.2.1. Miljö för konsumenter/NTjP
Version 3
Version 4 (tillgänglig fr.o.m 2022-11-08)
4.2.2. HSA-ID för PU-tjänst som producent
| Miljö | Producent HSA-ID |
|---|---|
| Produktion (ws.pu.inera.se) | SE5565594230-BJP |
| Test (ws.pu.ineratest.org), kallas "NTJP-QA" | T-SERVICES-SE165565594230-10T9 |
Att notera: NTJP-QA (T-SERVICES-SE165565594230-1023) agerar producent till NTJP-TEST (även kallad SIT, T-SERVICES-SE165565594230-109C) och skapar på så sätt en form av seriekoppling i TAK. Det ser med andra ord ut att finnas två publika, anslutningsbara testmiljöer för PU men innehållet i dessa är identiska och administreras i stor utsträckning av NMT (som nämnts i FAQ-avsnittet RADERAS: Test). Denna länk och bild tydliggör detta:
4.3. Adresser för PU-tjänsten (GUI)
| Miljö | URL |
|---|---|
| Produktion | https://pu.inera.se |
| Test | https://pu.ineratest.org |
5. IP-Adresser och portar
Denna del är till för att veta vilka portöppningar som krävs för att kunna nyttja PU-tjänsten.
5.1. Produktionsmiljö
DNS-namn | IP-adress | Port | Nät | Notering |
|---|---|---|---|---|
| pu.inera.se | 82.136.182.2 | 443 | Internet | GUI för PU-tjänsten |
| ws.pu.inera.se | 82.136.182.2 | 443 | Internet | Webservices SOAP |
| api.pu.inera.se | 82.136.182.2 | 443 | Internet | Webservices REST |
5.2. Testmiljö
DNS-namn | IP-adress | Port | Notering |
|---|---|---|---|
| pu.ineratest.org | 82.136.182.1 | 443 | GUI för PU-tjänsten |
| ws.pu.ineratest.org | 82.136.182.1 | 443 | Webservices SOAP |
| api.pu.ineratest.org | 82.136.182.1 | 443 | Webservices REST |
6. Referenser
Ref | Dokument ID | Dokument |
|---|---|---|
R1 | Release notes | |
R2 | Användarhandbok | |
R3 | SAD | |
| R4 | Tjänstekontraktsbeskrivning V 3.2 | http://rivta.se/domains/strategicresourcemanagement_persons_person.html |
R5 | N/A | |
| R6 | N/A | |
R7 | RIV TA 2.1 | |
R8 | RIV-Patientdatalagen i praktiken (PDLiP RIV, ARK_0033) | |
R9 | HSA-katalogen | https://www.inera.se/hsa Befintlig koppling till HSA-tjänsten nyttjas i den webbapplikation som finns för administration av stödtjänsterna. Stödtjänsten själv nyttjar inte HSA-tjänsten. Notera att RIV TA Tjänstekontrakt för HSA ska användas vid nya integrationer mot HSA, se även [B1], AB-4. |
R10 | Testrapport | |
R11 | Acceptanstestprotokoll |