Noter:

monitoreringssnitflader
generel overvågningsflader
service snitflader
modus operandi – hvordan agere komponenten/servicen
håndtering af fejlsituationer
beskrivelse af log, hvoraf SLA logpunkter i særdeleshed skal beskrives.

Introduktion

Formål

Dette dokument er rettet mod systemadministratorer og driftspersoner, som skal kunne håndtere driftsmæssige aspekter af komponenten.
Driftsvejledningen indeholder information om Nap-reference-web og Nap-reference facade med hensyn til eksterne afhængigheder, standard placering af logfiler og konfigurationsfiler.

Nap-reference-web

Hvordan fungerer servicen

Single page application med 3 routes:

Route

Funktionalitet

/aftaler

Viser en patientaftaleoversigt ved lave et kald til til nap-reference-facade.

I tilfælde af http fejl vises dette til brugeren.

/hjælp

Viser informationer om, hvordan der kan oprettes en NSP support sag

Konfiguration

configurations.json mappes til /pack/webapp/assets/

Key	Value
AppointmentsEndpoint	Aftale endpoint
ServerUrl	Relative path til nap-reference-facade

Konfigurationen kan ændres runtime, men skal matche loadbalancer indstillingerne.

Logning

Da nap reference web er en stateless webapplikation, som bliver statisk serviceret fra wildfly foregår der ingen logning i denne komponent.

Nap-reference-facade

Hvordan fungerer servicen

Endpoints

Funktionalitet

/aftaler/{cpr}

Validerer den indkommende SAMLassertion efterfølgende kaldes Dokumentdelingsservice (DDS) for at hente aftale dokumenter for en patient.

/isAlive

Bruges af loadbalanceren for at tjekke at servicen er deployet. Returnerer en html side med deployment info.

Da denne service ikke er afhængige af database eller andre interne services, returnere den altid 200, hvis applikationen kører.

Konfiguration

Følgende konfigurations filer skal være tilgængelige i classpath under deployment (loades fra applikationsserverens modules/dk/sds/nsp/nap/reference/facade/main).

Konfigurationsfiler
Filnavn	Indhold
log4j-nap-reference-facade.xml	log4j configuration
nap.jks	JKS fil indeholdende NAP certifikat til audience /nap
nap-facade.properties	Applikation properties # Sti til nap certifikat keystorePath=nap.jks # Password to the service provider certificate keystorePassword=Test1234 # Path where public certificates of trusted STS services are stored trustedStsCert=trusted-sts-certs.jks # Password for the trusted sts certifikate keystore trustedStsCertPassword=password # Max clock skew allowedClockDrift=3 # The audience, SAML-tokens are required to have expectedAudience=https://audience.nspop.dk/nap # XDS xdsIti18Wsdl=wsdl/iti18.wsdl xdsIti18Endpoint=http://test1-cnsp.ekstern-test.nspop.dk:8080/ddsregistry/services/xds-iti18 xdIti43Wsdl=wsdl/iti43.wsdl xdsIti43Endpoint=http://test1-cnsp.ekstern-test.nspop.dk:8080/ddsrepository/services/xds-iti43
trusted-sts-certs.jks	JKS fil med certifikater fra STS providers.
standalone.conf	Wildfly standalone konfiguration der tillader tilslutning af JVM til remote socket debugging (kun aktuelt for udvikling)

Logging

Log4j konfigurationen skal findes i log4j-nap-reference-facade.xml på classpath.

Ved default konfiguration skrives alle modul-reletarede fejl til nap-ref-facade.log.