Repository navigation
0.0.16
·
159 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
Security fixes until 2031-11-05, 5 years from this release (Regulation (EU) 2024/2847 Art 13(8), (19)), shipped only in the newest release (Art 13(10)). This release is supported while it is the newest; upgrade to the newest release to get a fix, as SECURITY.md says.
Upgrade notes
- Write
server.public_url,server.replicaand
server.bindings_drain_timeout_msasgateway.public_url,
gateway.replicaandgateway.bindings_drain_timeout_ms, and
server.overload_retry_after_sasserver.retry_after_s, with the
FERROFED__overrides to match (FERROFED__GATEWAY__PUBLIC_URL). This
release refuses each old key at start-up and inconfig check(#1490). - Nothing in an operator console's configuration has to change (#1504). The
[oidc]endpoints are now optional: removeauthorization_endpoint,
token_endpointandjwks_urito have the console discover them from
issuerwhen it starts, which then needs the provider reachable at start.
A reverse proxy in front of the console passes/sessionthrough to it. - Remove
[server] site_rootandFERROFED_CONSOLE__SERVER__SITE_ROOT
from the operator console's configuration: the console serves no site
bundle, and this release refuses the key at start-up and in
config check, naming it (#1512).
Added
- The document list names the laboratory reports of a member that serves
them itself as an HL7 Europe EU Health Data API Document Access Provider
(anhl7-fhir-restendpoint declared forLaboratory-Reports): the
member is asked by its ownehr_idalone withPatient?identifier=and
DocumentReference?patient=&type=, and is left out of the laboratory
report query. Each of itsDocumentReferences is listed as it holds it,
with each attachment URL readdressed to aBinary/{token}URL the gateway
signs, and the read answers the member'sBinaryunchanged. A member that
does not answer fails the list under all-or-nothing, and each list and
read is recorded underLaboratory-Reports. - The FHIR face withdraws a dispensation it received:
PUT {fhir-base}/MedicationDispense/{id}withstatusentered-in-error, by
the id the receipt'sLocationnamed, is held to
MedicationDispense-eu-mpd, read at the member that id names, and sent
there once as an update by the member's own id, its body unchanged but for
its top-levelid(FHIR R4http.html§3.1.0.4). A body whoseidis
not the request's is400, any otherstatus422, the member's refusal
409and its silence504; the withdrawal is recorded as an update under
Electronic-Dispensations, andmetadatadeclaresupdatefor
MedicationDispense. MyHealth@EU 07.04 is met (#1468). - The operator console serves the session watch,
GET /sessionand
POST /session, which answer the idle and absolute lifetime the session
has left and401once it is gone, so a page warns before the idle
timeout and every tab ends together (#1505). - The book shows how to receive a laboratory report on the FHIR face: the
[[fhir.receive]]member forLaboratory-Reportswith the HL7 Europe
Laboratory Report 2.0.0 package, theKDS_Laborberichttemplate and the
laboratory mappingeehrxfships, and what the composition keeps of a
result. A server test now receives a synthetic report end to end. - The document list (
GET {fhir-base}/DocumentReference) names each
member's laboratory reports when a[[fhir.receive]]entry receives
Laboratory-Reports: oneEehrxfMhdDocumentReferenceof the type
11502-2per laboratory composition, read at aBinary/{token}URL the
gateway signs, which writes the composition as an HL7 Europe Laboratory
Report 2.0.0Bundle-eu-labthrough the laboratory mapping ofeehrxf.
A member that does not answer the laboratory query fails the list under
all-or-nothing, and each list and read is recorded under
Laboratory-Reports. - Two read-only stored queries in the reserved namespace,
eu.ferrofed.eehrxf::medication-ordersand
eu.ferrofed.eehrxf::medication-actions: each patient's compositions that
hold a medication order (imported copies left out) or a medication action,
with each composition's uid and template, which the prescription face's
map mode reads a member through. - A
[[fhir.serve]]member ofElectronic-Prescriptionscan be declared
in the map mode,{ member = "node-a", mode = "map", template = "…" },
with its operational template: an OPT 1.4, or an ADL 2 template with the
archetypes it specialises. The face then reads the member's medication
orders over ITS-REST witheu.ferrofed.eehrxf::medication-orders, keeps
the compositions the member's own system created, and maps each into an
HL7 Europe MPD 1.0.0MedicationRequest-eu-mpdthrough the MPD project
ofeehrxf, listed beside the native members' prescriptions and read by
the id the search names. The start andconfig checkrefuse a template
the project does not compile against. - A dispensation of a prescription a map-mode member owns is written at
that member as one openEHR composition: the received
MedicationDispense-eu-mpdis mapped by the MPD project ofeehrxf, its
ACTIONnames the order it carries out by the order's
OBJECT_VERSION_ID, and the face creates it once with
composition_create. A map-mode member named in
Electronic-Dispensationsnames thelanguageandterritoryits
compositions are written in, andconfig checkrefuses it without them.
A dispensation the owner already keeps under the same business
identifier is refused409with nothing written.
Changed
- Moved to the
openehr-*crates 0.0.116 with FerroBRIDGE'seehrxf
0.1.142,fhirconnect0.1.212,openehr-mapping-core0.1.138,
ferrobridge-term0.1.141 andferrobridge-validator0.1.143, the
versions those crates require of one another. The ITS-REST decoders now
read a+in a query value as a literal plus (RFC 3986 §2.1), so the
gateway no longer rewrites a client's+before decoding, and a node's
RFC 9457 problem details refusal is read through the crate. A+in a
query value and a node's refusal behave as before. - A FHIR document the gateway maps from openEHR writes an archetype-local
code underhttps://ferrobridge.eu/fhir/CodeSystem/archetype-local/, the
baseeehrxf0.1.142 writes, in place of
https://ferrofed.eu/fhir/CodeSystem/archetype-local/. A consumer that
matches the old system URI matches the new one. [[fhir.receive]]can name a receiving member forLaboratory-Reports,
whicheehrxf0.1.142 receives as an HL7 Europe Laboratory Report 2.0.0
document;config checknames it among the categories with no receiving
member until one does.- The remaining-dispensations extension is named
https://ferrobridge.eu/fhir/StructureDefinition/remaining-dispensations,
aseehrxf0.1.142 defines it and FerroBRIDGE publishes it, and the
documentation site no longer serves a copy at
https://ferrofed.eu/fhir/StructureDefinition/remaining-dispensations. The
gateway still carries the extension as the member wrote it. - The operator console draws every page whole on its server with FerroUI
0.6.0 and runs no WebAssembly (#1457). A link loads its page as one
document, a form posts to the page it sits on and answers there, and
FerroUI's small script modules add the menus, the dialogs, the row
editing, the find's suggestions and the commit-confirm countdown on top;
every page reads and every action posts with scripts turned off. The page
no longer flickers or loses what was open when you act on it, and the
404 page no longer panics in the browser (#1458). The console's
Content-Security-Policy admits scripts and stylesheets from its own
origin alone (script-src 'self'; style-src 'self', no nonce and no
'wasm-unsafe-eval'), and FerroUI's stylesheet, theme and modules are
served under/ferrohealth-ui/0.6.0/, cached for a year, in place of
/ferrohealth-ui.css,/ferrofed.cssand the site bundle under/pkg/.
The console image carries the binary alone. - The operator console moves to FerroUI 0.6.2 and
ferrohealth-server
0.4.2. A select in a dense options row and a long identifier or link in
a stacked table no longer scroll the page sideways at 320 px, and the
code editor keeps its typing speed as a JSON or XML document grows. The
console's Content-Security-Policy is unchanged (script-src 'self'; style-src 'self', no nonce) and now comes from the family's
server-rendered console headers, FerroUI's script modules are served
under/ferrohealth-ui/0.6.2/, and About names FerroUI 0.6.2. - The gateway implements the Federation Tier with AQL 1.0.1, the erratum
to the routing of EHR-scoped version requests (§12.3, §12.4, §12.5.1,
N22, N23, N36, N41). A request under{base}/v1/ehr/{ehr_id}/…, a
version read or a versioned write, is located by the targeting header,
the caller's binding and theehr_idindex as before, and now, when
none of them names a node and the path carries a version uid, by the
member whosesystem_idis that uid'screating_system_id; an
untargeted read of such a version reaches its creator without an
ask-all probe, and a compositionDELETEwhose version a member
created reaches that member where it was a400 target-required. A
read that reaches a node holding an imported copy returns the copy with
openEHR-federation-system-idnaming that node, and a write that
reaches it is refused409naming the controlling system and is never
redirected.OPTIONS {base}/still reportsspec_version"1.0". - The operator console signs in and keeps its sessions through
ferrohealth-session0.1.1, the family's console sign-in, over
ferrohealth-smart's relying party; its own sign-in, session store and
code exchange are gone (#1504, #1506). The routes stayGET /login,
GET /auth/callbackandPOST /logout, and the cookies keep their names. - With
[oidc] issueralone, the console reads the provider's endpoints from
its discovery document at start (OpenID Connect Discovery 1.0 §4); a
missing or unreachable document refuses the start, andconfig check
never asks the provider.[oidc]gainsrevocation_endpoint,ca_file
andtimeout_s, and[session]gainsstore,keyandkey_filefor a
console that runs as several instances. - A sign-out with no
[oidc]ends the session and lands on/in place of
answering503, and a refresh the provider cannot be reached for keeps
the session for the next request in place of ending it. - Moved to FerroPIX's
ihe-iti0.0.73 andnl-generic-functions0.0.40
(#1516). The mCSD directory is read throughihe-iti's
DirectoryEntry<Endpoint>, and the NVI client and the Nuts grant take the
request authorizerihe-itinow carries. The gateway's behaviour does not
change. - Moved to FerroBRIDGE's
eehrxf0.1.149 withfhirconnect0.1.218,
openehr-mapping-core0.1.141 andferrobridge-validator0.1.144, on
theopenehr-*crates 0.0.128. - The patient summary selects its medication entries by the template
section that holds them, aseehrxf's
crosswalk::patient_summary::SOURCESplaces them: the medication summary
takes a medication order under an ad hoc section, and the immunisations a
medication action under the vaccination list section. A vaccine recorded
as a medication action no longer reaches the medication summary, and a
medication action under any other section reaches no section; record
current medication as orders. - A
[[fhir.mapping]]takes an ADL 2templatewith thearchetypesit
specialises, beside an OPT 1.4.opt. - Moved to
ferrohealth-server0.4.3,ferrohealth-session0.2.2,
ferrohealth-smart0.8.8,ferrohealth-ui0.6.6,ihe-iti0.0.74,
nl-generic-functions0.0.41, and FerroBRIDGE'seehrxf0.1.152 with
fhirconnect0.1.219. A received document's element that a status table
of the mapping carries is no longer reported as lost, and the imaging and
discharge codings carry the HL7 Europe EU Health Data API displays. The operator console draws its pages with
FerroUI 0.6.6, and the book's console screenshots are taken again. - The operator console's sign-out goes to the provider's
end_session_endpointonly when the session it ends holds an ID Token
(OpenID Connect RP-Initiated Logout 1.0 §2). A sign-out with no session
left, or one after a Basic sign-in, goes back to/.
Removed
- The operator console's site bundle (its WebAssembly, the
/pkg/route
that served it compressed, and the bundle budget), the
scripts/release/console-site.sh,console-tools.sh,
scripts/checks/console-bundle.shandconsole-paths.shscripts, and the
Leptos, cargo-leptos, wasm-bindgen, wasm-opt and leptosfmt pins (#1457).
A deployment that built the console itself runscargo build --release -p ferrofed-consolealone. openehr-federation0.0.57 dropsobject::Extra::newand
order::ResultOrder::unordered, each the same as the type'sDefault.
A caller writesExtra::default()andResultOrder::default()(#1485).- The four
[server]keys that 0.0.15 still read under their old names:
server.public_url,server.replicaand
server.bindings_drain_timeout_ms, now onlygateway.public_url,
gateway.replicaandgateway.bindings_drain_timeout_ms, and
server.overload_retry_after_s, now onlyserver.retry_after_s. An old
key is an unknown key, whichserveandconfig checkrefuse by its
name, andconfig checkand the start-up log no longer name deprecated
keys (#1490). [server] site_rootof the operator console, and its
FERROFED_CONSOLE__SERVER__SITE_ROOToverride: the console serves no
site bundle, so the key is an unknown key, whichserveand
config checkrefuse by its name (#1512).
Fixed
- The prescriptions page no longer describes a withdrawal of a dispensation
as routed: the FHIR face offers none, and a dispensation sent again under
the same identifier withstatusentered-in-erroris refused409
duplicatelike any other, which a test now holds. The MyHealth@EU
self-assessment row 07.04 says the same (#1450).
Information and instructions to the user (CRA Annex II)
CRA information and instructions to the user: the manufacturer, the vulnerability contact, the support period of every release, secure use, updates and decommissioning (Regulation (EU) 2024/2847 Art 13(18) and Annex II).