Här beskrivs den administrativa processen för hur du blir kund och ansluter dig till Inera Personuppgiftstjänst (PU-tjänsten). Processen ser något olika ut beroende på vilken typ av anslutning du vill göra. En översikt över de olika typerna av anslutning ges nedan, och i efterföljande avsnitt beskrivs deras anslutningsprocess samt ytterligare information som är relevant vid anslutning till Personuppgiftstjänsten. Det finns även ett avsnitt som beskriver hur befintliga kunder genomför en versionsuppgradering.

Anslutningstyper

Här ges en översikt över de olika typerna av anslutning till Inera Personuppgiftstjänst.

• Direktanslutning
  En direktanslutning är den vanligaste formen av anslutning, och innebär att ni ansluter ett hos er installerat system mot Inera Personuppgiftstjänst. Anslutningsprocessen skiljer sig då något beroende på om ni har ett mellanlager såsom en integrationsplattform (Regional Tjänsteplattform) eller ej.

  • Direktanslutning utan något lokalt mellanlager hos er:
    
    

    Open

    

    Figur: Översiktligt diagram över hur en kund till Inera PU-tjänst direktansluter ett system som tjänstekonsument, utan lokalt mellanlager.
    
    

  • Direktanslutning via ett lokalt mellanlager hos er, såsom en regional tjänsteplattform eller annan integrationsplattform:
    
    

    Open

    

    Figur: Översiktligt diagram över hur en kund till Inera PU-tjänst direktansluter ett system som tjänstekonsument, via ett lokalt mellanlager.
    
    

• Leverantörsanslutning
  En leverantörsanslutning innebär att en leverantör av applikationer som installeras lokalt hos slutkunder möjliggör en integration mot Inera Personuppgiftstjänst, så att leverantörens kunder kan använda PU-funktionalitet i applikationen. Applikationsleverantören själv kommer då enbart att ansluta mot Personuppgiftstjänsten via Ineras Öppen Testmiljö. Slutkunderna, som installerar applikationen i sina egna miljöer, kommer var och en att genomgå anslutningsprocessen för Direktanslutning så som den beskrivs på denna sida.
  
  

• Agentanslutning
  En agentanslutning innebär att en applikationsleverantör för webbaserade tjänster (molntjänster) gör en integration mot Inera Personuppgiftstjänst, och att leverantörens kunder sedan erbjuds funktionalitet genom den integrationen. Applikationsleverantören blir då en Agent gentemot Inera Personuppgiftstjänst, och kunderna blir agentanslutna slutkunder.
  
  

  Figur: Översiktligt diagram över hur en Agent ansluter till Inera PU-tjänst, och hur en agentansluten slutkund kan nyttja funktionalitet hos PU-tjänsten via agentens applikation.

Anslutningsprocess för Direktanslutning

1. Bli kund hos Inera
   Teckna Ineras Kundavtal 2.
   
   

2. Utför lokala tester
   Gör vid behov tester lokalt i det anslutande systemets egen miljö, utan att någon anslutning mot Ineras testmiljö (NTjP QA-miljö) har etablerats. Lokala tester kan vara ett bra sätt att utföra proof-of-concept-tester innan ni beställer tjänsten eller ens blir kund hos Inera. Stöd för att utföra sådana tester finns i form av testsviter med tillhörande mock-tjänst för Personuppgiftstjänsten, vilken möjliggör simulerade slagningar mot PU-tjänsten utan anslutning mot Inera.
   
   Testsviter innehållandes testanvisning och tillhörande mock-tjänst för vart och ett av tjänstekontrakten finns i release-paketet.
   Exempel-sökvägar för tjänstekontraktet GetPersonsForProfile:
   Testanvisningen ligger i release-paketets fil \test-suite\GetPersonsForProfileMock\Testanvisning för tjänstekonsumenter av GetPersonsForProfile.html
   Installationsinstruktioner för Mock-tjänsten finns i release-paketets fil \test-suite\GetPersonsForProfileMock\GetPersonsForProfileMock-doc.html
   SoapUI projektfil för testsvitens anrop finns i release-paketets fil \test-suite\GetPersonsForProfile\GetPersonsForProfile-soapui-project.xml
   För övriga tjänstekontrakt, se deras respektive mappar enligt samma struktur.
   
   

