Før man kan ta i bruk VKP for en VFT i kommunen må man søke om tilgang. Dette gjøres ved å benytte HelseID selvbetjening og fullføre prosessen som heter “Ta i bruk HelseID”. Når denne prosessen er fullført og tilgangen er godkjent vil kommunen få tilgang til konfigurasjonsfiler som skal benyttes av VFT-en for kommunikasjon med VKP sine API-er.
Steg 1 - Pålogging
Logg inn på HelseID selvbetjening og velg organisasjonen du ønsker å representere. Dersom kommunen ikke vises i oversikten mangler du tilgang til å representere kommunen og du må få delegert tilgang. Veiledning for dette finnes hos HelseID og heter Delegering av tilgang til HelseID Selvbetjening.
Steg 2 - Oppdatering av kontaktinformasjon
Dersom dette er første gang du logger på kan du bli bedt om å oppdatere kontaktinformasjonen din. Det er også mulig å endre kontaktinformasjon senere ved å klikke på navnet sitt øverst på tittellinjen.
Her må du fylle inn e-postadresse og telefonnummer slik at HelseID kan ta kontakt ved behov. Du vil motta varsel med passord for konfigurasjoner på dette telefonnummeret.
Klikk på Lagre for å gå videre.
Steg 3 - Startside / dashboard
Startsiden i HelseID Selvbetjening kan se annerledes ut avhengig av hvilket tilgangsnivå man har.
For å kunne ta i bruk VFT i kommunen trenger man valget “Ta i bruk HelseID”. Dersom dette valget mangler må man få delegert tilgang til dette som nevnt i steg 1.
Steg 4 - Ta i bruk HelseID
“Ta i bruk HelseID” viser en oversikt over alle konfigurasjoner som er opprettet / godkjent. For å konfigurere en ny VFT slik at denne kan ta i bruk VKP må man opprette en ny konfigurasjon, og dette gjøres ved å trykke på “Ny konfigurasjon”.
Steg 5 - Ny konfigurasjon
HelseID kan benyttes til mange ulike systemer, og man kan enklere få en oversikt over tilgjengelige VFT-er ved å krysse av for kun VFT under “Filtrer på type fagsystem”.
Dersom fagsystemet ikke er listet opp i oversikten så har ikke leverandør registrert seg hos HelseID.
Velg korrekt fagsystem og klikk på “Gå videre” for å fortsette.
Steg 6 - Tjenester
Når korrekt VFT fagsystem er valgt skal må man videre krysse av for at man ønsker å benytte VKP. I tillegg må man spesifisere hvilken deler av tjenesten man ønsker å benytte, for eksempel nhn:vkp/api/user/patient.read. I tillegg må verdi for nhn:vkp/client/claims/vkp-id fylles ut i henhold til navnekonvensjon som beskrevet over.
Leverandør av fagsystem / VFT skal vite hvilke deler av tjenesten som skal benyttes.
Av sikkerhetshensyn er det anbefalt å ikke velge flere deler/tjenester enn man har behov for.
Steg 7 - Valgfri beskrivelse
Oppgi en valgfri beskrivelse av konfigurasjonen. Denne vises i oversikten over konfigurasjoner.
Steg 8 - Bekreft konfigurasjonen
Fyll inn e-postadresse for varslinger fra HelseID.
E-post for varsling skal ikke være personlig e-post. Dette er fordi varsel vil bli sendt til denne adressen når konfigurasjonen må oppdateres.
Steg 9 - Laste ned konfigurasjonen
Nå kan konfigurasjonen lastes ned og videreformidles til leverandør av VFT-en, men må godkjennes av tjenesteleverandør for den kan benyttes.
Nøkkelparet i konfigurasjonen har en levetid på to år og må oppdateres før denne går ut. Det er mulig å opprette et nytt nøkkelpar før det andre går ut.
For å laste ned nøkkelparet klikker man på “Flere handlinger” og deretter “Last ned konfigurasjonsfil”. Da vil det lastes ned en passordbeskyttet zip-fil som kan benyttes til konfigurasjon av VFT-løsningen.
Passord sendes til telefonnummeret som er angitt under kontaktinformasjonen. Zip-filen kan ikke åpnes med den innebygde støtten i Windows - det må benyttes et annet verktøy, for eksempel 7-zip, WinZip, WinRAR med flere.
Konfigurasjonen vil ikke fungere før den er blitt godkjent av VKP-teamet i NHN.