2.1 Guide till Personuppgiftstjänsten

Dokumentinformation

Inledning

Detta dokument ska hjälpa till att beskriva vad leveransen av PU-tjänsten 2.1 består av inklusive en kort beskrivning av hur man kan använda tjänsten.

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.

Revisionshistorik

Version

Datum

Författare

Kommentar

1.1

 

Uppdaterad för 2.1

Beskrivning

Den Nationella PU-tjänsten är en personuppgiftstjänst där man kan hämta personuppgifter för någon genom deras personnummer eller samordningsnummer. PU-tjänsten prenumererar på personuppgifter från Navet (Skatteverket) och cache:ar personuppgifterna i ett mellanlager för att minska kostnader och öka tillgänglighet för personuppgifterna. Uppgifter som om person som inte aviseras hämtas via online-slagning mot Navet då konsument efterfrågar personen.

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.

Webservice gränssnitt

Webservice gränssnittet (WS) är till för de system som vill göra en integration, dvs att 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:

Webb-GUI

Detta gränssnitt är till för personal som använder system som inte kan utveckla integration till webservice grä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 ett medarbetaruppdrag i HSA på VE-nivå.
  • Att personen har systemrollen "PU;Sökning".

Adresser/URL

Tjänstekontrakt

Version

Adress

Beskrivning

2.1https://bitbucket.org/rivta-domains/riv.masterdata.citizen.citizenTjänstekontrakt Rivta, Bitbucket.
1.1https://bitbucket.org/rivta-domains/riv.population.residentmasterTjänstekontrakt Rivta, Bitbucket.

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

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

  1. Miljö
  2. Om anropet går via Tjänsteplattformen eller ej

Anropen till PU från Tjänsteplattformen går alltid via Sjunet.

Miljö för konsumenter på Sjunet

Version

Adress via tjänsteplattform

Adress direkt
AccTest
2.1

https://qa.esb.ntjp.sjunet.org:443/vp/masterdata/citizen/citizen/LookupResidentsForProfile/2/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/masterdata/citizen/citizen/SearchResidentsForProfile/2/rivtabp21

https://qa.esb.ntjp.sjunet.org:443/vp/masterdata/citizen/citizen/GetFilesForOrderId/2/rivtabp21

N/A

https://ws.acctest.sakerhetstjanst.sjunet.org:443/masterdataCitizenCitizenService/LookupResidentsForProfile/2/rivtabp21

https://ws.acctest.sakerhetstjanst.sjunet.org:443/masterdataCitizenCitizenService/SearchResidentsForProfile/2/rivtabp21

https://ws.acctest.sakerhetstjanst.sjunet.org:443/masterdataCitizenCitizenService/GetFilesForOrderId/2/rivtabp21

https://ws.acctest.sakerhetstjanst.sjunet.org:443/pudownload/file/<GUID> (unik contextpath per fil)

1.1

https://qa.esb.ntjp.sjunet.org:443/vp/LookupResidentForFullProfile/1/rivtabp21

https://ws.acctest.sakerhetstjanst.sjunet.org:443/populationResidentmasterService/LookupResidentForFullProfile/1/rivtabp21
Produktion
2.1

https://esb.ntjp.sjunet.org:443/vp/masterdata/citizen/citizen/LookupResidentsForProfile/2/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/masterdata/citizen/citizen/SearchResidentsForProfile/2/rivtabp21

https://esb.ntjp.sjunet.org:443/vp/masterdata/citizen/citizen/GetFilesForOrderId/2/rivtabp21

N/A

https://ws.sakerhetstjanst.sjunet.org:443/masterdataCitizenCitizenService/LookupResidentsForProfile/2/rivtabp21

https://ws.sakerhetstjanst.sjunet.org:443/masterdataCitizenCitizenService/SearchResidentsForProfile/2/rivtabp21

https://ws.sakerhetstjanst.sjunet.org:443/masterdataCitizenCitizenService/GetFilesForOrderId/2/rivtabp21

https://ws.sakerhetstjanst.sjunet.org:443/pudownload/file/<GUID> (unik contextpath per fil)

1.1

https://esb.ntjp.sjunet.org:443/vp/LookupResidentForFullProfile/1/rivtabp21

https://ws.sakerhetstjanst.sjunet.org:443/populationResidentmasterService/LookupResidentForFullProfile/1/rivtabp21



Miljö för konsumenter på Internet

Nationella PU-tjänsten finns enbart direktåtkomlig på SJUNET. För åtkomst via internet används den nationella tjänsteplattformen.

Version

Adress via tjänsteplattform

AccTest
2.1

