
SMART on FHIR®: como aplicações acessam dados clínicos com segurança?
As aplicações digitais têm se tornado cada vez mais importantes para apoiar o cuidado em saúde, ampliar o acesso às informações e incorporar novas funcionalidades aos fluxos clínicos. Calculadoras de risco, painéis de acompanhamento, ferramentas de suporte à decisão, aplicativos voltados ao paciente e serviços automatizados podem auxiliar profissionais, organizações e pacientes na utilização dos dados clínicos de forma mais oportuna e contextualizada.
Para desempenhar essas funções, contudo, as aplicações precisam se conectar aos prontuários eletrônicos e a outros demais sistemas de saúde. Esse acesso não pode ocorrer de forma ampla ou indiscriminada, pois é necessário garantir que cada aplicação esteja devidamente autorizada, receba apenas os dados necessários e opere dentro do contexto clínico adequado.
É justamente nesse cenário que se insere o SMART on FHIR®, ao combinar o acesso padronizado aos dados clínicos com mecanismos de autorização, identidade e compartilhamento de contexto.
O que é SMART on FHIR®?
SMART on FHIR® é uma arquitetura baseada em padrões abertos que permite integrar aplicações a sistemas de saúde de forma segura e contextualizada. Ela combina principalmente:
- HL7® FHIR®, para representar e acessar dados clínicos;
- OAuth 2.0, para autorização;
- OpenID Connect, para autenticação e identificação do usuário;
- Mecanismos de Contexto Clínico, utilizados para informar à aplicação dados como paciente, encontro e ambiente FHIR.
De forma simplificada: Usuário → Aplicação SMART → Autorização → API FHIR → Dados clínicos
O objetivo é permitir que uma aplicação acesse informações disponibilizadas por um sistema clínico sem precisar conhecer toda a sua estrutura interna.
Como ocorre o acesso aos dados?
Antes de acessar os dados clínicos, a aplicação precisa obter autorização.
Quando a aplicação é iniciada, o usuário é direcionado ao servidor de autorização do sistema de saúde. Nesse momento, ele pode autenticar-se e visualizar as permissões solicitadas.
Após a autorização, a aplicação recebe um access token. Esse token funciona como uma credencial temporária e deve ser incluído nas requisições enviadas à API FHIR:
Authorization: Bearer {{access_token}}
Com um token válido, a aplicação pode solicitar os recursos permitidos, como:
Patient;Observation;Condition;MedicationRequest;Encounter.
O servidor verifica se o token:
- é válido;
- ainda não expirou;
- possui os escopos necessários;
- foi emitido para o servidor FHIR correto;
- permite o acesso ao recurso solicitado.
Assim, não basta que a aplicação esteja conectada ao sistema. Ela precisa estar autorizada para executar cada interação.
O papel dos escopos de acesso
Os escopos indicam quais tipos de dados e operações foram autorizados. Uma aplicação pode, por exemplo, receber permissão apenas para:
- ler dados do paciente atual;
- consultar observações clínicas;
- acessar prescrições;
- obter informações sobre o usuário autenticado.
Isso permite aplicar o princípio do menor privilégio: a aplicação deve receber somente as permissões necessárias para cumprir sua finalidade.
Uma ferramenta para visualização de exames, por exemplo, não precisa necessariamente acessar todos os dados disponíveis no prontuário.
🎯 Aplicações iniciadas a partir do prontuário eletrônico
Uma das principais características do SMART on FHIR é a possibilidade de iniciar uma aplicação diretamente a partir de um prontuário eletrônico.
Nesse cenário, a aplicação pode receber automaticamente informações de contexto, como:
- o paciente selecionado;
- o encontro clínico em andamento;
- a identidade do profissional;
- o endereço do servidor FHIR;
- o servidor responsável pela autorização.
Isso permite que a aplicação seja aberta já contextualizada.
Um profissional pode, por exemplo, selecionar um paciente no prontuário e iniciar uma aplicação de cálculo de risco para uma patologia em específico. A ferramenta recebe o contexto do paciente e consulta apenas os dados autorizados necessários para o cálculo.
Dessa maneira, evita-se que o usuário precise pesquisar novamente o paciente ou inserir manualmente informações já disponíveis no sistema.
🎯Aplicações desenvolvidas para o paciente
O SMART on FHIR também pode ser utilizado em aplicativos desenvolvidos para o paciente. Nesse caso, o próprio paciente pode autorizar uma aplicação a acessar determinados dados de saúde, como:
- resultados laboratoriais;
- condições clínicas;
- medicamentos;
- consultas;
- dados demográficos.
A aplicação recebe apenas as permissões concedidas e utiliza a API FHIR para recuperar as informações.
Essa arquitetura pode apoiar portais, aplicativos móveis, ferramentas de acompanhamento e soluções de participação do paciente no cuidado.
🎯Aplicações em segundo plano
Nem todas as aplicações dependem de interação contínua com um usuário.
Serviços executados em segundo plano também podem acessar APIs FHIR, desde que sejam previamente autorizados.
Alguns exemplos incluem:
- geração de indicadores;
- monitoramento de resultados críticos;
- identificação de eventos clínicos;
- envio de alertas;
- avaliação de qualidade;
- processamento automatizado de dados.
Nesses casos, a autorização pode ocorrer por meio de fluxos específicos para aplicações de sistema, sem exigir que um usuário esteja presente em cada execução.
Por que SMART on FHIR® é relevante?
O SMART on FHIR® estabelece uma forma padronizada de conectar aplicações aos sistemas clínicos, reunindo:
- acesso aos dados por meio de APIs FHIR;
- autorização baseada em OAuth 2.0;
- autenticação do usuário;
- controle por escopos;
- compartilhamento de contexto clínico;
- integração com fluxos assistenciais;
- suporte a aplicações de usuário e serviços automatizados.
Sua relevância está em permitir que aplicações acessem dados clínicos de maneira controlada, previsível e alinhada à finalidade para a qual foram autorizadas.
Considerações finais
O SMART on FHIR® não é apenas uma forma de consultar uma API. Ele define como aplicações podem ser iniciadas, autorizadas e contextualizadas dentro de um ecossistema de saúde. Uma aplicação SMART não recebe acesso irrestrito ao prontuário. Ela recebe uma credencial temporária, escopos específicos e, quando aplicável, o contexto necessário para executar sua função.
A segurança no SMART on FHIR® não depende apenas de autenticar o usuário, mas de controlar quais dados cada aplicação pode acessar, em qual contexto e por quanto tempo.



