Introdução à API do Azure para FHIR
Importante
A API do Azure para FHIR será desativada em 30 de setembro de 2026. Siga as estratégias de migração para fazer a transição para FHIR® dos Serviços de Dados de Saúde do Azure até essa data. Devido à desativação da API do Azure para FHIR, novas implantações não serão permitidas a partir de 1º de abril de 2025. O serviço dos Serviços de Dados de Saúde do Azure para serviço FHIR é a versão evoluída da API do Azure para FHIR que permite aos clientes gerenciar os serviços FHIR, DICOM e serviço de tecnologia médica com integrações a outros serviços do Azure.
Este artigo descreve as etapas básicas para começar a usar a API do Azure para FHIR®. A API do Azure para FHIR é uma API em conformidade gerenciada com base em padrões para dados clínicos de saúde que habilita soluções para análises acionáveis e machine learning.
Como pré-requisito, você precisa de uma assinatura do Azure e das permissões adequadas para criar grupos de recursos do Azure e implantar recursos do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
Criar recurso do Azure
Para começar a usar a API do Azure para FHIR, você deve criar um recurso no portal do Azure. Insira a API do Azure para FHIR na caixa Serviços de pesquisa e marketplace.
Depois de localizar o recurso da API do Azure para FHIR, selecione Criar.
Implantar a API do Azure para FHIR
Consulte as etapas no guia de Início Rápido para implantar uma instância da API do Azure para FHIR usando o portal do Azure. Você também pode implantar uma instância da API do Azure para FHIR usando o PowerShell, a CLI e um modelo do ARM.
Acessar a API do Azure para FHIR
Ao trabalhar com dados de saúde, é importante garantir que os dados estejam seguros e que não possam ser acessados por usuários ou aplicativos não autorizados. Os servidores FHIR usam o OAuth 2.0 para garantir essa segurança de dados. A API do Azure para FHIR é protegida usando o Microsoft Entra ID, que é um exemplo de um provedor de identidade OAuth 2.0. A configuração de identidade do Microsoft Entra para a API do Azure para FHIR oferece uma visão geral da autorização do servidor FHIR e as etapas necessárias para obter um token para acessar um servidor FHIR. Embora essas etapas se apliquem a qualquer servidor FHIR e a qualquer provedor de identidade, este artigo aborda a API do Azure para FHIR como servidor do FHIR e o Microsoft Entra ID como nosso provedor de identidade. Para obter mais informações sobre como acessar a API do Azure para FHIR, consulte Visão geral do controle de acesso.
Validação de token de acesso
A forma como a API do Azure para FHIR valida o token de acesso depende da implementação e configuração. O artigo Validação de token de acesso da API do Azure para FHIR guia pelas etapas de validação, o que pode ser útil ao solucionar problemas de acesso.
Registrar um aplicativo cliente
Para que um aplicativo interaja com o Microsoft Entra ID, ele precisa ser registrado. No contexto do servidor FHIR, há dois tipos de registros de aplicativo:
- Registros de aplicativo de recurso,
- Registros de aplicativo cliente.
Para mais informações sobre os dois tipos de registros de aplicativos, consulte Registrar os aplicativos do Microsoft Entra para a API do Azure para FHIR.
Configurar o RBAC do Azure para FHIR
O artigo Configurar o Azure RBAC para FHIR descreve como usar o RBAC do Azure (controle de acesso baseado em função do Azure) para atribuir acesso ao plano de dados da API do Azure para FHIR. O RBAC do Azure é o método preferido para atribuir acesso ao plano de dados quando os utilizadores do plano de dados são gerenciados no inquilino Microsoft Entra associado à sua subscrição do Azure. Se você estiver usando um locatário externo do Microsoft Entra, consulte a referência de atribuição de RBAC local.
Próximas etapas
Este artigo descreveu as etapas básicas para começar a usar a API do Azure para FHIR. Para obter mais informações sobre a API do Azure para FHIR, consulte
Observação
FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.