https://qa.esb.ntjp.se:443/vp/masterdata/citizen/citizen/LookupResidentsForProfile/2/rivtabp21

https://qa.esb.ntjp.se:443/vp/masterdata/citizen/citizen/SearchResidentsForProfile/2/rivtabp21

https://qa.esb.ntjp.se:443/vp/masterdata/citizen/citizen/GetFilesForOrderId/2/rivtabp21

1.1https://qa.esb.ntjp.se:443/vp/LookupResidentForFullProfile/1/rivtabp21
Produktion
2.1

https://esb.ntjp.se:443/vp/masterdata/citizen/citizen/LookupResidentsForProfile/2/rivtabp21

https://esb.ntjp.se:443/vp/masterdata/citizen/citizen/SearchResidentsForProfile/2/rivtabp21

https://esb.ntjp.se:443/vp/masterdata/citizen/citizen/GetFilesForOrderId/2/rivtabp21

1.1https://esb.ntjp.se:443/vp/LookupResidentForFullProfile/1/rivtabp21

HSA-ID för PU-tjänst som producent

MiljöProducent HSA-ID
Produktion (ws.sakerhetstjanst.sjunet.org)SE5565594230-B9D
AccTest (ws.acctest.sakerhetstjanst.sjunet.org)T_SERVICES_SE165565594230-1097



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


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.

Produktionsmiljö

DNS-namn

IP-adressPort

Nät

Notering

pu.inera.se164.40.180.10480InternetGUI för PU-tjänsten
sakerhetstjanst.inera.se164.40.177.103443InternetGUI för PU-tjänsten/Säkerhetstjänster

idp2.sakerhetstjanst.inera.se

164.40.177.104443

Internet

Autentisering av användare (GUI)

secure.idp2.sakerhetstjanst.inera.se

164.40.177.105443

Internet

Autentisering av användare (GUI)

ws.sakerhetstjanst.inera.se164.40.177.106443InternetWebservices
pu.sjunet.org81.89.154.13980SjunetGUI för PU-tjänsten

sakerhetstjanst.sjunet.org

81.89.154.98443

Sjunet

GUI för PU-tjänsten/Säkerhetstjänster

idp2.sakerhetstjanst.sjunet.org

81.89.154.99443

Sjunet

Autentisering av användare (GUI)

secure.idp2.sakerhetstjanst.sjunet.org81.89.154.100443SjunetAutentisering av användare (GUI)
ws.sakerhetstjanst.sjunet.org81.89.154.101443SjunetWebservices


Acceptanstestmiljö

DNS-namn

IP-adressPort

Nät

Notering

acctest.pu.inera.se164.40.180.10280InternetGUI för PU-tjänsten
acctest.sakerhetstjanst.inera.se164.40.177.111443InternetGUI för PU-tjänsten/Säkerhetstjänster

idp2.acctest.sakerhetstjanst.inera.se

164.40.177.112443

Internet

Autentisering av användare (GUI)

secure.idp2.acctest.sakerhetstjanst.inera.se

164.40.177.113443

Internet

Autentisering av användare (GUI)

ws.acctest.sakerhetstjanst.inera.se164.40.177.114443InternetWebservices
acctest.pu.sjunet.org81.89.154.13380SjunetGUI för PU-tjänsten

acctest.sakerhetstjanst.sjunet.org

81.89.154.114443

Sjunet

GUI för PU-tjänsten/Säkerhetstjänster

idp2.acctest.sakerhetstjanst.sjunet.org

81.89.154.115443

Sjunet

Autentisering av användare (GUI)

secure.idp2.acctest.sakerhetstjanst.sjunet.org81.89.154.116443SjunetAutentisering av användare (GUI)
ws.acctest.sakerhetstjanst.sjunet.org81.89.154.117443SjunetWebservices



Referenser

Ref

Dokument ID

Dokument

R1

Releasenotes


R2

Användarhandbok


R3

SAD


R4

Tjänstekontraktsbeskrivning V 2.0

https://bitbucket.org/rivta-domains/riv.masterdata.citizen.citizen

R5Tjänstekontraktsbeskrivning V 1.1https://bitbucket.org/rivta-domains/riv.population.residentmaster

R6

RIV TA 2.1

http:/www.rivta.se

R7

RIV PDLiP

http://www.inera.se/

R8

HSA-katalogen

http://www.inera.se/ 

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 är under utveckling och ska användas vid nya integrationer mot HSA, se även [B1], AB-4.

R9

Testrapport


R10

Acceptanstestprotokoll


R11

RIV TA Referensapplikation -Java

http://www.rivta.se

R12

RIV TA Referensapplikation Microsoft

http://www.rivta.se