Registrace klientské aplikace pro rozhraní Azure API for FHIR

  • Článek

Důležité

Rozhraní Azure API for FHIR bude vyřazeno 30. září 2026. Postupujte podle strategií migrace a do tohoto data přejděte na službu FHIR služby Azure Health Data Services. Vzhledem k vyřazení rozhraní Azure API for FHIR nebudou nová nasazení povolená od 1. dubna 2025. Služba FHIR služby Azure Health Data Services je vyvinutá verze rozhraní Azure API for FHIR, která zákazníkům umožňuje spravovat služby FHIR, DICOM a MedTech s integrací do jiných služeb Azure.

V předchozím kurzu jste nasadili a nastavili rozhraní Azure API for FHIR. Teď, když máte nastavené rozhraní Azure API for FHIR, zaregistrujeme veřejnou klientskou aplikaci. Kompletní průvodce postupem registrace veřejné klientské aplikace si můžete přečíst, kde najdete další podrobnosti nebo řešení potíží, ale hlavní kroky pro tento kurz najdete v tomto článku.

  1. Přejděte na Microsoft Entra ID.

  2. Výběr registrace aplikace –> nová registrace

  3. Pojmenování aplikace

  4. Vyberte veřejný klient nebo nativní (mobilní && desktop) a nastavte identifikátor URI přesměrování na https://www.getpostman.com/oauth2/callback.

    Screenshot of the Register an application pane, and an example application name and redirect URL.

Nastavení klientské aplikace

Po registraci klientské aplikace zkopírujte ID aplikace (klienta) a ID tenanta ze stránky Přehled. Tyto dvě hodnoty budete potřebovat později při přístupu k klientovi.

Screenshot of the client application settings pane, with the application and directory IDs highlighted.

Připojení s webovou aplikací

Pokud jste webovou aplikaci napsali pro připojení pomocí rozhraní Azure API for FHIR, musíte také nastavit správné možnosti ověřování.

  1. V nabídce vlevo v části Spravovat vyberte Ověřování.

  2. Pokud chcete přidat novou konfiguraci platformy, vyberte Web.

  3. Při přípravě na vytvoření webové aplikace v čtvrté části tohoto kurzu nastavte identifikátor URI přesměrování. Uděláte to tak, že přidáte https://\<WEB-APP-NAME>.azurewebsites.net do seznamu identifikátorů URI přesměrování. Pokud během kroku, ve kterém píšete webovou aplikaci, zvolíte jiný název, budete se muset vrátit a aktualizovat.

  4. Zaškrtněte políčka Přístupový token a token ID.

    Screenshot of the app Authentication settings blade, with the steps to add a platform highlighted.

Přidání oprávnění rozhraní API

Teď, když jste nastavili správné ověřování, nastavte oprávnění rozhraní API:

  1. Vyberte oprávnění rozhraní API a vyberte Přidat oprávnění.
  2. V části Rozhraní API, která moje organizace používá, vyhledejte službu Azure Health Data Services.
  3. Vyberte user_impersonation a vyberte přidat oprávnění.

Screenshot of the Add API permissions blade, with the steps to add API permissions highlighted.

Další kroky

Teď máte veřejnou klientskou aplikaci. V dalším kurzu si projdeme testování a získání přístupu k této aplikaci prostřednictvím Nástroje Postman.

Testování klientské aplikace v Nástroji Postman

FHIR® je registrovaná ochranná známka HL7 a používá se s povolením HL7.