3. Beställ tjänsten
   Beställ Personuppgiftstjänsten i Ineras Kundportal. Detta innebär att debitering av tjänsten påbörjas.
   
   Innan beställningen godkänns kommer förvaltningen av Inera PU-tjänst höra av sig till er och erbjuda ett uppstartsmöte, med följande agenda:
   1) Era syften med anslutning, och vilka av PU-tjänstens tjänstekontrakt och eventuellt REST-tjänster som då blir aktuella för er att ansluta till.
   2) Den administrativa processen fram till produktionssättning.
   3) Övergripande frågor om teknisk anslutning, dock inga tekniska detaljer.
   4) Kontaktvägar under pågående anslutningsprojekt.
   Uppstartsmötet kan på er begäran avvaras om följande två kriterier är uppfyllda: Ni är redan anslutna (TAK:ade) till de tjänstekontrakt ni behöver, och nyckelpersonerna som skall utföra anslutningsprocessen hos er har redan kunskap om hur detta går till för Inera PU-tjänst.
   
   Med mellanlager: Beställningen görs för varje konsumerande system, ej för mellanlagret.
   
   

4. Beställ eller utfärda SITHS funktionscertifikat
   Kommunikationen mellan anslutande system och Personuppgiftstjänsten sker via Nationella Tjänsteplattformen (NTjP). För att kunna identifiera sig mot NTjP behöver varje anslutande system ett SITHS funktionscertifikat, som kommer att innehålla unika HSA-id. Det anslutande systemet behöver ett sådant certifikat för anslutning via NTjP QA-miljö (för test) och ett ytterligare för NTjP Produktionsmiljö.
   
   Information om beställning av SITHS funktionssertifikat finns på SITHS-förvaltningens dokumentationssida.
   
   Med mellanlager: Både mellanlagret och varje bakomliggande system som skall använda Personuppgiftstjänsten behöver ha egna SITHS funktionscertifikat.
   
   

5. Anslut till tjänstens testmiljö
   Lägg beställning om anslutning (TAK:ning) mot Personuppgiftstjänstens testmiljö via NTjP QA-miljö. Detta görs i Ineras Beställningsstöd.
   
   Med mellanlager: Detta görs för mellanlagret, och behöver bara göras en gång (för samma tjänstekontrakt/version), oavsett hur många bakomliggande system som med tiden tillkommer.
   
   

6. Anslut till REST-tjänster i testmiljö
   Komplettera vid behov med ansökan om anslutning av REST-tjänster i Personuppgiftstjänstens testmiljö, via ett ärende till Inera.
   
   Med mellanlager: Normalt är det vart och ett av de konsumerande systemen, ej mellanlagret, som kommer att göra dessa anrop.
   
   

7. Utför QA-tester
   Utför tester i PU-tjänstens testmiljö, ansluten via NTjP QA, samt mot Mock-tjänst. Följ teststrategin, och redovisa resultaten genom att fylla i aktuella Självdeklarationer (SjD) samt ett End-2-End-underlag (E2E-underlag), vilka du kommer att bifoga när du senare ansöker om åtkomst till PU-tjänstens produktionsmiljö. Tester som involverar skrivningar av data får endast utföras mot testpersoner som är bokade för dig som kund, vilket du gör via Inera Test och Utveckling.
   
   Den övergripande Teststrategin finns som bilaga på dennna sida.
   Testanvisningar för respektive Tjänstekontrakt finns i releasepaketet i mapp test-suite, och undermapp med namn (Tjänstekontrakt)Mock. Filen heter Testanvisning(...).html.
   Självdeklarationer för vart och ett av tjänstekontrakten finns i release-paketet, och dessa tester görs primärt mot Mock-tjänsten.
   E2E-underlag för PU-tjänsten finns som bilaga på denna sida, och dessa tester görs mot NTjP QA.
   Läs om de olika delmängderna testpersoner i Inera Personuppgiftstjänst: Testpersoner
   Boka testpersoner med hjälp av Inera Test och Utveckling: Boka testpersoner
   
   Med mellanlager: Självdeklarationer görs i anslutningsprocessen för det det första bakomliggande systemet som anslutningen sätts upp för, och behöver sedan inte göras igen (för samma tjänstekontrakt/version), oavsett hur många fler bakomliggande system som med tiden tillkommer. Däremot behöver ni fylla i E2E-underlag för varje bakomliggande system.
   
   

