Introduktion

Vejledning til installation og konfiguration af Nap-reference-web og Nap-reference-Facade.

Formål

Formålet med dokumentet er, at man med dokumentet i hånden kan installere Nap-reference-web og Nab-reference-Facade uden yderligere informationer.

Forudsætninger

Software requirements:

Det lokale udviklingsmiljø er opsat med docker-compose.

For at kunne køre de compose filer, der bliver beskrevet nedenfor kræves et docker netværk kaldet nap_net. Hvis dette ikke allerede er lavet kør `docker network create nap_net`.

Nap-reference-web

Krav til applikationsservere

Komponenterne er udviklet og testet under WildFly-8.2.0.Final på udviklingsplatformen. Service kan deployeres i produktion på Wildfly-8.2.0.Final applikationsservere eller en hvilken som helst server, der kan servicere statisk html.

Krav til adgang til andre services

Framing

Servicen benytter sig af nap-angular-sdk og nap-typescript-sdk og er udviklet til at være indlejret i et værtssytem (eksempelvis nap-java-host), hvor den får alt sin kontekst.
Det meste funktionalitet er bundet op på denne kontekst.

Forbindelse til facade

Servicen benytter sig af nap-ref-facade som backend. Det er dog muligt at køre en konfiguration, hvor der køres backend less.

for at køre backendless skal `--configuration=mock` tilføjes startkommandoen i compose filen i  compose/development/.

Installation

Er en statisk service som hostes i NSPs wildfly8 image.

Kør `npm install` for at installere dependencies.

Kør `docker-compose up` fra compose/develop for at starte en webpack server i docker på nap_net netværket.

Således vil containeren være tilgængelig på http://localhost:4600/ samt http://localhost:8080/nap/reference/web/ hvis (https://svn.nspop.dk/svn/components/nap/nap-compose/) kører på samme netværk som en reverse proxy.

Konfiguration

For at konfigurerer denne service skal en configurations.json fil volume mappes til src/app/assets/.

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

Nap-reference-facade

Krav til applikationsservere

Komponenterne er udviklet og testet under WildFly-8.2.0.Final på udviklingsplatformen. Service kan deployeres i produktion på Wildfly-8.2.0.Final applikationsservere.

Krav til adgang til andre services

Servicen benytter sig af dokumentdelingsservicen og det er et krav, at denne kan nåes på den url, der er specificeret i properties.

Det er et krav for at køre tests, at dokumentsdelingsservicen på test2 kan køres. 

Installation

Kør `mvn install` for at installere dependencies og bygge applikationen.

kør `docker network create nap_net` for at oprette et docket netværk, hvis ikke dette allerede er gjort.

Kør `docker-compose up` fra compose/develop for at starte en wildfly server i docker på nap_net netværket.

Konfiguration

Alt konfiguration foregår ved at loade filer fra wildfly modulet dk.sds.nsp.nap.reference.facade.

De følgende konfigurationsfiler skal således volume mappes ind i modulet "dk/sds/nsp/nap/reference/facade/main/" på applikations serveren (/pack/wildfly8/modules/ i docker).

Disse filer bliver loadet ind på classpath wildfly når applikationen deployes.

# 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

Ved konfigurationsændringer skal wildfly serveren genstartes.