sundhed.dk: Teknik

Vær opmærksom på at IP-whitelistinger har en gyldighedsperiode, som kan udløbe.
Hvis du er i tvivl om IP-whitelisting hos sundhed.dk er på plads, så har du mulighed for selv at teste det.

Besøg https://epjlogindemo.sdkdev.dk/. Hvis denne side kan vises er whitelisting på plads.

Da det er klientens udgående IP der whitelistes er det vigtigt at du besøger ovennævnte side fra samme IP-nummer som klienten.
Du kan se dit ip nummer på https://ipnr.dk/.

Leverandører af en sundhedsjournal-integration bliver IP-whitelistet til sundhed.dk’s demo miljø. Whitelistingen er på IP-nummer. Det whitelistede IP-nummer er leverandørens udgående IP-nummer for leverandørens test-system.


På https://epjlogindemo.sdkdev.dk vises sundhed.dk's test IdP for demo-miljøet.


Denne side kan kun tilgås hvis det foregår med det whitelisted udgåede IP-nummer.
Du kan se dit ip nummer på https://ipnr.dk/

På IdP-siden kan brugeren vælge en faglig og en test-patient. Efter tryk på [Login]-knappen nederst vises sundhedsjournalen i browseren:


På den måde kan man teste en vilkårlig browser, og undersøge om sundhedsjournalen vises korrket.

Hvis der er problemer kan det måske hjælpe at se på log-vieweren https://logviewer-sosilogin-demo.sdkdev.dk/

Specielt for V2 endpointet:

Når et login forsøges, valideres den oplyste SOR organisation. Hvis denne validering fejler returneresen besked som denne: (HTTP 400, Bad Request)
{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"One or more validation errors occurred.","status":400,"traceId":"[ID]","errors":{"IsValidWorkplace":["No valid workplace for [CVR]"]}}

Krav til SOR koden:
1. SOR kode og CVR nummer skal tilhøre samme organisation.
2. SOR koden opfylder et af følgende krav:
 - a. 'almen lægepraksis' eller 'speciallægepraksis'
 - b.  organisationen er CVR whitelistet

Et SOSI-Id kort er et xml-token til brug i sundhedsdomænet.

Et SOSI-id kort kan tilvejebringes på flere forskellige måder. Nogle systemer henter den on-demand, andre henter dem når en medarbejder logger ind ved fremmøde på arbejdsstedet.
En mulighed er at logge ind med MitId via SEB brokeren og så omveksle bootstrap-token'et til et SOSI-Id kort.

Du kan finde mere information om SOSI-id kort, og om hvordan du kan få fat i et her:

https://www.nspop.dk/pages/viewpage.action?pageId=125490979

D. 05-19-2021 annoncerede Microsoft at Internet Explorer har nået End of Life, og at support slutter d. 15. juni 2022.
https://techcommunity.microsoft.com/t5/windows-it-pro-blog/internet-explorer-11-desktop-app-retirement-faq/ba-p/2366549

IE11 bygger på Microsofts Trident Engine, som er en integreret del af Windows 10. Trident Engine'en følger Windows 10 lifecycle, og vil tidligst nå End of Life i 2029.

Der er sikkert en del integrationer til sundhed.dk's sundhedsjournal, som er baseret på en indlejret browser - som benytter Trident Engine'en.

Således vil sundhedsjournalens integration være bundet til at understøtte Trident, indtil der ikke er flere af disse gamle integrationer. På nuværende tidspunkt er der ikke planner om at ændre dette, men det vil være ærgeligt at basere nye integrationer på en gammel engine.

Derfor vil jeg opfordre nye integrationer til at overveje andre muligheder.

Microsoft kommer selv med en anbefaling her:
https://docs.microsoft.com/da-dk/microsoft-edge/webview2/

Webview2 benytter Chromium engine'en som også benyttes i Google Chrome, Microsoft Edge og i Opera Browseren.

Følgende konfigurationer er nødvendige for at testklienen kan afvikles.

Testklienten kan teste både version 1.x og version 2.x integrationer.

Installation af Microsoft IIS
Webserver-featuren skal installeres på din pc.

Rettelse i hostfil
Følgende linje tilføjes til tekstfilen hosts (uden fileextention)
Filen kræver administrative rettigheder at rette.

C:\Windows\System32\drivers\etc\hosts
127.0.0.1 testklient.dk
Download den vedhæftede zip-fil og pak den ud
I eksemplet her gør jeg det til folderen
C:\testklient.dk
Oprettelse af testklient.dk website i IIS
Opret websitet testklient.dk
Sitename: testklient.dk
Applicationpool: testklient.dk
Physical path: C:\testklient.dk
Bind sitet til
Type: HTTP
Hostname: testklient.dk
port: 80
Sæt denne environment variable
SDK_ENVIRONMENT=DMO
Endpoints
V1 og V2 har hver deres endpoint, og hver deres schema. Begge dele fremgår af zip filen med eksemplet.
Url'er på endpoints står i web.config filen som ligger i roden.
Schema for hhv v1 og v2 findes her:
/App_Data/v1/
/App_Data/v2/

Endpoints til produktion udleveres i forbindelse med certificering.

Test i browser
Åben http://testklient.dk i din browser
Først vises klienten og ved tryk på [login] kommer du til sundhedsjournalen på testmiljøet demo.

Husk at det IP nummer du kalder fra skal whitelistes hos sundhed.dk, ellers får du ikke adgang. Den organisation som dine credentials viser du kommer fra skal også være en listet som en sundhedsorganisation hos sndhed.dk.

Se koden
Åben visual Studio som administrativ bruger
I VS åben solution filen "EpjWebTestClient.sln"
Start session med F5. Du ser nu testklient.dk i din defaultbrowser i debug mode.
Herfra kan du undersøge nærmere hvordan testklienten virker.

Troubleshooting
I forbindelse med opsætning af test-klienten er her et par fif:

1. Dette lille script kan løse nogle TLS udfordringer på windows
@echo on
REG ADD "HKLM\SOFTWARE\Wow6432Node\Microsoft\.NetFramework\v4.0.30319" /v "SchUseStrongCrypto" /t REG_DWORD /d 1
REG ADD "HKLM\SOFTWARE\Microsoft\.NetFramework\v4.0.30319" /v "SchUseStrongCrypto" /t REG_DWORD /d 1
pause
Kør det som en .bat fil

2. Denne lille konfiguration kan løse en crypto udfordring, hvis man kører Microsoft Internet Information Service (IIS)
På App poolen, advanced settings, Proces Model section, sæt
Load User Profile = true

Sekvensdiagram for kald til sundhedsjournalen fra fagsystem 1.8.0 og 2.0
Diagrammet viser den generelle sekvens for kald (diagrammet dækker mere end vejledningen)

Den er fin 🙂