案例：呼叫 Web API 的原生應用程式

發行項
02/13/2024

適用於：Windows Server 2022、Windows Server 2019、AD FS 2019 及更新版本

了解如何建置 AD FS 2019 所驗證的原生應用程式登入使用者，以及使用 MSAL 程式庫取得權杖來呼叫 Web API。

概觀

Overview

在此流程中，您會將驗證新增至原生應用程式 (公用用戶端)，因此可以登入使用者並呼叫 Web API。若要從登入使用者的原生應用程式呼叫 Web API，您可以使用 MSAL 的 AcquireTokenInteractive 權杖取得方法。若要啟用此互動，MSAL 會利用網頁瀏覽器。

若要進一步了解如何在 AD FS 中設定原生應用程式，以互動方式取得存取權杖，讓我們使用此處提供的範例，並逐步進行應用程式註冊和程式碼設定步驟。

必要條件

GitHub 用戶端工具
已設定且正在執行的 AD FS 2019 或更新版本
Visual Studio 2013 或更新版本

AD FS 中的應用程式註冊

本節說明如何在 AD FS 中，將原生應用程式註冊為公用用戶端和將 Web API 註冊為信賴憑證者 (RP)

在 AD FS 管理中，以滑鼠右鍵按一下 [應用程式群組]，然後選取 [新增應用程式群組]。
在 [應用程式群組精靈] 上，針對 [名稱] 輸入 NativeAppToWebApi，然後在 [用戶端伺服器應用程式] 下選取 [存取 Web API 的原生應用程式] 範本。按一下 [下一步] 。
複製 [用戶端識別碼] 值。稍後會在應用程式的 App.config 檔案中，將其當作 ClientId 的值使用。針對 [重新導向 URI] 輸入下列內容：https://ToDoListClient. 按一下新增。按一下 [下一步] 。
在 [設定 Web API] 畫面上，輸入 [識別碼:]https://localhost:44321/. 按一下新增。按一下 [下一步] 。稍後會在應用程式的 App.config 和 Web.config 檔案中使用此值。
在 [套用存取控制原則] 畫面上，選取 [允許所有人]，然後按 [下一步]。
在 [設定應用程式權限] 畫面上，確定已選取 [openid]，然後按 [下一步]。
在 [摘要] 畫面上，按 [下一步]。
在 [完成] 畫面上，按一下 [關閉]。
在 AD FS 管理中，按一下 [應用程式群組]，然後選取 [NativeAppToWebApi] 應用程式群組。按一下滑鼠右鍵並選取 [內容]。
在 [NativeAppToWebApi 屬性] 畫面上，選取 [Web API] 下的 [NativeAppToWebApi – Web API]，然後按一下 [編輯...]
在 [NativeAppToWebApi – Web API 屬性] 畫面上，選取 [發行轉換規則] 索引標籤，然後按一下 [新增規則...]
在 [新增轉換宣告規則精靈] 上，從 [宣告規則範本：] 中選取 [轉換傳入宣告]，然後按 [下一步]。
在 [宣告規則名稱：] 欄位中輸入 NameID。在 [傳入宣告類型：] 選取 [名稱]、在 [傳出宣告類型：] 選取 [名稱識別碼]，以及在 [傳出名稱識別碼格式：] 選取 [一般名稱]。按一下 [完成]。
在 [NativeAppToWebApi – Web API 屬性] 畫面上按一下 [確定]，然後按一下 [NativeAppToWebApi 屬性] 畫面。

程式碼設定

本節說明如何設定原生應用程式來登入使用者，並擷取權杖以呼叫 Web API

從這裡下載範例
使用 Visual Studio 來開啟範例
開啟 App.config 檔案。修改下列內容：
- ida:Authority - 輸入 https://[your AD FS hostname]/adfs
- ida:ClientId - 在上述 AD FS 中應用程式註冊區段中輸入來自 #3 的用戶端識別碼值。
- ida:RedirectUri - 在上述 AD FS 中應用程式註冊區段中輸入來自 #3 的重新導向 URI 值。
- todo:TodoListResourceId – 在上述 AD FS 中應用程式註冊區段中輸入來自 #4 的識別碼值
- ida: todo:TodoListBaseAddress - 在上述 AD FS 中應用程式註冊區段中輸入來自 #4 的識別碼值。
開啟 Web.config 檔案。修改下列內容：
- ida:Audience – 在上述 AD FS 中應用程式註冊區段中輸入來自 #4 的識別碼值
- ida: AdfsMetadataEndpoint - 輸入 https://[your AD FS hostname]/federationmetadata/2007-06/federationmetadata.xml