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.

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:
    
    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:
    
    Figur: Översiktligt diagram över hur en kund till Inera PU-tjänst direktansluter ett system som tjänstekonsument, via ett lokalt mellanlager.
    
    
• Agentanslutning
  En agentanslutning innebär att en applikationsleverantör 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.
   
   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.
   OBS! För närvarande gäller begränsningar för beställningar av SITHS funktionscertifikat för testmiljö, på grund av en större uppdatering av SITHS; se nyhet om reservrutin.
   
   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), 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 e-post till Inera Kundservice.
   
   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. 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 hos Inera NMT.
   
   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.
   E2E-underlag för PU-tjänsten finns som bilaga på denna sida.
   Läs om de olika delmängderna testpersoner i Inera Personuppgiftstjänst: Testpersoner
   Boka testpersoner med hjälp av Inera NMT: Boka testpersoner
   
   Med mellanlager: Detta görs för varje konsumerande system bakom mellanlagret. 
   
   
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 (TFF-xxxxxx) 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. Självdeklaration samt E2E-underlag skickas dock in 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 e-post till Inera Kundservice.
   
   Med mellanlager: Normalt är det vart och ett av de konsumerande systemen, ej mellanlagret, som kommer att göra dessa anrop.

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.

Ö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 NMT 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.