SMART App LaunchSubstitutable Medical Applications and Reusable Technologies

Qué es

SMART App Launch, conocida como «SMART on FHIR», es una guía de implementación de HL7 International que define patrones basados en OAuth 2.0 para que aplicaciones cliente se autoricen, se autentiquen y se integren con sistemas de datos FHIR. SMART (Substitutable Medical Applications and Reusable Technologies) nació en 2010 como proyecto de Harvard Medical School y Boston Children's Hospital, adoptó FHIR en 2013 y hoy su guía la publica HL7. A octubre de 2026, la versión vigente es la STU 2.2 (2.2.0), basada en FHIR R4.

Qué define

• Descubrimiento: cada servidor publica en .well-known/smart-configuration sus direcciones de autorización y las capacidades que soporta.
• Dos patrones de autorización: el lanzamiento de apps orientadas al usuario y los servicios de backend, para procesos automáticos sin usuario, como una exportación masiva de datos.
• Dos formas de lanzar una app: desde dentro de la historia clínica (EHR launch), que recibe el contexto de la sesión, como el paciente abierto; o de forma independiente (standalone launch), donde el usuario elige al iniciar.
• Ámbitos (scopes): permisos expresados con recursos FHIR, por ejemplo user/Encounter.rs para leer y buscar los encuentros a los que el usuario tiene acceso. La sintaxis cambió respecto de SMART v1.
• Autenticación del cliente: preferentemente con par de claves asimétricas (JWT firmado), o con secreto compartido.

Toda app SMART debe soportar PKCE (RFC 7636). Para identificar al usuario, SMART añade OpenID Connect con los ámbitos openid y fhirUser.

Errores frecuentes

• SMART no es un estándar de datos: no dice qué contiene un recurso, solo quién puede acceder y con qué permisos.
• Un ámbito amplio como patient/*.rs da acceso a mucho más de lo que una app suele necesitar. El principio de mínimo privilegio aplica también aquí.
• El servidor decide qué contexto y permisos concede. Una app no debe asumir que obtuvo todo lo que pidió.
• La versión de SMART importa. Según el kit de pruebas (g)(10) de la ONC, US Core 7.0.0 solo debe usarse con SMART App Launch 2.0.0 o superior, por sus requisitos de ámbitos granulares.