SMART App Launch (SMART on FHIR)

SMART App Launch, in de praktijk vaak 'SMART on FHIR' genoemd, is een implementatiegids van HL7 International met basispatronen op OAuth 2.0 (de open standaard voor gedelegeerde toegang) waarmee clienttoepassingen zich autoriseren, authenticeren en integreren met systemen die gegevens via FHIR aanbieden^[1]. Het lost een concreet probleem op: een app van een derde partij moet bij een FHIR-server weten wie de gebruiker is, welke gegevens ze mag zien en in welke context ze gestart werd.

De gids beschrijft twee hoofdpatronen. Het App Launch-patroon autoriseert een app voor een gebruiker en kan 'launch context' meegeven, zoals de patiënt die in de EPD-sessie van de gebruiker geselecteerd is^[1]. Het Backend Services-patroon autoriseert een headless of geautomatiseerde toepassing, zonder dat een gebruiker bij de start betrokken is^[1]. Als voorbeeld van zo'n backend service noemt de gids een analyseplatform of datawarehouse dat periodiek een bulkimport uit een EPD doet om een patiëntenpopulatie te analyseren^[2].

Scopes. SMART drukt toegangsrechten uit in 'scopes' die aan een clienttoepassing gedelegeerd kunnen worden en die steunen op de FHIR-interacties, resourcetypes en zoekparameters^[1]. Sinds versie 2.0 kunnen scopes fijner beperkt worden met de syntaxis van FHIR-zoekparameters^[3].

Ontdekking. Een FHIR-server publiceert een ontdekkingsdocument (.well-known/smart-configuration) waaruit een client de autorisatie-endpoints en de ondersteunde functies leert kennen^[1].

Clientauthenticatie. SMART verkiest authenticatie met een asymmetrisch sleutelpaar boven een gedeeld geheim, omdat er dan geen geheim over het netwerk gaat^[1].

Versie en status. De huidige gepubliceerde versie is 2.2.0 (STU 2.2), gebaseerd op FHIR R4^[1]. In de publicatiehistoriek staat die versie als trial use (FHIR 4.0.1), gepubliceerd op 30 april 2024 en gemarkeerd als huidige versie^[4]. 'Trial use' betekent dat de gids gebruikt kan worden maar nog niet normatief is.

Specificaties die erop voortbouwen

SMART Backend Services is ontworpen om samen te werken met FHIR Bulk Data Access, maar kan voor elke FHIR-API gebruikt worden, synchroon of asynchroon^[2]. CDS Hooks, de HL7-specificatie voor beslissingsondersteuning vanuit de klinische workflow, kan een SMART-app starten wanneer verdere interactie nodig is^[5]. FHIRcast breidt het SMART-launchprotocol uit om afzonderlijke toepassingen nauw te laten samenwerken^[6]. Een overzicht van het bredere FHIR-ecosysteem staat op HL7 FHIR en FHIR-tools, registers en testplatformen.

In de Belgische FHIR-gidsen (Belgische FHIR-implementatiegidsen) en in de eHealth-diensten werd geen gebruik van SMART App Launch of SMART Backend Services gevonden; de hiaat staat in het register. Dat is geen bewijs dat in België gebruikte EPD's of apps SMART niet aanbieden.

De toegang tot Belgische FHIR-REST-diensten loopt via een eigen OAuth-route. Voor de REST-diensten van Vitalink moet de integratie aangevraagd worden via de formulieren van I.AM Connect^[7]. De integratiegids van Vitalink (versie 1.0, oktober 2025) schrijft voor een gedistribueerde toepassing de 'authorization code flow' met PKCE voor, waarbij de gebruiker zich rechtstreeks aanmeldt via de identiteitsprovider en de federatieve autorisatiedienst van het eHealth-platform^[7]. Beide routes steunen dus op OAuth, maar Vitalink verwijst niet naar SMART App Launch^[7].

SMART bepaalt of externe apps, bijvoorbeeld voor beslissingsondersteuning, vanuit het EPD met de geselecteerde patiënt kunnen starten^[1], en of een analyseplatform of datawarehouse zonder gebruiker gegevens uit het EPD kan afhalen^[2]. Er is geen Belgische verplichting gevonden; voor de eHealth-diensten geldt de route via I.AM Connect^[7].

Aanbeveling: vraag bij een EPD- of app-aanbesteding expliciet of het systeem een SMART-ontdekkingsdocument, App Launch en Backend Services aanbiedt, met welke scopes, en hoe dat samengaat met de aanmelding via I.AM Connect voor de eHealth-diensten.

• Of in België gebruikte ziekenhuis-EPD's SMART App Launch of Backend Services aanbieden, werd niet gevonden; leveranciersdocumentatie is niet onderzocht.
• Een opvolger van versie 2.2.0 staat op 12 november 2026 niet in de publicatiehistoriek^[4]; een planning werd niet gevonden.
• Hoe een SMART-autorisatieserver zich verhoudt tot de eHealth-IDP en I.AM Connect, beschrijft geen gevonden Belgische bron.