Indhold
Komponenter
Dette dokument dækker FGVHR-servicen. Der udstilles et enkelt komponent af typen SOAP Webservice og en af typen REST-service.
Type: SOAP Webservice
Filnavn: fgvhr.war
Url: <serverurl>/fgvhr
Status-url: <serverurl>/fgvhr/status
- DKS-config: <serverurl>/fgvhr/20230601/dksconfig
- Type: Webservlet
- Filnavn: fgvhr-operations.war
- Url: <serverurl>/fgvhr-operations
Status-url: <serverurl>/fgvhr-operations/status
Version-url: <serverurl>/fgvhr-operations/version
Konfiguration
Servicekonfiguration
Grundlæggende konfiguration foregår ved redigering i filen fgvhr.properties. Den skal placeres i WildFly modul:
/pack/wildfly8/modules/dk/nsp/fgvhr/main/
Moduldefinitionen findes i kildekoden under:
/fgvhr-war/etc/modules/dk/nsp/fgvhr/configuration/main/module.xml
I fgvhr.properties kan følgende properties defineres:
Property | Beskrivelse | Påkrævet | Default værdi |
---|---|---|---|
dk.nsp.fgvhr.national.rolle | National rolle bruger skal have når der kaldes på admin-service. | Ja | |
dk.nsp.fgvhr.whitelisted.clientkey | Serialnumber fra det certifikat der benyttes ved kald til FSK snitflade. | Ja | |
dk.nsp.fgvhr.datasource.jndi | Navn på jboss datasource (defineret i fgvhr-ds.xml) | Ja | |
dk.nsp.fgvhr.validfrom.period.days | Hvornår er registrering af fravalg gyldig fra (antal dage) | Nej | 7 |
dk.nsp.fgvhr.minimum.age | Minimumssalderen (år) for hvornår man kan registrere fravalg | Nej | 60 |
dk.nsp.fgvhr.httpclient.pooling.totalconnections | Totale antal HttpClients forbindelser der kan åbnes | Ja | 200 |
dk.nsp.fgvhr.httpclient.pooling.maxconnections.pr.route | Antal HttpClients forbindelser der kan åbnes pr. rute | Ja | 20 |
personinformation.url | URL til PersonInformation servicen | Ja | |
personinformation.errorcount.duration | Specificering af hvor lang tid tilbage der skal tælles fejl fra PersonInformation servicen (ifm. /status endpointet). Angives som duration i ISO-8601 formattet. | Nej | PT10M (10 minutter) |
personinformation.error.tolerance | Antal fejl der tolereres fra PersonInformation servicen før /status endpointet angiver servicen som ikke tilgængelig. | Nej | 0 |
dcc.endpoint.citizen | Angiver det endpoint, som DCC'en skal kalde for at ramme citizen-service. Dette kommer til at fremgå af den XML, der returneres i /dksconfig. | Ja | |
minlog.get-activity-text | Tekst i Minlog ved læsning af fravalg | Ja | Læsning af Fravalg af genoplivning ved hjertestop register |
minlog.register-activity-text | Tekst i Minlog ved oprettelse af fravalg | Ja | Oprettelse af Fravalg af genoplivning ved hjertestop register |
minlog.delete-activity-text | Tekst i Minlog ved sletning af fravalg | Ja | Sletning af Fravalg af genoplivning ved hjertestop register |
minlog.update-activity-text | Tekst i Minlog ved opdatering af fravalg | Ja | Opdatering af Fravalg af genoplivning ved hjertestop register |
fgvhr.nas.notification.job.max.duration | Den tilladte varighed af jobbet. Angives som duration i ISO-8601 formattet; dog bør kun sekunder angives. | Nej | PT15S |
fgvhr.nas.notification.job.nas.bundle.size | Antallet af adviseringer der sendes til NAS af gangen per SOAP request. | Nej | 50 |
fgvhr.nas.notification.job.batch.size | Antallet af adviseringer der hentes fra tabellen af gangen. | Nej | 500 |
nas.sts.endpoint | Endpointet, hvor NAS-integrationen skal trække et idkort på baggrund af sts.keystore | Ja | |
nas.sts.keystore | Keystore der indeholder funktionscertifikatet | Ja | |
nas.sts.keystore.password | Password til at åbne keystore | Ja | |
nas.endpoint | Endpointet hvor NAS skal kaldes | Ja | |
nas.idcard.subject.name | Subject name på idkortet | Ja | |
nas.idcard.subject.id | Subject Id på idkortet | Ja | |
nas.idcard.system.name | Systemnavn på idkortet | Ja | |
nas.topic | Det topic der skrives til på NAS | Ja |
minlogclient.properties
FGVHR anvender MinLogProvider til at registrere logninger i MinLog, og i den forbindelse skal Kafka properties for MinLog konfigureres.
Property | Beskrivelse | Default værdi |
---|---|---|
kafka.producer.bootstrap.servers | Url til Kafka bootstrap-server. | kafka:9092 |
kafka.producer.client.id | Id der anvendes af Kafka producere i løsningen. | FGVHRMinLog2-producer |
kafka.producer.key.serializer | Serializer key for Kafka producer | org.apache.kafka.common.serialization.StringSerializer |
kafka.producer.value.serializer | Serializer value for Kafka producer | org.apache.kafka.common.serialization.StringSerializer |
kafka.topic | Navn på Kafka topic | FGVHR_TOPIC |
log4j konfiguration
Log4j konfiguration for begge services findes i samme wildfly modul som servicekonfigurationen
Se yderligere opsætning i installationsvejledningen.
Overvågning
Der udstilles statussider, som kan tilgås fra adresserne i afsnittet Komponenter
Fortolkning af statussider
Statussiderne returnerer enten:
- HTTP 200, hvis servicen i øjeblikket kører fint.
- HTTP 503, hvis der er opstået en fejl der kræver indgriben.
Audit-logning
Hvert servicekald medfører en ny indgang i auditloggen, som kan være udfyldt med følgende komponenter, afhængig af konteksten:
Komponent | Kontekst | Type | Nøgle | Information |
---|---|---|---|---|
FGVHR | registerConsent | Personlig | patient-id | Borgerens id |
FGVHR | registerConsent | Personlig | patient-id-source | Id'ens kilde, fx "CPR" |
FGVHR | registerConsent | Ikke personlig | actor-role | Aktørens rolle |
FGVHR | registerConsent | Ikke personlig | actor-id | Aktørens id. Vil i praksis være det samme some patient-id. |
FGVHR | registerConsent | Ikke personlig | actor-id-source | Id'ens kilde, fx "CPR" |
FGVHR | registerConsent | Følsom | consent-status | Status på samtykke. Kan være "ACTIVE", "INACTIVE" eller "ENTERED-IN-ERROR". |
FGVHR | registerConsent | Personlig | valid-from | Antal dage til hvornår samtykke træder i kraft |
FGVHR | registerConsent | Personlig | citizen-created-date | Hvornår borgeren har underskrevet blanketten, hvis registreringen kommer fra blanket. |
FGVHR | deleteConsent | Personlig | patient-id | Borgerens id |
FGVHR | deleteConsent | Personlig | patient-id-source | Id'ens kilde, fx "CPR" |
FGVHR | deleteConsent | Ikke personlig | actor-role | Aktørens rolle |
FGVHR | deleteConsent | Ikke personlig | actor-id | Aktørens id. Vil i praksis være det samme some patient-id. |
FGVHR | deleteConsent | Ikke personlig | actor-id-source | Id'ens kilde, fx "CPR" |
FGVHR | deleteConsent | Følsom | consent-status | Status på samtykke. Kan være "ACTIVE", "INACTIVE" eller "ENTERED-IN-ERROR". |
FGVHR | getConsent | Personlig | patient-id | Borgerens id |
FGVHR | getConsent | Personlig | patient-id-source | Id'ens kilde, fx "CPR" |
FGVHR | updateConsent | Personlig | patient-id | Borgerens id |
FGVHR | updateConsent | Personlig | patient-id-source | Id'ens kilde, fx "CPR" |
FGVHR | updateConsent | Ikke personlig | actor-role | Aktørens rolle |
FGVHR | updateConsent | Ikke personlig | actor-id | Aktørens id. Vil i praksis være det samme some patient-id. |
FGVHR | updateConsent | Ikke personlig | actor-id-source | Id'ens kilde, fx "CPR" |
FGVHR | updateConsent | Følsom | consent-status | Status på samtykke. Kan være "ACTIVE", "INACTIVE" eller "ENTERED-IN-ERROR". |
FGVHR | updateConsent | Personlig | valid-from | Antal dage til hvornår samtykke træder i kraft |
Baggrundsjobs
NAS adviseringsjob
Baggrundsjobbet har til formål at sende alle ikke-afsendte NAS-adviseringer, der er oprettet på baggrund af ændring i borgeres fravalg. Adviseringer lagres i tabellen "unsent_notifications".
Baggrundsjobbet startes med et HTTP GET kald til
<serverurl>/fgvhr-operations/nas-notification-job
Jobbet konfigureres med parametrene beskrevet i afsnittet "Servicekonfiguration".
Jobbets seneste status kan aflæses på komponentens statusside. Detaljer om de enkelte kørsler (antal rækker behandlet mm.) skrives direkte til komponentens log-fil.