Indhold
Komponenter
Dette dokument dækker følgende komponent på NSP:
EHMI Sundhedsadresseringsservice (EAS)
Komponenten omfatter tre services:
EAS:
Servicen skal ikke kunne nås direkte. Ingress foregår via. EAS-Ingress-Nginx service.
Egress fra servicen foregår via. EAS-Egress-Nginx.
Type: HAPI FHIR Plain Server (REST service)
Filnavn: eas.war
Url: Skal kun kunne tilgås igennem EAS-Ingress-Nginx.
Status-url: <serverurl>/eas/status
- Alarm-url: <serverurl>/eas/alarm
- Image: registry.nspop.dk/components/eas
EAS-Ingress-Nginx:
Denne service udstilles som indgangen til EAS komponenten.
- Type: Nginx (TLS Terminering)
- Url: <serverurl>/eas/
- Image: registry.nspop.dk/components/eas-nginx
EAS-Egress-Nginx:
Denne service skal ikke udstilles direkte, men skal istedet kunne kaldes internt fra EAS.
- Type: Nginx (Udadgående mTLS)
- Url: Skal kun kunne tilgås internt fra EAS servicen.
- Image: registry.nspop.dk/components/eas-nginx
Konfiguration
EAS
EAS har sin egen konfiguration i "application.properties", og har desuden fire integrationer, som hver især har sin egen property-fil med konfiguration:
| Integration | Property-fil |
|---|---|
| EER | eer.properties |
| PersonInformation | personinformation.properties |
| SikredeInformation | sikrede.properties |
| SORES | sores.properties |
Indholdet af de enkelte property-filer findes beskrevet herunder:
EAS (application.properties)
| Property | Beskrivelse | Påkrævet | Default værdi |
|---|---|---|---|
| stubbed | Angiver hvorvidt EAS returnerer stubbede svar | Nej | false |
| dk.sds.nsp.audit.DevelopmentAuditProvider.enabled | Hvorvidt audit information logges på stdout som et JSON objekt | Nej | false |
| dk.nsp.eas.audit.component | Komponentnavn til audit-logging | Nej | EAS |
dk.nsp.eas.auth.enabled | Hvorvidt Authentication middleware er slået til - NB. Midlertidig under udvikling. Fjernes igen til endelig release. | Nej | false |
EER (eer.properties)
| Property | Beskrivelse | Påkrævet | Default værdi |
|---|---|---|---|
| eer.api.url | URL til EER service | Ja | |
| oauth2.client.id | OAuth client id | Ja | |
| oauth2.client.secret | OAuth client secret | Ja | |
| oauth2.token.uri | URL til Keycloak OAuth endpoint | Ja |
PersonInformation (personinformation.properties)
| Property | Beskrivelse | Påkrævet | Default værdi | Eksempel |
|---|---|---|---|---|
| personinformation.api.url | URL til PersonInformation service | Ja | http://test1.ekstern-test.nspop.dk:8080/stamdata-personinformation/v1 | |
| personinformation.connectTimeout | HTTP connect timeout | Nej | 30 | 30 |
SikredeInformation (sikrede.properties)
| Property | Beskrivelse | Påkrævet | Default værdi | Eksempel |
|---|---|---|---|---|
| sikrede.api.url | URL til SikredeInformation service | Ja | http://test1.ekstern-test.nspop.dk:8080/stamdata-sikredeinformation/2025/07/17 | |
| sikrede.connectTimeout | HTTP connect timeout | Nej | 30 | 30 |
SORES (sores.properties)
| Property | Beskrivelse | Påkrævet | Default værdi | Eksempel |
|---|---|---|---|---|
| sores.api.url | URL til SORES service | Ja | http://test1.ekstern-test.nspop.dk:8080/sores | |
| sores.connectTimeout | HTTP connect timeout | Nej | 30 | 30 |
EAS-Ingress-Nginx
TLS Terminering
Nedenstående tabel viser hvorhenne i containeren certifikater skal mountes ind, samt hvilken funktion certifikaterne har.
| Fil | Beskrivelse | Påkrævet |
|---|---|---|
/etc/ssl/server.crt | TLS servercertifikat for EAS | Ja |
/etc/ssl/server.key | Privatnøgle for servercertifikat for EAS | Ja |
/etc/ssl/ehmi-ca.pem | Rodcertifikatbundle for udstedende certifikatmyndighed(er) | Ja |
Hostname (eas-host.conf)
Nedenstående tabel beskriver indholdet af eas-host.conf. Konfigurationsfilen indeholder server_name til brug for nginx. Det er påkrævet for, at nginx håndterer request korrekt.
| Property | Beskrivelse | Påkrævet | Default værdi | Eksempel |
|---|---|---|---|---|
server_name | Hostnavn for EAS servicen | Ja | eas.local localhost | test1.ekstern-test.nspop.dk |
EAS-Egress-Nginx
mTLS
Nedenstående tabel viser hvorhenne i containeren certifikater skal mountes ind, samt hvilken funktion certifikaterne har.
| Fil | Beskrivelse | Påkrævet |
|---|---|---|
/etc/ssl/ehmi-auth/client.crt | Klientcertifikat til kommunikation mod EHMI Keycloak | Ja |
/etc/ssl/ehmi-auth/client.key | Privatnøgle for klientcertifikat til kommunikation mod EHMI Keycloak | Ja |
/etc/ssl/ehmi-eer/client.crt | Klientcertifikat til kommunikation mod EHMI EER service | Ja |
/etc/ssl/ehmi-eer/client.key | Privatnøgle for klientcertifikat til kommunikation mod EHMI EER service | Ja |
/etc/ssl/certs/ca-certificates.crt | Rodcertifikatbundle for udstedende certifikatmyndighed(er). Hvis ikke angivet, anvendes standard OS CA Bundle. | Nej |
Endpoints (ehmi-endpoints.conf)
Nedenstående tabel beskriver de variabler der bliver sat for Nginx i filen ehmi-endpoints.conf.
De er nødvendige for at nginx kan forward request fra EAS mod den rigtige service.
| Property | Beskrivelse | Påkrævet | Default værdi | Eksempel |
|---|---|---|---|---|
$ehmi_auth_host | Hostnavn for EHMI Keycloak. Bemærk ingen protokol eller www prefix. | Ja | dk-ehmi-authserver.t1.hosting.kitkube.dk | dk-ehmi-authserver.t1.hosting.kitkube.dk |
$ehmi_eer_host | Hostnavn for EHMI EER Service. Bemærk ingen protokol eller www prefix. | Ja | dk-ehmi-eer-service.t1.hosting.kitkube.dk | dk-ehmi-eer-service.t1.hosting.kitkube.dk |
Overvågning
EAS udstiller en overvågningsside, som findes beskrevet under "Komponenter".
Fortolkning af overvågningsside
Overvågningssiderne returnerer enten:
- HTTP 200, hvis servicen i øjeblikket kører fint.
- HTTP 500, hvis der er opstået en fejl der kræver indgriben.
Auditlogning
Hvert servicekald medfører en ny indgang i auditloggen, som kan være udfyldt med følgende information, afhængig af konteksten:
| Komponent | Kontekst | Nøgle | Information |
|---|---|---|---|
| EAS | GetReceivingOrganizationByPatientId | patient-id message-type | ID på borgeren Beskedtype |
| EAS | GetReceivingOrganizationByGPId | general-practitioner-id message-type | Ydernummer Beskedtype |
| EAS | GetReceivingOrganizationBySORId | sor-id message-type | SOR-kode Beskedtype |
| EAS | GetListOfGpByPostalCode | postal-code | Postnummer |
Baggrundsjobs
EAS er tilstandsløs, og har ingen baggrundsjobs.