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 log- og konfigurationsfiler.

Sammenhæng med øvrige dokumenter

Dette dokument er en del af den samlede dokumentation for NAP SDK.

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

Ønskes mere information omkring arkitektur og design findes dette på NAP Ref.Impl. - Design og Arkitektur beskrivelse.

Ønskes mere information omkring installationsvejledning til anvender kan findes på NAP Ref.Impl. - Installationsvejledning.

Ønskes mere information omkring anvendelse kan dette findes på NAP Ref.Impl. - Guide til anvendere.

Service snitflade

Endpoints	Funktionalitet
/aftaler/{cpr}	Validerer den indkommende authentication header indeholdende en SAMLAssertion. Efterfølgende kaldes Dokumentdelingsservice (DDS) med det angivne SOR nummer fra "X-OrganizationSor"-headeren, for at hente alle aftale dokumenter for patienten med det oplyste cpr nummer.

Overvågning snitflade

Endpoints

Funktionalitet

/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.

Login / logout (SAML)

Endpoints	Funktionalitet
/saml/SAMLAssertionConsumer	Validerer den indkommende authentication header indeholdende en SAMLAssertion.
/saml/Logout	Brugeres til at validere autentifikations requests og registrere en brugers assertion i en threadlocal session.

Konfiguration

Konfiguration af NAP-reference sker i filerne "compose/configuration" mappen som er beskrevet i NAP Ref.Impl. - Installationsvejledning. I det følgende gennemgåes konfigurationsfilernes detaljer.

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

Konfigurationsfiler
Filnavn	Beskrivelse
log4j-nap-reference-facade.xml	lndeholder Log4j opsætninger der følger gængs standard på NSP.
log4j-nspslalog.properties	lndeholder SLALog opsætninger der følger gængs standard på NSP.
nap-facade.properties	Applikation properties # Path to the service provider certificate keystorePath # Password to the service provider certificate keystorePassword # XDS xdsIti18Wsdl xdsIti18Endpoint xdIti43Wsdl xdsIti43Endpoint
funktionscertifikat	JKS fil indeholdende Sundhedsdatastyrelsen nap reference funktionscertifikat certifikat. Skal være samme navn som keystore path i nap-facade.properties

Følgende oiosaml konfigurationer skal være tilgængelig i oiosaml.home (/pack/oiosaml) under deployment

Konfigurationsfiler
oiosaml-sp.log4j.xml	lndeholder Log4j opsætninger der følger gængs standard på NSP.
oiosaml-sp.properties	# Properties used by oiosaml-j # Reference to the location of the certificate used for signing SAML documents with - relative to ${oiosaml.home} oiosaml-sp.certificate.location= # Opaque/encrypted password to the certificate used for signing SAML documents oiosaml-sp.certificate.password # Required authentication level. 2=password, 3=certificate oiosaml-sp.assurancelevel # Name of the meta data file for the current service provider - overrides setting in brs-common.properties common.saml2.metadata.sp.filename # URI References to the current service provider oiosaml-sp.uri.home # Force login #oiosaml-sp.authn.force # Disable support for self-signed certificates by default oiosaml-sp.selfsignedcertificates # Disable revocation checking on OCES test certificats (because the CRL/OCSP endpoints are behind a firewall) oiosaml-sp.crl.disable-in-oces-test # Enable this setting to be eid compatible. Note this effects how AuthnRequests are generated oiosaml-sp.eid.compatible
Sundhedsdatastyrelsens nap reference funktionscertifikat	JKS fil indeholdende Sundhedsdatastyrelsen reference funktionscertifikat certifikat. Skal være samme navn som keystore path i nap-facade.properties
metadata/iDP/IdPMetadata.xml	OIOSAML identity provider metadata til konfiguration af OIOSAML filteret
metadata/iDP/SPMetadata.xml	OIOSAML service provider metadata til konfiguration af OIOSAML filteret

Logning

Alle logfiler er at finde i log/ under WildFly. Herunder findes en liste over alle logfiler med en beskrivelse af hvilke komponenter der skriver til dem.

Logfilnavn	Komponenter der skriver til denne
nap-ref-facade.log	nap facade applikationen
nap-ref-sla.log	nap facade aftale sla-log
oiosaml-sp.log	OIOSAML log
oiosaml-sp-audit.log	OIOSAML audit log

Ved default konfiguration findes applikations loggen i nap-ref-facade.log.

Fejlhåndtering

Applikationsfejl bliver logget ved hjælp af log4j, med type ERROR, INFO, DEBUG alt efter hvor alvorlig fejlen er.