Integration mot Personuppgiftstjänsten
- Former user (Deleted)
- Jimmy Fridh
- Former user (Deleted)
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 | 29 feb. 2016 | Skapar dokument | |
0.2 | 1 apr. 2016 | Uppdaterat med v1.1 kontrakt | |
1.0 | 30 aug. 2016 | Fastställd | |
1.1 | 22 nov. 2016 | Uppdaterat TP adresser | |
1.2 | 13 juni 2017 | Uppdaterad för PU 3.0 | |
1.3 | 29 juni 2018 | Information om deprikerade tjänstekontrakt | |
1.4 | 17 okt. 2018 | Länkar korrigerade, förtydligande (beställning, kontrakt, rivta mm) | |
2.0 | 3 apr. 2019 | Anpassad för PU 4 | |
2.1 | 3 apr. 2019 | Uppdaterad vid implementation av UnrestrictedContactInfo | |
2.2 | 20 apr. 2020 | Information om kontrakt i domänversioner 1 och 2 rensade | |
2.3 | 9 sep. 2021 | Rensat och skrivit om information om WS anslutning och GUIt | |
2.4 | 17 jan. 2022 | Anpassad till version 4.7 där REST-tjänsterna fått ny adress | |
2.5 | 4 apr. 2023 | Ny IP för testmiljö | |
3.0 | 28 juni 2023 | @Jimmy Fridh | Ombearbetning för att vara riktad mot tekniker och beskriva den tekniska information som behövs för integration mot Personuppgiftstjänsten. |
4.0 | Feb 28, 2024 | @Jimmy Fridh | Införande av domänversion 5. Förtydligande av tjänstekontraktsversionernas relation till domänversion och ombearbetning av tabeller. Renodling av sidans syfte till integrationsinformation. |
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å Personuppgiftstjänsten
Anslutning till REST-gränssnitten kräver dessutom extra behörighetsarbete. Se avsnittet Behörighet i dokumentet REST-tjänster för 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
Adress | Beskrivning |
|---|---|
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 från Internet eller Sjunet
esb.ntjp.se - NTjP Internet
esb.ntjp.sjunet.org - NTjP Sjunet
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 |
Adresser för PU GUI (det grafiska gränssnittet till PU-tjänsten)
Miljö | URL |
|---|---|
Produktion | |
Test |
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 | I | Port | Nät | Notering |
|---|---|---|---|---|
82.136.182.28 | 443 | Internet | GUI för PU-tjänsten | |
82.136.182.28 | 443 | Internet | Webservices REST |
Testmiljö
DNS-namn | IP-adress | Port | Notering |
|---|---|---|---|
82.136.182.17 | 443 | GUI för PU-tjänsten | |
82.136.182.17 | 443 | Webservices REST |
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 | 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 |
|