SMART App LaunchSubstitutable Medical Applications and Reusable Technologies

O que é

O SMART App Launch, conhecido como «SMART on FHIR», é um guia de implementação da HL7 International que define padrões baseados em OAuth 2.0 para que aplicativos clientes se autorizem, se autentiquem e se integrem a sistemas de dados FHIR. O SMART (Substitutable Medical Applications and Reusable Technologies) nasceu em 2010 como projeto da Harvard Medical School e do Boston Children's Hospital, adotou o FHIR em 2013 e hoje seu guia é publicado pela HL7. Em outubro de 2026, a versão vigente é a STU 2.2 (2.2.0), baseada no FHIR R4.

O que define

• Descoberta: cada servidor publica em .well-known/smart-configuration seus endereços de autorização e as capacidades que suporta.
• Dois padrões de autorização: o lançamento de apps voltados ao usuário e os serviços de backend, para processos automáticos sem usuário, como uma exportação de dados em massa.
• Duas formas de lançar um app: de dentro do prontuário (EHR launch), recebendo o contexto da sessão, como o paciente aberto; ou de forma independente (standalone launch), em que o usuário escolhe ao iniciar.
• Escopos (scopes): permissões expressas com recursos FHIR, por exemplo user/Encounter.rs para ler e buscar os atendimentos aos quais o usuário tem acesso. A sintaxe mudou em relação ao SMART v1.
• Autenticação do cliente: preferencialmente com par de chaves assimétricas (JWT assinado), ou com segredo compartilhado.

Todo app SMART deve suportar PKCE (RFC 7636). Para identificar o usuário, o SMART acrescenta o OpenID Connect com os escopos openid e fhirUser.

Equívocos comuns

• O SMART não é um padrão de dados: não diz o que um recurso contém, apenas quem pode acessá-lo e com quais permissões.
• Um escopo amplo como patient/*.rs dá acesso a muito mais do que um app costuma precisar. O princípio do menor privilégio também vale aqui.
• O servidor decide qual contexto e quais permissões concede. Um app não deve presumir que obteve tudo o que pediu.
• A versão do SMART importa. Segundo o kit de testes (g)(10) do ONC, o US Core 7.0.0 só deve ser usado com o SMART App Launch 2.0.0 ou superior, por seus requisitos de escopos granulares.