Digitalt aktiv - API for forespørsel om innbyggers digital status i HN

Owned by Alette N. L. Olrik (Unlicensed)
Last updated: Jul 03, 2023
2 min read

For å få integrasjon med helsenorge.no må systemleverandøren gjennomgå et godkjenningsløp hos NHN.

Dokumentasjon: Ferdig

Løsning: FERDIG

Digital aktiv API er en nyere tjeneste som erstatter en enklere AMQP melding.
APIet har utvidet detaljering som gir informasjon om hva slags digital aktiv - på hvilket område, og om innbygger er aktiv selv eller via andre.

Forutsetninger & tips

  • Vi har satt APIet opp i vårt TEST-02 testmiljø

    • Vi ønsker at leverandørens testmiljø (eventuelt flere om det trengs) går mot dette HN miljøet som er eksponert både på Internett og på Helsenettet.

  • Vi definerer opp en API-klient hos oss som tildeles dere.

    • Klienten gis da rettigheter til å benytte DigitalAktiv APIet.

    • Klienten har samme API ClientID i alle miljøer (også PROD).

    • For at dere skal autentisere dere mot vår sikkerhetstjeneste (STS) må dere generere et RSA-nøkkelpar, der vi får tilsendt den offentlige nøkkelen. Denne registreres inn på API-klienten.

      • Det skal ALLTID være et annet RSA-nøkkelpar i PROD.

  • Mer om forutsetninger finnes i "Etablering av ny testaktør..." under avsnittet om Test

  • Det kreves etterlevelse og signatur av disse Bruksvilkår leverandører (pdf)

Tips:

Til oppstartsmøte trenger vi informasjon om følgende:

  • Organisasjonsnavn- & nr. som er ansvarlig for den tekniske installasjonen av API-klienten.

  • Teknisk kontaktperson med en betegnelse/rolle eller navn samt en e-post adresse og telefonnummer

  • API klient navn - kortfattet navn (uten mellomrom) som beskriver klienten f.eks. systemnavn-installasjonssted. (Eks: dipsarena-helsevest)

  • IP adresser som trenger tilgang til HN-testmiljøer.

Spesifikasjoner & Krav

Gjeldende funksjonelle- og ikke-funksjonelle krav må oppfylles for løsningen.

Funksjonelle beskrivelser oppdelt per tjeneste med:

=> Implementasjonskrav
=> teknisk dokumentasjon

felles for alle tekniske beskrivelser: Innholdsstandarder

Test

Dokumentet "Etablering av ny testaktør..." beskriver hvilke aktiviteter som må gjennomføres for å få tilgang til NHNs utviklings- og testmiljøer for Helsenorge. 

Dersom EPJ leverandøren har behov for infrastruktur for å legge sin test-instans på, tilbyr NHN "SkyLab"

 

 

 

Innføring og produksjon

For systemleverandør:
Beskrivelsene under viser hvilke aktiviteter som må gjennomføres av en EPJ leverandør for å få etablert en ny aktør (f.eks. et legekontor) i produksjonsmiljø.  I tillegg til en presentasjon som viser hvordan hendelse- og feilhåndtering i NHN, som systemleverandørene må forholde seg til.

 

 

Nye versjoner av integrert system: Når systemleverandøren har nye versjoner eller ny funksjonalitet som berører integrasjonen til Helsenorge, benyttes prosess for test og godkjenning til dette. Dokumentet under beskriver hvordan dette skal vurderes.

Denne inneholder retningslinjer for leverandørens vurdering om i hvilken grad endringen berører de nasjonale e-helseløsningene.