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.

Nap-reference-web

Nap-reference-web er en statisk webapplikation, som bliver statisk serviceret fra wildfly. 

Hvordan fungerer servicen

Single page web applikation med 2 routes:

RouteFunktionalitet
/aftaler

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

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

/hjælpViser informationer om, hvordan der kan oprettes en NSP support sag

Konfiguration

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

Key

Value

AppointmentsEndpointAftale endpoint
ServerUrlRelative path til nap-reference-facade

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

Håndtering af fejlsituationer og logning

Da nap reference web er en stateless webapplikation, foregår der ingen logning i denne komponent. Fejl vil dog blive skrevet ud i konsollen. I tilfælde af http fejl bliver klienten præsenteret med en fejl.

Nap-reference-facade

Service snitflade

EndpointsFunktionalitet
/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ågnings snitflade

EndpointsFunktionalitet
/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 konfigurationsfiler skal være tilgængelige i classpath under deployment (loades fra applikationsserverens modules/dk/sds/nsp/nap/reference/facade/main).

MANGLER KONFIGURATION AF SLA-LOG

Konfigurationsfiler
FilnavnIndhold
log4j-nap-reference-facade.xml

log4j configuration for applikations log

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration debug="false">

   <appender name="FILE" class="org.apache.log4j.RollingFileAppender">
      <errorHandler class="org.apache.log4j.helpers.OnlyOnceErrorHandler"/>
      <param name="File" value="${jboss.server.log.dir}/nap-ref-facade.log"/>
      <param name="Append" value="true"/>

      <param name="MaxFileSize" value="${dk.nsp.log.MaxFileSize}"/>
      <param name="MaxBackupIndex" value="${dk.nsp.log.MaxBackupIndex}"/>

      <layout class="org.apache.log4j.PatternLayout">
         <param name="ConversionPattern" value="timestamp=&quot;%d&quot; threadId=&quot;%t&quot; priority=&quot;%p&quot; category=&quot;%c&quot; requestId=&quot;%X{RequestId}&quot; message=&quot;%m&quot;%n"/>
      </layout>
   </appender>

   <category name="dk.sds.nsp">
      <priority value="DEBUG"/>
   </category>

   <category name="ca.uhn">
      <priority value="ERROR"/>
   </category>

   <root>
      <priority value="INFO"/>
      <appender-ref ref="FILE"/>
   </root>

</log4j:configuration>
nap.jksJKS fil indeholdende NAP certifikat til det audience, det specificeres i nap-facade.properties
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.jksJKS fil med certifikater fra trusted STS providers.


 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. 

LogfilnavnKomponenter der skriver til denne
nap-ref-facade.lognap facade applikationen
sla.lognap facade aftale sla-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. 

Fejlene vil blive vist i konsollen.