Innehåll

Dokumentinformation

Inledning

Detta dokument ska redovisa den tekniska information som behövs vid integration mot Personuppgiftstjänsten.

Målgrupp

Målgruppen som detta dokument vänder sig till är tekniker som som avser att ansluta applikationer/system till PU-tjänsten samt användare som vill använda Webb-GUI:t för att hämta personuppgifter.

Revisionshistorik


Version

Datum

Författare

Kommentar

0.1

 

Skapar dokument
0.2
 
Uppdaterat med v1.1 kontrakt
1.0

 

Fastställd
1.1

 

Uppdaterat TP adresser
1.2

  

Uppdaterad för PU 3.0
1.3

 

Information om deprikerade tjänstekontrakt
1.4

 

Länkar korrigerade, förtydligande (beställning, kontrakt, rivta mm)
2.0

Anpassad för PU 4
2.1

Uppdaterad vid implementation av UnrestrictedContactInfo
2.2

 

Information om kontrakt i domänversioner 1 och 2 rensade
2.3

 

Rensat och skrivit om information om WS anslutning och GUIt
2.4

 

Anpassad till version 4.7 där REST-tjänsterna fått ny adress

2.5

 

Ny IP för testmiljö

3.0

 

Ombearbetning för att vara riktad mot tekniker och beskriva den tekniska information som behövs för integration mot Personuppgiftstjänsten.




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].

Förutsättningar PU

Man kan hämta personuppgifter från PU-tjänsten genom integration mot tjänstekontrakt via Ineras Nationella Tjänsteplattform (NTjP) eller via ett GUI i webbläsare.

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.

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

Adresser/URL

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

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)

  1. esb.ntjp.se - NTjP Internet
  2. esb.ntjp.sjunet.org - NTjP Sjunet

Miljö för konsumenter/NTjP

Version 3


Version 

Adress - domänversion 3.x

Test
3.3

https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetFilesForOrderId/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetFilesForOrderId/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonContactInformation/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonContactInformation/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonContactInformationUnrestricted/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonContactInformationUnrestricted/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfile/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfile/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfileUnrestricted/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfileUnrestricted/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/LinkPersonIdentity/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/LinkPersonIdentity/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrder/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrder/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrderUnrestricted/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrderUnrestricted/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfile/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfile/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileUnrestricted/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileUnrestricted/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/UnlinkPersonIdentity/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/UnlinkPersonIdentity/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/UpdatePersonContactInformation/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/UpdatePersonContactInformation/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/UpdatePersonContactInformationUnrestricted/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/UpdatePersonContactInformationUnrestricted/3/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/UpdatePerson/3/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/UpdatePerson/3/rivtabp21

Produktion
3.3

https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetFilesForOrderId/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetFilesForOrderId/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonContactInformation/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonContactInformation/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonContactInformationUnrestricted/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonContactInformationUnrestricted/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfile/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfile/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfileUnrestricted/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfileUnrestricted/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/LinkPersonIdentity/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/LinkPersonIdentity/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrder/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrder/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrderUnrestricted/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrderUnrestricted/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfile/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfile/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileUnrestricted/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileUnrestricted/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/UnlinkPersonIdentity/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/UnlinkPersonIdentity/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/UpdatePersonContactInformation/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/UpdatePersonContactInformation/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/UpdatePersonContactInformationUnrestricted/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/UpdatePersonContactInformationUnrestricted/3/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/UpdatePerson/3/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/UpdatePerson/3/rivtabp21





Version 4 (tillgänglig fr.o.m 2022-11-08)


Version 

Adress - domänversion 4.x

Test
4.0

https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfile/4/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfile/4/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfileUnrestricted/4/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfileUnrestricted/4/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrder/4/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrder/4/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrderUnrestricted/4/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrderUnrestricted/4/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfile/4/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfile/4/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileUnrestricted/4/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileUnrestricted/4/rivtabp21


https://qa.esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/UpdatePerson/4/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/UpdatePerson/4/rivtabp21

Produktion
4.0

https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfile/4/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfile/4/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfileUnrestricted/4/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/GetPersonsForProfileUnrestricted/4/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrder/4/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrder/4/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrderUnrestricted/4/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileByOrderUnrestricted/4/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfile/4/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfile/4/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileUnrestricted/4/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/SearchPersonsForProfileUnrestricted/4/rivtabp21


https://esb.ntjp.se:443/vp/strategicresourcemanagement/persons/person/UpdatePerson/4/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/strategicresourcemanagement/persons/person/UpdatePerson/4/rivtabp21







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


(warning) 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:


Adresser för PU-tjänsten (GUI)

MiljöURL
Produktionhttps://pu.inera.se  
Testhttps://pu.ineratest.org


IP-Adresser och portar

Denna del är till för att veta vilka portöppningar, utöver vad som krävs av NTjP, som behövs för att kunna nyttja PU-tjänsten.

Produktionsmiljö

DNS-namn

IP-adressNY IPPort

Nät

Notering

pu.inera.se82.136.182.282.136.182.28443InternetGUI för PU-tjänsten
api.pu.inera.se82.136.182.282.136.182.28443InternetWebservices REST


Testmiljö

DNS-namn

IP-adressPort

Notering

pu.ineratest.org82.136.182.17443GUI för PU-tjänsten
api.pu.ineratest.org82.136.182.17443Webservices REST


Referenser

Ref

Dokument ID

Dokument

R1

Release notes

 4.3 Release Notes

R2

Användarhandbok

 Användarhandbok

R3

SAD

 SAD (INTERN)

R4Tjänstekontraktsbeskrivning V 3.2http://rivta.se/domains/strategicresourcemanagement_persons_person.html

R5

N/A
R6N/A

R7

RIV TA 2.1

http:/www.rivta.se

R8

RIV-Patientdatalagen i praktiken (PDLiP RIV, ARK_0033)

http://rivta.se/documents/ARK_0031/

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