...

Introduktion

I NAP optræder både self hosted services samt INSP services.

Denne guide er primært målrettet til anvendere, som skal implementere en ny afprøvningsløsning til INSP og har til formål, at give eksempler på kode og opsætning af web applikation og facade til NAP. 

Guiden beskriver en web applikation som bruger en backend, som interagerer med Dokumentdelingsservice (DDS), og som bruger sikkerhed i henhold til NAP konteksten. anvender oiosaml.java 2.21 (https://www.digitaliser.dk/resource/5359238) som sikkerhed- og autentikationslaget jf. Sikkerhedsarkitektur for iNSP løsninger.

Der er beskrevet instruktioner til opsætning af et web projekt og en backend, som overholder givne NSP standarder (Husregler for webløsninger og https://www.nspop.dk/display/public/web/Husregler+for+udvikling+til+NSP)

...

Dette dokument er en del af den samlede dokumentation for NAP Ref.impl.Reference implemenation.

Dokumentet er udformet, så det i videst muligt omfang opfylder sit formål uafhængigt af de øvrige dokumenter.

...

 NAP Ref.Impl. Opbygning

Nap-reference -web er en web applikation, som består af en java backend service (nap-reference-facade) samt en front for backend (nap-reference-web), som anvender bygget med angular fremworket og anvender version 1.0.0 af nap-typescript-sdk og nap-angular-sdk.

Applikationen kan køres indlejrede i et værtssytem (eks. nap-java-host), hvori der tilføjes en NAP Bridge på global scope. Således kan der kommunikeres med SDK'erne. Denne kommunikation håndterer sikkerhed via anvendelse af en SAMLassertion, og kommunikation mellem host og nap-reference ske i gennem NAP SDK - Guide til anvendere.

Denne kommunikation giver muligheden for overførelse af patientkonteksten og sessionsfejl  til det indlejret værtssystem.

Derefter tilføjes SAML assertion som en header, samt en Når nap-reference får overført en patientkontekst kaldes facaden med det cpr nummer sam SOR værdi i en en "X-OrganizationSor" header (denne værdi er hardcoded i dette tilfælde), til kaldet til nap-reference facade, der efterfølgende kalder dokumentationdelingsservicen". Facaden validere kaldet og viderestiller til Dokumentdelingsservice (DDS)..

Nap-reference-facade er en java applikation, som anvender SEAL.java til at validere den SAMLAssertion der bliver sendt ind i authentication headeren. Den sørger for at tjekke at  står for at hente relevante aftaledokumenter (org.openehealth.ipf.commons) for den valgte patient. For at formatere aftaledokumenterne fra XML til objekter, bruges biblioteket "dk.s4.hl7.builders". Før objekterne returneres, bliver kun relevant information sendt tilbage til nap-reference-web. 

...