Indhold
Komponenter
Dette dokument dækker FGVHR-servicen. Der udstilles et enkelt komponent af typen SOAP Webservice.
Type: SOAP Webservice
Filnavn: fgvhr.war
Url: <serverurl>/fgvhr
Status-url: <serverurl>/fgvhr/status
- DKS-config: <serverurl>/fgvhr/20230601/dksconfig
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.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 |
| 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 |
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 en overvågningsside, som kan tilgås fra adressen i afsnittet Komponenter
Fortolkning af overvågningsside
Overvågningssiderne 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 | 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 |
| FGVHR | updateConsent | Personlig | citizen-created-date | Hvornår borgeren har underskrevet blanketten |