Udostępnij za pośrednictwem

Rejestracja aplikacji klienckiej dla usługi Azure API for FHIR

  • Artykuł

Ważne

Usługa Azure API for FHIR zostanie wycofana 30 września 2026 r. Postępuj zgodnie ze strategiami migracji, aby przejść do usługi Azure Health Data Services FHIR® do tej daty. Ze względu na wycofanie usługi Azure API for FHIR nowe wdrożenia nie będą możliwe od 1 kwietnia 2025 r. Usługa FHIR usług Azure Health Data Services to rozwinięta wersja usługi Azure API for FHIR, która umożliwia klientom zarządzanie usługami FHIR, DICOM i MedTech z integracją z innymi usługami platformy Azure.

W poprzednim samouczku wdrożono i skonfigurowano interfejs API platformy Azure dla standardu FHIR. Po skonfigurowaniu interfejsu API platformy Azure dla standardu FHIR zarejestrujemy publiczną aplikację kliencką. Pełne instrukcje dotyczące rejestrowania publicznej aplikacji klienckiej można znaleźć w przewodniku, aby uzyskać więcej szczegółów lub rozwiązywania problemów, ale omówiliśmy główne kroki tego samouczka w tym artykule.

  1. Przejdź do identyfikatora Entra firmy Microsoft

  2. Wybierz pozycję Rejestracja aplikacji —> nowa rejestracja

  3. Nadaj aplikacji nazwę

  4. Wybierz pozycję Klient publiczny/natywny (mobilny i klasyczny) i ustaw identyfikator URI przekierowania na https://www.getpostman.com/oauth2/callback.

    Zrzut ekranu przedstawiający okienko Rejestrowanie aplikacji oraz przykładową nazwę aplikacji i adres URL przekierowania.

Ustawienia aplikacji klienckiej

Po zarejestrowaniu aplikacji klienckiej skopiuj identyfikator aplikacji (klienta) i identyfikator dzierżawy ze strony przeglądu. Te dwie wartości będą potrzebne później podczas uzyskiwania dostępu do klienta.

Zrzut ekranu przedstawiający okienko ustawień aplikacji klienckiej z wyróżnionymi identyfikatorami aplikacji i katalogu.

Łączenie z aplikacją internetową

Jeśli aplikacja internetowa została napisana w celu nawiązania połączenia z interfejsem API platformy Azure for FHIR, musisz również ustawić prawidłowe opcje uwierzytelniania.

  1. W menu po lewej stronie w obszarze Zarządzanie wybierz pozycję Uwierzytelnianie.

  2. Aby dodać nową konfigurację platformy, wybierz pozycję Sieć Web.

  3. Skonfiguruj identyfikator URI przekierowania w ramach przygotowań do tworzenia aplikacji internetowej w czwartej części tego samouczka. W tym celu dodaj https://\<WEB-APP-NAME>.azurewebsites.net do listy identyfikatorów URI przekierowania. Jeśli wybierzesz inną nazwę w kroku, w którym piszesz aplikację internetową, musisz wrócić i zaktualizować ją.

  4. Zaznacz pola wyboru Token dostępu i Token identyfikatora.

    Zrzut ekranu przedstawiający blok Ustawienia uwierzytelniania aplikacji z wyróżnionymi krokami dodawania platformy.

Dodawanie uprawnień API

Po skonfigurowaniu poprawnego uwierzytelniania ustaw uprawnienia interfejsu API:

  1. Wybierz pozycję Uprawnienia interfejsu API i wybierz pozycję Dodaj uprawnienie.
  2. W obszarze Interfejsy API używane przez moją organizację wyszukaj pozycję Azure Health Data Services.
  3. Wybierz pozycję user_impersonation i wybierz pozycję Dodaj uprawnienia.

Zrzut ekranu przedstawiający blok Dodawanie uprawnień interfejsu API z wyróżnionymi krokami dodawania uprawnień interfejsu API.

Następne kroki

Masz teraz publiczną aplikację kliencką. W następnym samouczku przejdziemy przez testowanie i uzyskanie dostępu do tej aplikacji za pośrednictwem narzędzia Postman.

Testowanie aplikacji klienckiej w narzędziu Postman

FHIR® jest zastrzeżonym znakiem towarowym HL7 i jest używany z uprawnieniem HL7.