Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Navitabs
rootStamkortregister-service (SKR)


Overblik

Dette dokument beskriver installation og konfiguration af Stamkortregister-servicen (SKR). Konfiguration af tilhørende DGWS/IDWS Proxy er også beskrevet.

...

Info

Alle filer der refereres til ligger sammen med projektets kildekode i NSP's Subversion. Referencer til stier er relative med udgangspunkt i projektets rodmappe.

Ændringslog

Version

Dato

Ændring

Ansvarlig

1.0.0

2018-08-31

Initialt dokument

Trifork

1.0.12018-09-11Ændret databasedriver til MySQLTrifork

Byggevejledning

For at bygge projektet og dets deployables (war-filer) uden at køre unit-tests og integrationstests, anvendes følgende Maven kommando:

...

Properties er her opdelt i to tabeller. Den første tabel indeholder anvendte Spring Boot-properties. Den anden tabel indeholder properties, der er specifikt defineret til brug i servicen. Begge typer af properties er defineret i samme konfigurationsfil.

Spring Boot-properties

PropertyBeskrivelseDefault
spring.application.nameNavnet på applikationen. Skal ikke ændres.skr
spring.jmx.enabledDisable Spring Boot JMX. Skal ikke ændres. Deaktiveret da vi ikke udstiller særlig JMX funktionalitet.false
spring.jta.enabled

JTA transaktioner. Det er påkrævet at denne er false, således at Spring Boot i stedet anvender dens egen håndtering af transaktioner. (true/false)

false
management.server.port

Port som Spring Boot management endpoints bind'er på. Endpoints deaktiveres ved at sættes værdien til -1.

-1
spring.datasource.jndi-nameAngiver navnet på den primære JNDI datasourcejava:jboss/datasources/SKR-DS

Komponentspecifikke-properties

PropertyBeskrivelseDefault
dcc.endpointAngiver det endpoint, som DCC'en skal kalde. Dette kommer til at fremgå af den XML, der returneres i /dksconfig. Bør ændres før produktion.http://test1.fsk.netic.dk:8080/fsk/services/fsk
minlog.read-activity-textAngiver den tekst der registreres i MinLog, når der bliver læst Stamkortregister-data for et CPR-nummerLæsning af Fælles Stamkort
minlog.write-activity-textAngiver den tekst der registreres i MinLog, når der bliver læst Stamkortregister-data for et CPR-nummerOpdatering af Fælles Stamkort
schemavalidation.validate-requestsAngiver om requests skal schema-valideres (true/false)true
schemavalidation.validate-responses

Angiver om responses skal schema-valideres (true/false)

true
schemavalidation.fail-on-response-error

Angiver om en kald skal returnere fejl, hvis response ikke er schema-valid (true/false)

true
forward-only-filter.enabledAngiver om servicen kun skal kunne tilgås igennem DGWS/IDWS Proxyen (wsproxy komponenten). Bør altid være sat til true. (true/false)true
cpre.keystore.filesystem.pathStil til CPRE keystore på filsystemet. Kan være absolut eller relativ i forhold til hvor Wildfly startes fra.cert/Statens_Serum_Institut_FOCES.jks
cpre.sts.endpointEndpoint til STShttp://test1.ekstern-test.nspop.dk:8080/sts/services/NewSecurityTokenService
cpre.endpointEndpoint til CPR-Enkeltopslaghttp://test1.ekstern-test.nspop.dk:8080/stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.3
cpre.keystore.passwordPassword til det keystore der udpeges af cpre.keystore.filesystem.pathTest1234
cpre.org.idCVR-nummeret fra certifikatet der ligger i det keystore der udpeges af cpre.keystore.filesystem.path46837428
cpre.connect.timeout.millisConnect-timeout mod CPR-enkeltopslag (ms)2000
cpre.read.timeout.millisRead-timeout mod CPR-enkeltopslag (ms)7000

log4j2.xml

Konfigurerer logning for servicen.

...

Komponenter, der skal deployes til Wildfly, kopieres til mappen <wildfly-root>/standalone/deployments.

Filnavn når deployet

Beskrivelse

Kilde

skr-service.war

SKR servicen

skr-service-<version>.war

skr.war

DGWS/IDWS Proxy . Se Installationsvejledning (DGWS/IDWS Proxy) for dokumentation. War-filen for wsproxy komponenten omdøbes til skr.war, hvilket bevirker at webservice context-path for wsproxy i dette tilfælde bliver /skr.

wsproxy-<version>.war (findes ikke i skr-projektet)

Se driftsvejledningen for yderligere information.

...