Gliffy | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Forretningsbehov
Expand | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||
|
Forutsetninger og tips
Bestilling av tilgang til ekstern-API, eller ved behov for opprettelse av nye installasjoner for digital aktiv-sjekk, skal sendes til ide-ogbestillingsmottak@nhn.no. Fyll ut bestillingsskjema under.
API-et krever at klienten på forhånd har autentisert seg mot vår Sikkerhetstjeneste og fått utstedt et aksesstoken.
For å nå https://eksternapi i test-systemene våre må NHN whiteliste IP-adressen trafikken kommer fra.
Aktør er konfigurert med en API-klient i avtalt/egnet testmiljø
API-klient er gitt tilgang til STS i context (System til System - V2)
API-klient er gitt tilgang til DigitalAktiv API
NB! DigitaltAktiv-svaret fra Helsenorge inneholder ikke status på om innbygger har reservert seg mot digital kommunikasjon i Kontakt- og reservasjonsregisteret fra Digitaliseringsdirektoratet. Det betyr at personer kan være aktive på Helsenorge også i de tilfeller hvor de har reservert seg mot digital kommunikasjon sentralt. Dette hindrer ikke digital dialog via Helsenorge (som har eget samtykke), men hindrer f.eks. at viktige brev kan leveres på Helsenorge. For slike behov skal metoden FinnFormidlingskanal eller eventuelt videreformidlingstjenesten på Helsenorge benyttes.
Dersom DigitaltAktivStatusEndringer sendes uten dato, vises resultat for siste 3 måneder.
Denne metoden skiller kun på område (fra forespørselen), ikke på virksomhet - mao svaret inneholder endring for all innbyggere som er på Helsenorge.
Hva betyr det å være Digital Aktiv?
Expand | ||
---|---|---|
| ||
Svaret på Digital Aktiv er ikke binært ja/nei og svaret funksjonen gir vil avhenge av mange faktorer:
Aktiv selvBetyr at innbygger har en aktiv profil på Helsenorge og kan motta digital informasjon innenfor det området det er snakk om i det aktuelle tilfellet. Aktiv via andreBetyr at det finnes minst én annen person som har tilgang til å representere den aktuelle innbyggeren innenfor det aktuelle området på Helsenorge. Dvs. at det finnes andre som kan få tilgang til informasjon på vegne av innbyggeren og evt. utføre aktuelle handlinger på vegne av denne. Dette kan også fungere som et supplement i tillegg til informasjon som også må gis i andre kanaler for å nå innbygger direkte. Personen(e) som kan representere andre på denne måten har fått denne tilgangen gjennom fullmakt eller fordi de har foreldreansvar for et barn. Tolkning av svaret på DigitaltAktivOmrådeIntegrasjonsparten er ansvarlig for å avgjøre hva som er riktig å gjøre med svarene. Aktøren må selv definere behov for å skille på erDigitaltAktivSelv eller erDigitalAktivViaAndre |
Teknisk Implementasjon
Teknologi | Dokumentasjon | Kommentar | ||||
---|---|---|---|---|---|---|
| Gir informasjon om én eller flere innbygger sin digitalt aktiv-status | |||||
| Gir informasjon om hvilke innbyggere som har endret sin digitalt aktiv-status siden angitt tidspunkt. Benyttes for store aktører (f.eks. RHF og store kommuner) der HelsenorgeAktivSjekken ikke er egnet å benytte direkte. | |||||
| Autorisasjon og aksesstoken Alle API-er krever at klienten på forhånd har autentisert seg mot vår sikkerhetstjeneste og fått utstedt et aksesstoken som skal være med i tjenestekallene til det enkelte API. DigitalAktiv-tjenesten krever ikke at kallet utføres i context av en innlogget bruker dvs. UseCase 1 (system-til-system) beskrevet i “01 - System - System”. | |||||
Hvordan generere et RSA-nøkkelpar som skal benyttes for autentisering mot STS | ||||||
Kall til STS for å få AksessToken som må benyttes for å få tilgang til API | ||||||