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:

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, som bliver statisk serviceret fra wildfly, foregår der ingen logning i denne komponent. Der vil dog blive skrevet beskeder ud i konsollen. 

I tilfælde af http fejl bliver kliententen præsenteret med en fejl.

Nap-reference-facade

Hvordan fungerer servicen

EndpointsFunktionalitet
/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
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">

   <!-- ================================= -->
   <!-- Preserve messages in a local file -->
   <!-- ================================= -->

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

   <!-- ========== -->
   <!-- Categories -->
   <!-- ========== -->

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

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

   <!-- ======================= -->
   <!-- Setup the Root category -->
   <!-- ======================= -->

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

</log4j:configuration>
nap.jksJKS 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.jksJKS fil med certifikater fra 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.Alle logfiler er at finde i log/ under WildFly. 

LogfilnavnKomponenter der skriver til denne
nap-ref-facade.lognap facade applikationen
sla.log

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