共用方式為

Azure API for FHIR 的用戶端應用程式註冊

  • 發行項

重要

Azure API for FHIR 將於 2026 年 9 月 30 日淘汰。 請依照移轉策略，在該日期前轉換至 Azure 健康資料服務 FHIR® 服務。 由於 Azure API for FHIR 已淘汰，因此從 2025 年 4 月 1 日開始，將不允許新的部署。 Azure 健康資料服務 FHIR 服務是已演進的 Azure API for FHIR 版本，可讓客戶透過與其他 Azure 服務整合來管理 FHIR、DICOM 和醫療技術服務。

在上一個教學課程中，您已部署並設定您的 Azure API for FHIR。 既然您已設定 Azure API for FHIR，我們將會註冊公用用戶端應用程式。 如需更多詳細資料或進行疑難排解，您可以閱讀完整的註冊公用用戶端應用程式操作指南，但我們已針對本文的此教學課程擷取了主要步驟。

  1. 瀏覽至 Microsoft Entra ID

  2. 選取 [應用程式註冊] --> [新增註冊]

  3. 為您的應用程式命名

  4. 選取 [公用用戶端/原生 (行動和桌面)]，並將重新導向 URL 設定為 https://www.getpostman.com/oauth2/callback。

    [註冊應用程式] 窗格的螢幕擷取畫面，以及範例應用程式名稱和重新導向 URL。

用戶端應用程式設定

一旦註冊了用戶端應用程式，請從 [概觀] 頁面複製應用程式 (用戶端) 識別碼和租用戶識別碼。 稍後在存取用戶端時會需要這兩個值。

[用戶端應用程式設定] 窗格的螢幕擷取畫面，其中已醒目提示應用程式和目錄識別碼。

使用 Web 應用程式連線

如果您已撰寫 Web 應用程式 以與 Azure API for FHIR 連線，也必須設定正確的驗證選項。

  1. 在左側功能表中，於 [管理]下，選取 [驗證]。

  2. 若要新增平台組態，請選取 [Web]。

  3. 設定重新導向 URI 以便在此教學課程的第四個部分中建立 Web 應用程式時使用。 若要這麼做，請將 https://\<WEB-APP-NAME>.azurewebsites.net 新增至重新導向 URI 清單。 如果您在撰寫 Web 應用程式的步驟中選擇不同的名稱，您必須返回並更新該名稱。

  4. 選取 [存取權杖] 和 [識別碼權杖] 核取方塊。

    [應用程式驗證設定] 刀鋒視窗的螢幕擷取畫面，並已醒目提示新增平台步驟。

新增 API 權限

設定正確的驗證之後，請接著設定 API 權限：

  1. 選取 [API 權限]，然後選取 [新增權限]。
  2. 在 [我的組織使用的 API] 底下，搜尋「Azure 健康資料服務」。
  3. 選取 [user_impersonation]，然後選取 [新增權限]。

[新增 API 權限] 刀鋒視窗的螢幕擷取畫面，其中已醒目提示新增 API 權限的步驟。

後續步驟

您現在有一個公用用戶端應用程式。 在下一個教學課程中，我們將會逐步解說如何透過 Postman 來測試及取得此應用程式的存取權。

在 Postman 中測試用戶端應用程式

FHIR® 是 HL7 的註冊商標，可與 HL7 的權限搭配使用。