Innledning

AMQP benyttes for all meldingsutveksling med Helsenorge og meldinger sendes via tjenesten Tjenestebuss.

Helsenorge Messaging støtter basisbehovet for meldingsutveksling via AMQP. Denne benyttes av Helsenorge og tilbys fritt tilgjengelig.

Helsenorge Messaging er tilgjengelig på GitHub: GitHub - helsenorge/Helsenorge.Messaging

Hva endres

Alle som benytter Helsenorge Messaging må oppgradere til nyeste versjon.

Per nå er nyeste versjon 6.0.3. Dersom det er kommet en nyere hovedversjon, anbefales det å ta denne i bruk.

Denne versjonen støtter også bruk av HelseId og oppdatert CPPA tjeneste, alle brukere av Helsenorge Messaging skal derfor:

1. Oppgradere til minst versjon 6.0.3 av Helsenorge Messaging

2. Ta i bruk ny CPPA tjeneste som dokumentert her

Versjoner eldre enn 5.2 av Helsenorge Messaging benytter et SOAP kall til CPPA, dette vil fjernes fra neste hovedversjon av Helsenorge Messaging og det anbefales veldig sterkt å gjøre denne overgangen for å være på en støttet løsning. SOAP kallet vil fases ut, dato for dette er ikke satt ennå.

Alle som ennå ikke har tatt i bruk ny CPPA tjeneste og bruk av HelseID anbefales sterkt å gjøre dette. Alle som bruker versjoner eldre enn 5.0.10 må gjøre det.

Hvorfor gjøres endringen

Det er funnet flere feil i et kodebibliotek (AMQP Net Lite) som benyttes i Helsenorge Messaging. Kodebiblioteket støtter ikke AMQP standarden fullstendig og nyere versjoner av Rabbit MQ som benyttes for Tjenestebuss har innført strengere validering av standarden. Feilen vil medføre at meldinger ikke kan leses fra kø og i praksis stopper all meldingsutveksling opp.

Feil 1 ble fikset i AMQP Net Lite versjon 2.4.8 som ble sluppet 4. januar 2024, feilen er omtalt her: https://github.com/Azure/amqpnetlite/issues/575.

Feil 2 ble fikset i AMQP Net Lite versjon 2.4.9 som ble sluppet 5. mars 2024, feilen er omtalt her: https://github.com/Azure/amqpnetlite/issues/578

Feilene er rettet i Helsenorge Messaging versjon 5.0.10 som ble tilgjengelig 4.4.2024. Klienter som er på versjoner som er nyere enn 5.0.10 vil dermed ikke være berørt av feilen, men bør likevel oppgradere.

NHN har behov for å oppgradere Rabbit MQ jevnlig for å være på en supportert og sikker plattform.

Risiko og mulig behov for hasteendring

Dersom det identifiseres sikkerhetshull i Rabbit MQ kan NHN ha behov for hasteoppgradering. Dersom dette er tilfelle må brukere av eldre utgaver av Helsenorge Messaging hastefikses. For å unngå denne risikoen anbefales det å gjøre tilpasning så raskt som mulig.

Frister

Krav til oppgradert versjon i test: Senest 1.10.2025

Fra denne datoen vil Rabbit MQ kjøre på en oppgradert versjon i test, og klienter som kjører på eldre versjoner vil ikke kunne benytte meldingsutveklsing med Helsenorge

Krav til oppgradert versjon i produksjon: Senest 1.12.2025

Fra denne datoen må alle installasjoner i produksjon være oppdatert.

Generelt vil det stilles krav om oppgradering av Helsenorge Messaging minst hver 6 måned, for å sikre oppdatert funksjonalitet, bruk av kodebibliotek og redusere risiko for senere slike behov for hasteoppdateringer.