8. Anslut till tjänstens produktionsmiljö
   Lägg beställning om anslutning (TAK:ning) mot Personuppgiftstjänsten via NTjP Prod-miljö. Detta görs i Ineras Beställningsstöd.
   Skicka sedan in Självdeklartioner samt E2E-underlag via formuläret "Dokument för granskning", och hänvisa till det ärendenummer (CSxxxxxx) som du fått när du lade beställningen om anslutning.
   
   Med mellanlager: Beställning om anslutning görs för mellanlagret, och behöver bara göras en gång (för samma tjänstekontrakt/version), oavsett hur många bakomliggande system som med tiden tillkommer. Det samma gäller för Självdeklarationer som endast behöver göras en gång för varje tjänstekontrakt, i samband med att det första bakomliggande systemet ansluts. Däremot behöver ni skicka in E2E-underlag för varje bakomliggande system och godkännande från Inera behövs innan nya bokomliggande system tas i drift mot PU-tjänstens produktionsmiljö.
   
   

9. Anslut till REST-tjänster i produktionsmiljö
   Komplettera vid behov med ansökan om anslutning av REST-tjänster i Personuppgiftstjänstens produktionsmiljö, via ett ärende till Inera.
   
   Med mellanlager: Normalt är det vart och ett av de konsumerande systemen, ej mellanlagret, som kommer att göra dessa anrop.

Anslutningsprocess för Leverantörsanslutning

En applikationsleverantör av lokalt installerade applikationer kan bygga in funktionalitet som kräver en integration mot Personuppgiftstjänsten. På så sätt får leverantörens slutkunder möjlighet att använda denna PU-funktionalitet. Slutkunderna måste var och en kvalificera sig som kunder till Inera samt uppfylla Personuppgiftstjänstens krav på anslutna kunder för att få ges tillgång till denna integration, och de genomgår varsin anslutningsprocess för Direktanslutning. Inera debiterar er som leverantör endast för er anslutning till Öppen Testmiljö, medan slutkunderna debiteras för sina respektive direktanslutningar enligt aktuell prislista.

1. Utför lokala tester
   Gör vid behov tester lokalt i leverantörens egen miljö, utan att någon anslutning mot Ineras Öppen Testmiljö (ÖTM) har etablerats. Lokala tester kan vara ett bra sätt att utföra proof-of-concept-tester innan ni blir kund hos Inera. Stöd för att utföra sådana tester finns i form av testsviter med tillhörande mock-tjänst för Personuppgiftstjänsten, vilken möjliggör simulerade slagningar mot PU-tjänsten utan anslutning mot Inera.
   
   

   Testsviter innehållandes testanvisning och tillhörande mock-tjänst för vart och ett av tjänstekontrakten finns i release-paketet för respektive domänversion.
   Exempel-sökvägar för tjänstekontraktet GetPersonsForProfile:
   Testanvisningen ligger i release-paketets fil \test-suite\GetPersonsForProfileMock\Testanvisning för tjänstekonsumenter av GetPersonsForProfile.html
   Installationsinstruktioner för Mock-tjänsten finns i release-paketets fil \test-suite\GetPersonsForProfileMock\GetPersonsForProfileMock-doc.html
   SoapUI projektfil för testsvitens anrop finns i release-paketets fil \test-suite\GetPersonsForProfile\GetPersonsForProfile-soapui-project.xml
   För övriga tjänstekontrakt, se deras respektive mappar enligt samma struktur.
   
   

2. Teckna avtal för och anslut till Öppen Testmiljö
   Som leverantör har ni inte möjlighet att få åtkomst till Ineras Nationella Tjänsteplattformen, och erbjuds istället åtkomst till Personuppgiftstjänstens testmiljö via Ineras plattform Öppen Testmiljö (ÖTM). Denna plattform förvaltas inte av Ineras förvaltningsgrupp för Personuppgiftstjänsten, utan av en specifik förvaltningsgrupp för just ÖTM. Det är via dem och ÖTM som ni kan få åtkomst till Personuppgiftstjänstens testmiljö.

   Läs mer om hur ni ansluter er till Öppen Testmiljö: Öppen testmiljö - Inera
   Där finns även kontaktväg till Ineras förvaltningsgrupp för ÖTM.
   
   

