Partilhar via

Autenticação do conector FHIR

  • Artigo

Este artigo explica o acesso autenticado a servidores FHIR utilizando o conector do Power Query para FHIR. O conector suporta acesso anônimo a servidores FHIR acessíveis publicamente e acesso autenticado a servidores FHIR usando autenticação Microsoft Entra ID (organizacional). A API do Azure para FHIR é protegida com o Microsoft Entra ID.

Nota

Se estiver a ligar a um servidor FHIR a partir de um serviço online, como o serviço Power BI, só pode utilizar uma conta organizacional.

Acesso anónimo

Existem muitos servidores FHIR acessíveis publicamente. Para permitir o teste com estes servidores públicos, o conector do Power Query para FHIR suporta o esquema de autenticação "Anónimo". Por exemplo, para acessar o servidor público https://server.fire.ly :

  1. Insira a URL do servidor Firely público.

    Screenshot of the URL filled in with the public Firely FHIR server.

  2. Selecione Esquema de autenticação anônima .

    Screenshot demonstrating the anonymous authentication selection to access the Firely FHIR server.

Depois disso, siga as etapas para consultar e moldar seus dados.

Autenticação do Microsoft Entra ID (organizacional)

O conector do Power Query para FHIR suporta autenticação OAuth para servidores FHIR protegidos com ID do Microsoft Entra.

Para usar a autenticação do Microsoft Entra ID, selecione Conta organizacional ao se conectar.

Screenshot of the authentication dialog with the Organizational account selected for sign in.

Existem algumas restrições a ter em conta:

  • A Audiência esperada para o servidor FHIR deve ser igual à URL base do servidor FHIR. Para a API do Azure para FHIR, você pode definir isso ao provisionar o serviço FHIR ou posteriormente no portal.

  • Se o servidor FHIR não retornar um cabeçalho de desafio com um WWW-Authenticateauthorization_uri campo em autorização com falha, você deverá usar uma conta organizacional para entrar. Você não pode usar uma conta de convidado em seu locatário do Ative Directory. Para a API do Azure para FHIR, você deve usar uma conta organizacional do Microsoft Entra ID.

  • Se o seu serviço FHIR não for a API do Azure para FHIR (por exemplo, se estiver a executar o servidor Microsoft FHIR de código aberto para o Azure), terá registado uma aplicação de recurso Microsoft Entra ID para o servidor FHIR. Você deve pré-autorizar o aplicativo cliente do Power BI para poder acessar esse aplicativo de recurso.

    Screenshot demonstrating how to preauthorize the Power BI client application.

    A ID do cliente do Power BI é a672d62c-fc7b-4e81-a576-e60dc46e951d.

  • O cliente Power Query (por exemplo, Power BI) solicitará apenas um único escopo: user_impersonation. Esse escopo deve estar disponível e o servidor FHIR não pode depender de outros escopos.

Próximos passos

Neste artigo, aprendeu a utilizar o conector do Power Query para funcionalidades de autenticação FHIR. Em seguida, explore a dobragem de consultas.

Dobragem FHIR Power Query