Share via

Uwierzytelnianie łącznika FHIR

  • Artykuł

W tym artykule opisano uwierzytelniony dostęp do serwerów FHIR przy użyciu łącznika Power Query dla standardu FHIR. Łącznik obsługuje anonimowy dostęp do publicznie dostępnych serwerów FHIR i uwierzytelniony dostęp do serwerów FHIR przy użyciu uwierzytelniania microsoft Entra ID (organizacyjnego). Interfejs API platformy Azure for FHIR jest zabezpieczony za pomocą identyfikatora Entra firmy Microsoft.

Uwaga

Jeśli łączysz się z serwerem FHIR z usługi online, takiej jak usługa Power BI, możesz użyć tylko konta organizacyjnego.

Dostęp anonimowy

Istnieje wiele publicznie dostępnych serwerów FHIR. Aby włączyć testowanie przy użyciu tych serwerów publicznych, łącznik Power Query dla standardu FHIR obsługuje schemat uwierzytelniania "Anonimowe". Aby na przykład uzyskać dostęp do serwera publicznego https://server.fire.ly :

  1. Wprowadź adres URL publicznego serwera Firely.

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

  2. Wybierz pozycję Schemat uwierzytelniania anonimowego .

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

Następnie wykonaj kroki, aby wykonać zapytanie i ukształtować dane.

Uwierzytelnianie identyfikatora entra firmy Microsoft (organizacyjnego)

Łącznik Power Query dla standardu FHIR obsługuje uwierzytelnianie OAuth dla serwerów FHIR zabezpieczonych za pomocą identyfikatora Entra firmy Microsoft.

Aby użyć uwierzytelniania identyfikatora Entra firmy Microsoft, wybierz pozycję Konto organizacyjne podczas nawiązywania połączenia.

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

Należy pamiętać o pewnych ograniczeniach:

  • Oczekiwana grupa odbiorców dla serwera FHIR musi być równa podstawowemu adresowi URL serwera FHIR. W przypadku interfejsu API platformy Azure dla standardu FHIR można to ustawić podczas aprowizacji usługi FHIR lub nowszej w portalu.

  • Jeśli serwer FHIR nie zwraca nagłówka WWW-Authenticate wyzwania z polem po nieudanej authorization_uri autoryzacji, musisz zalogować się przy użyciu konta organizacyjnego. Nie można użyć konta gościa w dzierżawie usługi Active Directory. W przypadku interfejsu API platformy Azure for FHIR należy użyć konta organizacyjnego Microsoft Entra ID.

  • Jeśli usługa FHIR nie jest usługą Azure API for FHIR (na przykład jeśli używasz serwera Microsoft FHIR typu open source dla platformy Azure), zarejestrowano aplikację zasobów Microsoft Entra ID dla serwera FHIR. Aby móc uzyskać dostęp do tej aplikacji zasobów, musisz wstępnie autoryzować aplikację kliencą usługi Power BI.

    Screenshot demonstrating how to preauthorize the Power BI client application.

    Identyfikator klienta klienta klienta dla klienta usługi Power BI to a672d62c-fc7b-4e81-a576-e60dc46e951d.

  • Klient dodatku Power Query (na przykład Power BI) zażąda tylko jednego zakresu: user_impersonation. Ten zakres musi być dostępny, a serwer FHIR nie może polegać na innych zakresach.

Następne kroki

W tym artykule przedstawiono sposób używania łącznika Power Query na potrzeby funkcji uwierzytelniania FHIR. Następnie zapoznaj się z składaniem zapytań.

Składanie dodatku Power Query FHIR