Målgruppe og målsetning med beskrivelsen
Målgruppen er systemleverandører som skal utvikle en integrasjon mot en Helsenorgetjeneste.
Målsetting med dette er å beskrive hva som må gjøres for å etablere utviklings- og testmiljø mot HN for å kunne utvikle integrasjon og få godkjent løsningen.
Etablere testaktør
Forutsetninger for oppkobling
Aktør har avtale om oppstart, og mottatt lenke til dokumentasjon om løsningen fra NHN.
I avtale om oppstart inngår:
Hvordan få tilgang til ressurser som kan bistå ved evt. spørsmål (Slack).
Avtale om testdata og testmiljø
Leverandørene må sette seg inn i, og forstå løsningen.
God kjennskap til PKI i offentlig sektor. (Public Key Infrastructure, offentlig-nøkkel-infrastruktur)
Leverandør må være godkjent og medlem i helsenettet og ha tilgang til Adresseregisteret = AR.test. Dersom det er behov for en ny Virksomhet i AR kan dette bestilles til formålet, dette vil ta noen dager.
Gyldig test.virksomhetssertifikat.
Ved integrasjon til HN.miljøer i forbindelse med utvikling og godkjenning av ny funksjonalitet i integrasjonspart, er det et krav at denne er tilkoblet i minst ett miljø som NHN også har tilgang til.
NB! Behovet for NHNs tilgang til minst 1 ende-til-ende miljø vil vedvare etter at løsningen er i produksjon. Dette for å kunne regresjonsteste ved nye versjoner av enten integrasjonspart eller Helsenorge
Bruk av alle miljøer koordineres med NHN. All oppkobling og bruk av miljøene skal avtales på forhånd.
Kommunikasjon under utvikling
Kommunikasjon og spørsmål om bistand ved etablering av test, foregår i egen Slack-kanal som opprettes av NHN i forbindelse med oppstart. Dette sikrer transparent kommunikasjon og at alle interessenter blir informert.
Slack-kanalen #ext-utv-hn-miljøstatus brukes til å informere om HN miljøenes tilstand. Nedetid pga. deployment eller annet, informeres om her.
Testmiljøer
Helsenorges miljøoversikt viser integrasjonsmiljøer og kort forklaring på bruk og oppetid.
Det må avtales hvilke miljøer som kan benyttes til gjennomføring av ulike tester
Brøytekjøring og aktørens e2e verdikjedetest samt regresjonstest
Ytelsestest
evt. behov for test av miljøendring/”staging”
Adresseregisteret:
For kommunikasjon mot HN må aktør være opprettet i AR med følgende opplysninger:
HER-id (tildeles når organisasjonen legges inn i AR) Nivå 1 - virksomhet.
Navn på virksomheten
Virksomhetstype
Sertifikatinformasjon (virksomhetssertifikat)
Minst en kommunikasjonspart (person eller tjeneste) på Nivå2.
Med aktuelle kommunikasjonsprosesser - se ulike CPP oppsett
(Det er alltid kommunikasjonspartens HER-id som skal benyttes ved kommunikasjon, ikke virksomheten sin HER-id eller org.nr)
Kommunikasjonspart (Fastlege eller tjeneste) opprettes etter avtale av NHN eller aktør.
Steg-for-steg etablering av testmiljø
Aktør melder inn ønske om tilgang til testmiljø hos NHN.
For XDS oppkobling:
NHN må bestille brannmur-åpning mot aktørens endepunkt IP+portnr. (bestilles internt på #Drift helsenorge)
Aktør må bestille tilsvarende brannmuråpning internt for kommunikasjon fra HN (HN.endepunkter får vi også fra #Drift helsenorge)
Evt. andre nettverksoppsett/krav må aktør spesifisere!
For tilgang til Helsenorge i test, må NHN få liste med IP-adressene det skal testes fra, for å whiteliste adressene. Vi trenger info om navn, firma-epost og telefonnr per IP-adresse det skal åpnes for. (Dette kan de fleste som jobber med Helsenorge legge inn).
Aktør må ha 2-veis SSL sertifikat for transportkryptering.
Konfigurasjon av Helsenorges tilgangslogg tjeneste og XCA tjeneste må oppdateres med aktørens informasjon. Dette sendes til NHN via Slack i forkant av ønsket kommunikasjonstest. Dette må sjekkes inn og deployes til aktuelt HN miljø!
Før brøytekjøring må pkt 1-5 være bekreftet utført. Vi anbefaler å avtale møte for felles brøytekjøringstest.
For digital dialog:
Her gjelder kun avtale om hvilket miljø som skal benyttes og punkt #3 over.
For API oppkobling:
Hva bør beskrives her Martin Stokvik Arntzen ?
Testdata/-pasienter
NHN stiller krav til at det ikke finnes data fra produksjon i aktør sitt testmiljø som integreres med Helsenorge. Testdataene skal tilfredsstille GDPR krav. (Dersom noen EPJ miljøer har reelle proddata må dette identifiseres og håndteres.)
NHN tilbyr et sett med testpasienter med fiktive, men gyldige personnummer, som kan benyttes for alle tilkoblinger i denne løsningen.
Dersom det ikke er behov for spesielle testdata (utover det som er spesifisert under), kan det bare benyttes de felles som er listet i nhn.no : “Testaktører.pdf“.
Behov for spesielle testdata kan være om virksomheten har egne forretningsregler - forhold som skal begrenses i EPJ, som må testes - dette må i tilfelle bestilles spesifikt.
Forkortelser og forklaringer
NHN | Norsk helsenett |
HN | helsenorge.no |
Aktør / EPJ | Integrasjonspart |
Produktdata | Løsningsdata (det som løsningen produserer/utveksler) som må kobles til personer (bærer av dataene). NHN levere persondata, aktøren(e) som produserer data, leverer disse produktdataene på de avtalte personer/bærere for å kunne utføre relevante tester. |