1. Dokumentinformation
1.1. 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.
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
Version | Datum | Författare | Kommentar |
|---|---|---|---|
| 1.1 |
| Uppdaterad för 2.1 |
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 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.
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, 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:
- Att konsumenten har ett klientcertifikat från SITHS.
- Att konsumenten har utvecklat anslutningen till PU enligt tjänstekontraktsbeskrivningen: https://bitbucket.org/rivta-domains/riv.masterdata.citizen.citizen
- Att man som konsument beställer access till tjänsten du vill nyttja via tjänsteplattformen hos Inera.
- Se här för anslutning av konsument (B-blankett): http://www.inera.se/TJANSTER--PROJEKT/ICC-Integration-Competence-Center/Anslutning-till-Tjansteplattformen/Anslutning-av-konsument---Bestallning-B/
- Se här för för att etablera samverkan med producent (D-blankett): http://www.inera.se/TJANSTER--PROJEKT/ICC-Integration-Competence-Center/Anslutning-till-Tjansteplattformen/Etablera-samverkan---Bestallning-D/
3.2. 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".
4. Adresser/URL
4.1. Tjänstekontrakt
| Version | Adress | Beskrivning |
|---|---|---|
| 2.1 | https://bitbucket.org/rivta-domains/riv.masterdata.citizen.citizen | Tjänstekontrakt Rivta, Bitbucket. |
| 1.1 | https://bitbucket.org/rivta-domains/riv.population.residentmaster | Tjänstekontrakt Rivta, Bitbucket. |
4.2. Adresser för PU-tjänsten (Webservice)
Hur adressen till en tjänst ser ut beror på följande saker:
- Miljö
- Om anropet går via Tjänsteplattformen eller ej
Anropen till PU från Tjänsteplattformen går alltid via Sjunet.
4.2.1. 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 |
4.2.2. 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.1 | https://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.1 | https://esb.ntjp.se:443/vp/LookupResidentForFullProfile/1/rivtabp21 |
4.2.3. 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 |
4.3. Adresser för PU-tjänsten (GUI)
| Miljö | URL från Sjunet | URL från internet |
|---|---|---|
| Acctest | http://acctest.pu.sjunet.org/ | http://acctest.pu.inera.se/ |
| Produktion | http://pu.sjunet.org/ | http://pu.inera.se/ |
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 | 164.40.180.104 | 80 | Internet | GUI för PU-tjänsten |
| sakerhetstjanst.inera.se | 164.40.177.103 | 443 | Internet | GUI för PU-tjänsten/Säkerhetstjänster |
idp2.sakerhetstjanst.inera.se | 164.40.177.104 | 443 | Internet | Autentisering av användare (GUI) |
secure.idp2.sakerhetstjanst.inera.se | 164.40.177.105 | 443 | Internet | Autentisering av användare (GUI) |
| ws.sakerhetstjanst.inera.se | 164.40.177.106 | 443 | Internet | Webservices |
| pu.sjunet.org | 81.89.154.139 | 80 | Sjunet | GUI för PU-tjänsten |
sakerhetstjanst.sjunet.org | 81.89.154.98 | 443 | Sjunet | GUI för PU-tjänsten/Säkerhetstjänster |
idp2.sakerhetstjanst.sjunet.org | 81.89.154.99 | 443 | Sjunet | Autentisering av användare (GUI) |
| secure.idp2.sakerhetstjanst.sjunet.org | 81.89.154.100 | 443 | Sjunet | Autentisering av användare (GUI) |
| ws.sakerhetstjanst.sjunet.org | 81.89.154.101 | 443 | Sjunet | Webservices |
5.2. Acceptanstestmiljö
DNS-namn | IP-adress | Port | Nät | Notering |
|---|---|---|---|---|
| acctest.pu.inera.se | 164.40.180.102 | 80 | Internet | GUI för PU-tjänsten |
| acctest.sakerhetstjanst.inera.se | 164.40.177.111 | 443 | Internet | GUI för PU-tjänsten/Säkerhetstjänster |
idp2.acctest.sakerhetstjanst.inera.se | 164.40.177.112 | 443 | Internet | Autentisering av användare (GUI) |
secure.idp2.acctest.sakerhetstjanst.inera.se | 164.40.177.113 | 443 | Internet | Autentisering av användare (GUI) |
| ws.acctest.sakerhetstjanst.inera.se | 164.40.177.114 | 443 | Internet | Webservices |
| acctest.pu.sjunet.org | 81.89.154.133 | 80 | Sjunet | GUI för PU-tjänsten |
acctest.sakerhetstjanst.sjunet.org | 81.89.154.114 | 443 | Sjunet | GUI för PU-tjänsten/Säkerhetstjänster |
idp2.acctest.sakerhetstjanst.sjunet.org | 81.89.154.115 | 443 | Sjunet | Autentisering av användare (GUI) |
| secure.idp2.acctest.sakerhetstjanst.sjunet.org | 81.89.154.116 | 443 | Sjunet | Autentisering av användare (GUI) |
| ws.acctest.sakerhetstjanst.sjunet.org | 81.89.154.117 | 443 | Sjunet | Webservices |
6. 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 |
| R5 | Tjänstekontraktsbeskrivning V 1.1 | https://bitbucket.org/rivta-domains/riv.population.residentmaster |
R6 | RIV TA 2.1 | |
R7 | RIV PDLiP | |
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 | |
R12 | RIV TA Referensapplikation Microsoft |