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 o serviço 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 FHIR dos Serviços de Dados de Saúde do Azure é a versão evoluída da API do Azure para FHIR que permite aos clientes gerir serviços FHIR, DICOM e MedTech com integrações noutros serviços do Azure.
Este artigo descreve as etapas básicas para começar a usar a API do Azure para FHIR.® O Azure API for FHIR é uma API conforme gerida e baseada em normas para dados da área dos cuidados de saúde que permite a utilização de soluções para análises acionáveis e machine learning.
Como pré-requisito, você precisa de uma assinatura do Azure e recebeu permissões adequadas para criar grupos de recursos do Azure e implantar recursos do Azure. Se não tiver uma subscrição 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.
Implementar o Azure API for 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 PowerShell, CLI e um modelo ARM.
Acessando a API do Azure para FHIR
Ao trabalhar com dados de saúde, é importante garantir que os dados estejam seguros e 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 fornece 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 estas etapas se apliquem a qualquer servidor FHIR e a qualquer provedor de identidade, este artigo aborda a API do Azure para FHIR como o servidor FHIR e a ID do Microsoft Entra 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 do token de acesso
Como a API do Azure para FHIR valida o token de acesso depende da implementação e da configuração. O artigo Azure API for FHIR access token validation orienta você pelas etapas de validação, que podem ser úteis na solução de problemas de acesso.
Registar uma aplicação cliente pública
Para que um aplicativo interaja com o Microsoft Entra ID, ele precisa ser registrado. No contexto do servidor FHIR, existem dois tipos de registos de aplicações:
- Registros de aplicativos de recursos,
- Registos de aplicações cliente.
Para obter mais informações sobre os dois tipos de registros de aplicativos, consulte Registrar os aplicativos do Microsoft Entra para API do Azure para FHIR.
Configurar o RBAC do Azure para FHIR
O artigo Configure Azure RBAC for FHIR, descreve como usar o controle de acesso baseado em função do Azure (Azure RBAC) para atribuir acesso à API do Azure para o plano de dados FHIR. O RBAC do Azure é o método preferencial para atribuir acesso ao plano de dados quando os usuários do plano de dados são gerenciados no locatário do Microsoft Entra associado à sua assinatura do Azure. Se você estiver usando um locatário externo do Microsoft Entra, consulte a referência de atribuição RBAC local.
Próximos passos
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
Nota
FHIR® é uma marca registada da HL7 e é utilizada com a permissão da HL7.