Indledning

Nærværende dokument udgør designdokumentet for FIBS (Fødselsindberetnings-servicen). FIBS fungerer som  webservice gateway som modtager indberetninger som følger Den Gode Webservice (DGWS) til Kirkeministeriets (KM) jordemoder-service og transformerer dem til webservice protokollen OWSA Model T som jordemoder-service benytter.

Komponenten er udviklet som en Java webapplikation baseret på Spring frameworket. Leverancen af FIBS komponenten sker som et Docker image baseret på det standard NSP Base Image, som anvendes bredt til NSPs forretnings- og støtteservices.

Arkitekturoverblik

Som webservice gateway er komponenten placeret mellem klienten, typisk et regionalt fagsystem, og service-udbyderen, her Kirkeministeriets jordemoder-service.

Jordemoder-servicen udstilles på internettet over én-vejs SSL og følger protokollen OWSA model T [OWSA].

FIBS komponentens udstiller jordemoder-servicen som fødselsindberetningsservice der følger Den Gode Webservice. Dette illustreres i nedenstående figur:

Logisk arkitektur

Komponenten er implementeret med et web service endpoint, som danner indgangspunktet for indkommende webservice kald.

Ved opstart af komponenten indlæses konfigurationen - herunder keystore som indeholder nøgleparret der benyttes til signering af udgående beskeder til jordemoder-servicen. For detaljer se FIBS - Installationsvejledning.

Når en besked modtages fra et fagsystem til videreforsendelse til jordemoder-servicen, gennemløbes følgende flow:

1. Beskeden parses. Hvis ikke beskeden overholder DGWS standarden returneres en fejlbesked til fagsystemet.
2. SOSI idkortet i beskeden valideres. Hvis ikke idkortet er gyldigt, signeret af STS’en og på niveau 3 eller højere returneres en fejlbesked til fagsystemet.
3. Beskeden transformeres til OWSA model T. Axis2 modulet Rampart benyttes til at signere beskeden.
4. Beskeden sendes til jordemoder-servicen. Hvis kommunikationen med jordemoder-servicen fejler returneres en fejlbesked til fagsystemet.
5. Svaret fra jordemoder-servicen transformeres til et DGWS svar og sendes tilbage til fagsystemet.

Referencer