3. Utför tester
   Väl anslutna till Personuppgiftstjänsten via Öppen Testmiljö kan ni utföra tester mot tjänsten via denna plattform. Ni kommer nu även att ges möjlighet att, vid behov, ansluta till de REST-tjänster som Personuppgiftstjänsten erbjuder som komplement till tjänstekontrakten. Ni rekommenderas starkt att ha minst en slutkund som pilotkund, som kan verifiera funktionaliteten genom att de gör en Direktanslutning mot Nationella Tjänsteplattformen och integrerar sin instans av er applikation mot Personuppgiftstjänsten den vägen (först NTjP QA-miljö sedan Prod).
   
   

4. Slutkunder ansluter
   När ni som leverantör har verifierat att integrationen mot Personuppgiftstjänsten fungerar korrekt så kan ni erbjuda funktionaliteten till era slutkunder som ej varit pilotkunder. Var och en av slutkunderna behöver genomföra sin egen anslutningsprocess (Direktanslutning) och därmed sin egen testning av integrationen mot Personuppgiftstjänsten.

Anslutningsprocess för Agentansluten kund

Applikationsleverantörer kan göra funktionalitet hos Inera Personuppgiftstjänst tillgängliga via sin applikation. Leverantören kallas då för en Agent och kommer att instruera er att bli en Agentansluten kund hos Inera för att kunna nyttja denna funktionalitet, enligt följande steg. Inera debiterar Agenten för er anslutning, och det är upp till Agenten att prissätta denna anslutning gentemot er som slutkund.

1. Bli kund hos Inera
   Teckna Ineras Kundavtal 2.
   
   

2. Bli Agentansluten kund för Personuppgiftstjänsten
   Ni ansöker via Ineras Kundportalen att bli Agentansluten kund för Personuppgiftstjänsten och ni anger även att anslutningen gäller den specifika applikationsleverantören. Det är därmed möjligt att ha flera agentanslutningar samtidigt mot Personuppgiftstjänsten, via olika appliaktionsleverantörer.
   
   Läs mer om hur du ansöker om att ansluta via agent.

Anslutningsprocess för Agent

En applikationsleverantör kan bli Agent för Personuppgiftstjänsten, vilket möjliggör att leverera en applikation som har en integration mot Personuppgiftstjänsten som i sin tur kan nyttjas av slutkunder. Slutkunderna måste var och en kvalificera sig som kunder till Inera samt uppfylla Personuppgiftstjänstens krav på anslutna kunder för att få ges tillgång till denna integration. För att få bli Agent behöver ni ha med er två pilotkunder. Inera debiterar er som Agent baserat på era anslutna kunder och aktuell prislista, och ingen debitering sker från Inera direkt mot era slutkunder.

1. Teckna Agentavtal
   Det första steget är att ni som organisation tecknar Agentavtal med Inera, vilket reglerar affärsrelationen. I den delen av processen ingår att skicka in en förfrågan som granskas av Inera, följt av att ni signerar avtalet och får inloggningsuppgifter för er utsedda administratör.
   
   Läs mer om att teckna Agentavtal.
   
   

2. Ansök om Agentuppdrag
   Ansök sedan om att få ett Agentuppdrag för den specifika Inera-tjänsten, i detta fall Personuppgiftstjänsten. Detta gör ni i Kundportalen, efter att er administratör har tilldelat sådana roller. Ni kommer i er ansökan att behöva ange två pilotkunder som kommer att vara med och utföra tester av integrationen mot Personuppgiftstjänsten. 
   
   Läs mer om tilldelning av roller i Kundportalen samt ansökan om Agentuppdrag.
   
   

