DENNE SIDE ER UNDER UDARBEJDELSE TIL 3. PARTS ANVENDERE AF GM-FACADE

Indholdsfortegnelse

Introduktion

Formål

Denne guide har som formål at give et overblik over Graviditetsmappens app facade (GM Facade) med henblik på at eksterne anvendere (3. parter) kan tilgå GM-Facaden via NSP-testmiljøerne. Formålet med dokumentet er at give anvenderne et overblik over løsningen, samt indsigt i krav til OpenID Connect (OIDC), proces for whitelisting, samt adgangs- og testforudsætninger. 

Beskrivelse

GM-Facaden eksponerer FHIR-baserede services, der muliggør integration til Graviditetsmappen (GM) via NSP-infrastrukturen.

GM Facade er en REST udstilling af Graviditetsmappens journal data fra komponenten MHD (Generisk udstilling (MHD) - Leverancebeskrivelse), som en FHIR model sikret med JTP-H. Adgangen styres via NSP’s sikkerhedskomponenter (Accesshandler, STS, NMHD) og kræver, at anvenderens OIDC er godkendt af SDS (Sundhedsdatastyrelsen) og whitelisted i de relevante komponenter.

Links til mere information

Dokumentation for anvendt FHIR model findes her: https://build.fhir.org/ig/trifork/gm-fhir-ig/branches/main/index.html

Dokumentation for krav til JTP-H findes her: NSP Access Handler - Design og arkitekturbeskrivelse 

Tilslutningsaftale – Bestillingsark for adgang til eksternt testmiljø

Bruno Collection – NMHD – NSP Mobile Access to Health Documents

Relevante use-cases

• Tredjepart systemer som ønsker at hente journaldata via GM-Facaden (Borgervendt app hvor borgeren selv kan hente data via en app) 

• Test og validering af integration med GM-Facaden i NSP’s testmiljøer.

• Anvendelse af egen OIDC til autentifikation.

Læsevejledning og forudsætninger

Denne guide henvender sig til tekniske anvendere (udviklere, arkitekter), som skal integrere med GM-Facaden via NSP.
Læsere bør have kendskab til:

• OIDC og JTP-H-profilen

• FHIR-standarder

• NSP’s sikkerhedsarkitektur (STS, NMHD, Accesshandler)

Sikkerhed

Sikkerheden i GM-Facaden bygger på OIDC og NSIS (National Standard for Identiteters Sikringsniveau).

• Alle OIDC-udbydere skal opfylde NSIS niveau "Betydelig".

• Kun OIDC’er godkendt af SDS må benyttes.

• Whitelisting i NMHD, Accesshandler og STS er påkrævet, før adgang kan gives.

Definitioner og referencer

Adgang, brug og snitflader

Adgang

Krav til OIDC

Tredjeparts anvendere må anvende egen OIDC, hvis følgende betingelser er opfyldt:

• OIDC følger JTP-H-profilen.

• OIDC er godkendt af SDS.

• OIDC lever op til NSIS niveau Betydelig (herunder anmeldelse til NSIS-tilsynet og årlig revision).

Proces for whitelisting

1. Ejeren af OIDC-serveren opretter supportsag til NSP/SDS.

2. SDS godkender OIDC’ens tekniske og sikkerhedsmæssige opsætning.

3. SDS konfigurerer følgende:

   • NMHD

   • Accesshandler (Facade)

   • STS (Whitelisting)

4. Accesshandler-konfigurationen udvides til at acceptere tokens fra den nye issuer.
   Se teknisk beskrivelse her:
   Konfiguration af nye issuers i Accesshandler

Tilslutningsaftale og adgang til testmiljøer

For adgang til NSP’s testmiljøer (Test-1 og Test-2):

• Der skal underskrives en tilslutningsaftale med NSP-operatøren.

• Brug formularen: Bestillingsark for adgang til eksternt testmiljø.

• Angiv de ønskede services og formål.

• Vælg basispakken for adgang til Digital Løsning til Graviditetsforløb.

Snitfladebeskrivelse og brug

Hent Journal for borger

GM-Facaden tilbyder FHIR-baserede endpoints til hentning af journaldata for borgere i graviditetsforløb.
Anvenderen kalder GM-Facaden med et autoriseret token udstedt af en godkendt OIDC.

Adgang til servicen sker ved at medsende en Authorization-header med bearer token i form af JTP-H. Et gyldigt JTP-H token til test kan erhverves vha. OATH 2.0 med følgender properties:  

Endpoint:

Henter borgers journal i Graviditetsmappen 

Endpointet returnerer JSON svarende til implementerings guide'en for dokumenttyperne Svangerskabsjournal, Vandrejournal og Målinger (se  https://build.fhir.org/ig/trifork/gm-fhir-ig/branches/main/index.html)

Detaljeret snitfladebeskrivelse fremgår af de tekniske FHIR-specifikationer.

Fejlbeskeder

I fejl-scenarier vises disse fejlkoder:

Test

Følgende brugere burde have journal data på både Test 1 og Test 2:

Eksempel kode og klient

Se integrations test i https://git.nspop.dk/scm/com/graviditetsmappens-app-facade.git for eksempel på komplet integration til komponenten.

Dokument Historik