...

GM-Facaden er en FHIR-baseret komponent, som udstiller data fra Graviditetsmappen via NMHD komponenten (Generisk udstilling (MHD) - Leverancebeskrivelse). NMHD servicen er en generisk service, som har til formål at udstille data hentet fra dokumentdelingsservicen via en generisk FHIR-snitflade. Adgangen styres via NSP’s sikkerhedskomponenter (Accesshandler, STS) og kræver, at anvenderens OIDC er godkendt af SDS (Sundhedsdatastyrelsen) og whitelisted i de relevante komponenter.

Forklaring omkring ovenstående arkitekturtegning: 

• Borgeren åbner 3. parts appen

• Appen sender borgeren videre til MitID via en OpenID Connect broker (identity serviceprovider).

• Borgeren logger ind, og broker’en sender et godkendt ID-token tilbage til 3. parts backend.

• Backend hos serviceprovider validerer tokenet og kontrollerer rettigheder.

• Backend laver en sikker opkobling via Sundhedsdatanet.

• Backend kalder GM facadelaget med GM-services på NSP (via FHIR/REST/JTP-H) for at hente data fra graviditetsforløbet. 

• De hentede data sendes tilbage til appen, som viser dem for borgeren.

Definitioner og referencer

Relevante use-cases

Tredjepart Relevante usecases fra 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.

...

Usecase 1: Borger kan få vist alle deres Graviditetsdata fra Graviditetsmappen (forudsætning: Logget ind med MitID)

Usecase 2: Borger kan sende alle graviditetsdata til egen Digitale Postkasse 

Læsevejledning og forudsætninger

...

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

Administrative forudsætninger (fx. Tilslutningsaftale – Bestillingsark for adgang til eksternt testmiljø) 

Bruno Collection

...

- GM-Facade 

FAQ NSP miljøer - NSP services - Global Site

Sikkerhed

Adgangen sker gennem NSP’s sikkerhedskomponenter og følger JTP-H-profilen, hvor borgeren logger ind med MitID, og et OIDC-token ved kald til GM-Facaden.

...

1. Anvendelse af godkendt OIDC

   • Tredjeparts anvender kan benytte en allerede godkendt og trusted OIDC.

   • Dette er den enkleste løsning, da OIDC’en allerede er kendt og godkendt af SDS og derfor hurtigt kan konfigureres i Accesshandleren.

2. Anvendelse af ny OIDCny OIDC

   • Hvis 3. parts anvender vælger at etablere en egen OIDC, skal den leve op til minimum NSIS-niveau Betydelig, følge JTP-H, være anmeldt til NSIS-tilsynet og underlagt årlige revisioner.

   • OIDC’en skal desuden understøtte de flows, som GM-Facaden kræver.

   • Denne løsning er mulig, men væsentligt mere kompleks og kræver tæt dialog med SDS.

...

Adgang sker ved, at borgeren logger ind og får udstedt et JTP-H token fra en OIDC-udsteder. Dette token anvendes som som bearer token i REST-kaldet mod GM-Facaden og giver kun adgang til borgerens egne dokumenter.

...

Tredjeparts anvenderemå 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).

(se afsnit 2.7) 

Proces for whitelisting

For at få adgang til GM-facaden på NSP og kunne hente data fra Graviditetsmappen skal man have tilsluttet sit system. 

For yderligere information: Administrative forudsætninger

...

1. Ejeren af OIDC-serverenopretter supportsag til NSP/SDS: Supporthenvendelse

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

3. SDS konfigurerer følgende:

   NMHD - Accesshandler

   • GM-Facade - Accesshandler

   • STS (Whitelisting)

   
   

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

...

Snitfladebeskrivelse og brug

Tredjeparts app kalder Facadelaget, og anvender GM-FHIR modellen til at lave deres brugergrænseflader.

GM-Facaden tilbyder FHIR-baserede endpoints til hentning af journaldata for borgere i graviditetsforløb.
Adgangen sker via NSP’s sikkerhedskomponenter, hvor anvenderen kalder GM-Facaden med et autoriseret JTP-H-token udstedt af en godkendt OIDC.

...

Adgang til servicen sker ved at medsende en Authorization-header med bearer-token i form af JTP-H.

MitID Testtool: https://pp.mitid.dk/test-tool/frontend/#/view-identity

Hent Journal for borger

Endpoint:

...

https://test1-cnsp.ekstern-test.nspop.dk:8443/gmaf/api/2025/06/25/journal

Endpoints på TEST1 og TEST2: 

https://test1-cnsp.ekstern-test.nspop.dk:8443/gmaf

https://test2-cnsp.ekstern-test.nspop.dk:8443/gmaf

Fejlbeskeder

I fejl-scenarier vises disse fejlkoder:

...

Følgende brugere har journaldata på Test 1 og/eller Test 2: 

3112929958

3107901832

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.

...