--- id: smart-on-fhir type: Specification type_label: Standaard of specificatie title: SMART App Launch (SMART on FHIR) aliases: - SMART on FHIR - SMART App Launch - SMART Backend Services - hl7.fhir.uv.smart-app-launch names: nl: SMART App Launch (SMART on FHIR) fr: SMART App Launch (SMART on FHIR) en: SMART App Launch (SMART on FHIR) de: SMART App Launch (SMART on FHIR) jurisdiction: - internationaal themes: - identiteit-en-toegang - architectuur-en-infrastructuur - standaardisatie-en-governance lifecycle: trial-use lifecycle_note: 'Trial use: versie 2.2.0 (STU 2.2) van 30 april 2024 is de huidige gepubliceerde versie (HL7-publicatiehistoriek, stand 12 november 2026).' version: 2.2.0 (STU 2.2, FHIR R4) summary: SMART App Launch, kortweg SMART on FHIR, is een HL7-specificatie die op OAuth 2.0 regelt hoe toepassingen toegang krijgen tot een FHIR-server. Een app kan vanuit het EPD starten en de geselecteerde patiënt meekrijgen; een backend service werkt zonder gebruiker. Rechten heten 'scopes' en steunen op FHIR-interacties en zoekparameters. Bulk Data, CDS Hooks en FHIRcast bouwen erop voort. In de Belgische FHIR-gidsen werd geen gebruik gevonden; Vitalink laat toepassingen aanmelden met OAuth en PKCE via I.AM Connect. links: - soort: documentatie url: https://hl7.org/fhir/smart-app-launch/ label: SMART App Launch Implementation Guide (HL7) taal: en - soort: documentatie url: https://build.fhir.org/ig/HL7/smart-app-launch/ label: SMART App Launch - CI-build taal: en - soort: repository url: https://github.com/HL7/smart-app-launch label: HL7/smart-app-launch (GitHub) taal: en last_verified: '2026-11-12' relations: - type: ownedBy direction: uit target: hl7-international target_url: https://ehealth-atlas.be/hl7-international/ status: established - type: dependsOn direction: uit target: fhir target_url: https://ehealth-atlas.be/fhir/ status: established - type: comparedWith direction: uit target: i-am-connect target_url: https://ehealth-atlas.be/i-am-connect/ status: established - type: recommends direction: in target: fhir-bulk-data target_url: https://ehealth-atlas.be/fhir-bulk-data/ status: established release: 2026.11.13-2 url: https://ehealth-atlas.be/smart-on-fhir/ license: CC BY 4.0 --- # SMART App Launch (SMART on FHIR) SMART App Launch, kortweg SMART on FHIR, is een HL7-specificatie die op OAuth 2.0 regelt hoe toepassingen toegang krijgen tot een FHIR-server. Een app kan vanuit het EPD starten en de geselecteerde patiënt meekrijgen; een backend service werkt zonder gebruiker. Rechten heten 'scopes' en steunen op FHIR-interacties en zoekparameters. Bulk Data, CDS Hooks en FHIRcast bouwen erop voort. In de Belgische FHIR-gidsen werd geen gebruik gevonden; Vitalink laat toepassingen aanmelden met OAuth en PKCE via I.AM Connect. ## Wat is het? SMART App Launch, in de praktijk vaak 'SMART on FHIR' genoemd, is een implementatiegids van [HL7 International](https://ehealth-atlas.be/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](https://ehealth-atlas.be/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]. ## Hoe is het opgebouwd? **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](https://ehealth-atlas.be/fhir-bulk-data/), 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](https://ehealth-atlas.be/fhir/) en [FHIR-tools, registers en testplatformen](https://ehealth-atlas.be/fhir-tools/). ## Waar wordt het gebruikt? In de Belgische FHIR-gidsen ([Belgische FHIR-implementatiegidsen](https://ehealth-atlas.be/be-fhir-igs/)) 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](https://ehealth-atlas.be/vitalink/) moet de integratie aangevraagd worden via de formulieren van [I.AM Connect](https://ehealth-atlas.be/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](https://ehealth-atlas.be/ehealth-platform/)[^7]. Beide routes steunen dus op OAuth, maar Vitalink verwijst niet naar SMART App Launch[^7]. ## Wat betekent het voor een ziekenhuis? 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. ## Onzekerheden en tegenstrijdige informatie - 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. ## Relaties - valt onder verantwoordelijkheid van: [HL7 International](https://ehealth-atlas.be/hl7-international/) (vastgesteld)[^1]. Gepubliceerd als HL7-implementatiegids op hl7.org. - hangt technisch af van: [HL7 FHIR](https://ehealth-atlas.be/fhir/) (vastgesteld)[^1]. Autorisatiepatronen voor FHIR-servers, gebaseerd op FHIR R4. - wordt vergeleken met: [I.AM en I.AM Connect (Identity & Access Management)](https://ehealth-atlas.be/i-am-connect/) (vastgesteld)[^7]. Beide steunen op OAuth; Vitalink vraagt de authorization code flow met PKCE via I.AM Connect, niet SMART App Launch. - beveelt aan (inkomend): [FHIR Bulk Data Access ($export)](https://ehealth-atlas.be/fhir-bulk-data/) (vastgesteld)[^8][^2] ## Open vragen - Bieden in België gebruikte ziekenhuis-EPD's een SMART App Launch- of Backend Services-endpoint aan, en met welke scopes? - Komt er een SMART App Launch-versie 2.3 of een STU 3, en wanneer? - Kan een SMART-autorisatieserver in België samenwerken met de eHealth-IDP en I.AM Connect, of blijven het gescheiden werelden? ## Bronnen [^1]: [SMART App Launch Implementation Guide - Home](https://hl7.org/fhir/smart-app-launch/). HL7 International. Opgehaald 2026-11-12, sha256 b50fe78d4bedeb9f… (SRC-cb5a8034c5) [^2]: [SMART App Launch - Backend Services](https://hl7.org/fhir/smart-app-launch/backend-services.html). HL7 International. Opgehaald 2026-11-12, sha256 20ed28915344311f… (SRC-5b357ff62a) [^3]: [SMART App Launch - Scopes and Launch Context](https://hl7.org/fhir/smart-app-launch/scopes-and-launch-context.html). HL7 International. Opgehaald 2026-11-12, sha256 0ecd5d54cd653c86… (SRC-d20b498334) [^4]: [SMART App Launch - package-list.json (publicatiehistoriek)](https://hl7.org/fhir/smart-app-launch/package-list.json). HL7 International. Opgehaald 2026-11-12, sha256 7b233df314e61aa6… (SRC-d7fd853c3a) [^5]: [CDS Hooks Specification 2.0.1](https://cds-hooks.hl7.org/). HL7 International (Clinical Decision Support WG). Opgehaald 2026-11-09, sha256 fc2502606303afe6… (SRC-4d1d913b91) [^6]: [FHIRcast - Home](https://fhircast.hl7.org/). HL7 International. Opgehaald 2026-11-12, sha256 c35977342d809c7c… (SRC-4c3db153d0) [^7]: [Integration Guide for VITALINK v1.0 (10/2025)](https://www.up.ehealth.fgov.be/ehealthplatform/file/cc73d96153bbd5448a56f19d925d05b1379c7f21/288304022e5253c740645e690dc39edd58c126ed/2025-integration-guide-vitalink-v1.0.pdf). eHealth-platform, 2025-10-01. Opgehaald 2026-11-12, sha256 d58607026b45ad32… (SRC-a5f98689c4) [^8]: [FHIR Bulk Data Access - Bulk Data Export](https://hl7.org/fhir/uv/bulkdata/en/export.html). HL7 International. Opgehaald 2026-11-12, sha256 c36bb7ece0de9b7d… (SRC-d4ea422d02)