讓使用者從本機代理程式登入(預覽版)

本地代理程式運行於端點裝置上,無法安全地儲存用戶端密鑰或憑證。 將其設定為 OAuth 公共用戶端,並使用授權碼流程搭配 Proof Key for Code Exchange(PKCE)。

使用者透過瀏覽器登入。 代理程式在其註冊的重新導向 URI 收到授權碼,並在無需用戶端憑證的情況下兌換該碼。

Important

本機代理程式驗證目前處於預覽階段。 此預覽版在沒有服務等級協議的情況下提供,不建議用於生產工作負載。 部分功能可能未被支援或功能受限。 欲了解更多資訊,請參閱 線上服務通用授權條款。

Prerequisites

您需要一個 Microsoft Entra 租戶,以便註冊代理程式 ID,或是一個支援用戶端 ID 元資料文件(CIMD)的租戶。

選擇用戶端識別碼

Option 用戶端識別碼 何時使用
在 Microsoft Entra 中註冊代理 ID 由 Microsoft Entra 指派的用戶端 ID 建議在您確定代理程式已連接至 Microsoft Entra 時使用。
使用 CIMD 用戶端元資料文件的公開 HTTPS URL 當同一個分散式用戶端連接到獨立運作的授權伺服器,且預先註冊不切實際時使用。

盡可能使用註冊代理人編號。 如需更多關於 CIMD 的資訊,請參閱 Microsoft Entra ID 中的用戶端 ID 中繼資料文件。

註冊 Agent ID

  1. 建立單一實例藍圖並註冊其 Agent ID。 建立藍圖時選擇實例模式;之後你無法改變。
  2. 在藍圖的 publicClient 平台下,新增由您的驗證函式庫推薦的重新導向 URI。
  3. 記錄代理程式 ID 的用戶端 ID 與租戶 ID。

每個安裝都使用相同的用戶端 ID。 不要為每個裝置建立獨立的代理程式 ID,也不要為此流程新增用戶端密鑰、憑證或聯合身份認證。

如需重新導向 URI 選項,請參閱 呼叫 Web API 的桌面應用程式:程式碼設定。

使用 MSAL.NET 登入

安裝 MSAL.NET:

dotnet add package Microsoft.Identity.Client

建立公開用戶端應用程式:

using Microsoft.Identity.Client;

var app = PublicClientApplicationBuilder
    .Create("<agent-client-id>")
    .WithAuthority("https://login.microsoftonline.com/<tenant-id>")
    .WithDefaultRedirectUri()
    .Build();

在不要求 API 的委派權限的情況下登入使用者:

var result = await app
    .AcquireTokenInteractive(Array.Empty<string>())
    .ExecuteAsync();

Console.WriteLine($"Signed in as {result.Account.Username}");

AcquireTokenInteractive 沒有無參數的多載。 當代理程式只需登入使用者時,傳送空範圍集合。 MSAL 會新增登入所需的預留 OpenID Connect 範圍,但不會要求 API 的委派範圍。

MSAL 會開啟系統瀏覽器,使用 PKCE,驗證回應,並快取帳號。 使用租戶專屬授權單位來搭配已註冊的 Agent ID。 不要使用帳號名稱或 ID 令牌來授權存取 API。 在下一步請求 API 的委派範圍。

使用 CIMD 用戶端進行委派 API 存取(預覽版)

在支援 URL 值用戶端 ID 的 OAuth 函式庫中,將 CIMD URL 作為用戶端 ID。 函式庫必須使用 PKCE 的授權碼流程,且在兌換代碼時不得傳送用戶端憑證。

CIMD 不支援使用者登入時使用 ID 令牌。 此分支使用瀏覽器驗證取得委派的 API 存取權,而非先前所示的僅限登入 MSAL.NET 結果。 依照 CIMD 設定程序請求資源的委派範圍。

有關中繼資料與重新導向 URI 需求,請參閱 「使用用戶端 ID 中繼資料文件設定用戶端」。

下一步

以已登入使用者身分呼叫 API。