3. Utför teknisk anslutning och tester
   Följ processen för Direktanslutning ovan, från steg 4 "Beställ eller utfärda SITHS funktionscertifikat" och framåt. Det kommer att vara ni som Agent som ansluter er applikation mot Inera Personuppgiftstjänst, och därmed gör administrationen kring detta. Ni ansvarar även för att tester inför produktionssättning utförs, men använder er av verksamhetskunskaperna hos pilotkunderna för att utföra dessa tester.
   
   

4. Ytterligare kunder ansluter
   När ni är i drift kommer nya kunder att hitta er valbara som Agent för Personuppgiftstjänsten i Kundportalen, och kan den vägen beställa att de vill tillkomma som Agentansluten kund genom er integration.

Uppgradering av tjänstekontrakt

När nya versioner av tjänstekontrakt görs tillgängliga behöver ni som ansluten tjänstekonsument följa med i den uppgraderingen innan den gamla versionen avvecklas hos Inera. Detta påverkar alltså både direktanslutna, agenter och leverantörer. Läs även mer om tjänstekontraktsversionernas livscykel.

En uppgradering till ny tjänstekontraktversion innebär en form av nyanslutning gentemot Nationella Tjänsteplattformen (NTjP) vilket medför att testning ska göras.

Med utgångspunkt i den normala anslutningsprocessen för en nyanslutning så gäller följande vid specifikt uppgraderingar:

• Ni kan välja att genomföra ett uppstartsmöte med oss i PU-förvaltningen där vi går igenom uppgraderingsprocessen. Ni kan också välja att avstå ifrån ett uppstartsmöte om ni upplever att ni redan har god kännedom om processen. Väljer ni att ha ett uppstartsmöte så bokar ni ett sådant genom att kontakta PU-förvaltningen.

• Ni behöver inte beställa tjänsten igen.

• Ni behöver inte utfärda nya SITHS funktionscertifikat, utan fortsätter använde dem ni redan har.

• Ni beställer som vanligt anslutning till de nya versionerna av tjänstekontrakten i NTjP QA-miljö i Beställningsstödet. Om ni inte haft ett uppstartsmöte med PU-förvaltningen, skriv då en notering i beställningen om att detta gäller en uppgradering av version för en befintlig anslutning. Tänk på att om ni ansluter via ett mellanlager, såsom en Regional Tjänsteplattform, så kan ni inte göra uppgraderingsprocessen för mellanlagret, utan processen görs för det aktuella bakomliggande system som har behov av det nya kontraktet.

• Ni utför precis som vanligt tester enligt Testanvisningar för respektive tjänstekontrakt, och redovisar dessa i Självdeklarationer samt End-2-End-underlag.

• Ni beställer precis som vanligt anslutning till de nya versionerna av tjänstekontrakten i NTjP Produktions-miljö i Beställningsstödet.

• Om ni använder REST-tjänster behöver ni inte ansöka om åtkomst till nya versioner av dessa, utan där följer behörigheten med i alla tillgängliga versioner.

Övriga verktyg

Verifiering via PU GUI

Vid behov kan ni under anslutningsprocessen använda Ineras administrationsgränssnitt PU GUI, som är lämpligt för verifieringar av vilken data som finns i Personuppgiftstjänsten samt hantering av testpersoner.

• För åtkomst krävs SITHS-kort samt specifika behörigheter i HSA-katalogen.

• Inloggning i gränssnittet:

  • Testmiljö: https://pu.ineratest.org,

  • Produktionsmiljö: https://pu.inera.se

Valideringspersoner i produktionsmiljö

Inera Test och Utveckling förvaltar en uppsättning Valideringspersoner i Produktion (VIP), vilket är personposter som ligger i Inera PU-tjänst produktionsmiljö men som inte tillhör faktiska personer utan kan användas för valideringar som ej kunde hanteras genom testning i testmiljö. Observera att ni aldrig får göra ändringar i dessa valideringspersoner eller koppla dem till andra identiteter.

Se fullständig information om valideringspersonerna, där viktiga riktlinjer även står.

Stöd och kontaktvägar

Om ni behöver komma i kontakt med Inera under anslutningsprocessen gör ni det via kontaktvägarna nedan, utifrån vad ärendet gäller. Ni anger i kontaktformulären att det gäller ”Personuppgiftstjänsten”.

Bilagor

Följande dokument refereras till på denna sida som berör anslutningsprocessen.