令牌保護部署指南 - 網頁應用程式(預覽版)

本指南說明部署及執行登入會話令牌保護的步驟,適用於存取 Azure Resource Manager(ARM)的網頁(瀏覽器)應用程式。

關於令牌保護及支援平台的概述,請參見Microsoft Entra條件存取中的令牌保護。 使用本部署指南前,請先閱讀總覽文件。

Note

網頁應用程式的令牌保護目前處於預覽階段。 預覽功能仍在開發中,其功能可能會隨時間改變。 這些功能是在正式發行前先行推出,讓客戶能夠搶先體驗並提供意見反應。

Note

由於網頁應用程式的支援仍處於預覽階段,我們建議您先為原生應用程式部署令牌保護,包括至少對一組試點使用者執行該政策,再嘗試此網頁應用程式的預覽版。 如需指引,請參閱 Windows 和 Apple 裝置的部署指南。

先決條件

使用此功能需要 Microsoft Entra ID P1 授權。 若要尋找符合您需求的授權,請參閱 比較 Microsoft Entra ID 的一般可用功能。

支援的應用程式、資源與瀏覽器

應用程式

  • Azure 入口網站
  • Microsoft Intune 管理中心
  • Microsoft Entra 系統管理中心
  • Microsoft Engage 中心
  • Microsoft Engage Hub

僅支援上述網頁應用程式。 當政策被強制執行時,使用者對 其他存取 ARM 的網頁應用程式的存取會被阻 擋。 頂尖存取 ARM 但 不支援 的網頁應用程式包括但不限於:

  • Microsoft 365 安全性與合規性中心
  • Microsoft AppSource
  • Azure Data Factory
  • Azure AI Studio App
  • Azure Synapse Studio
  • Microsoft Power BI
  • Microsoft 開發者入口網站
  • Azure OpenAI Studio
  • Power Platform 系統管理中心

支援資源

  • Azure Resource Manager(ARM),在條件存取中被設定為Windows Azure服務管理 API 資源。

支援平台與瀏覽器

平台 支援的瀏覽器 裝置需求
Windows 11(建構版 26100.8246 / 26200.8246 或更新版本) Microsoft Edge、Google Chrome Microsoft Entra 加入、混合加入或註冊1
macOS Microsoft Edge、Google Chrome 僅限 MDM 管理

1 有些裝置註冊類型不支援。 請參閱 不支援的裝置註冊類型清單。

在 Windows 和 macOS 上啟用 ARM 的令牌保護

為減少因應用程式、瀏覽器或裝置不相容而導致使用者中斷的可能性,請遵循以下建議:

  • 從試驗使用者群組開始,並隨著時間進行擴展。
  • 在強制執行之前,先建立一個僅 報告模式 的條件存取權杖保護政策。
  • 擷取互動式和非互動式登入記錄。
  • 分析這些記錄的時間足夠長,以涵蓋正常的應用程式使用情況。 分析與理解使用者影響的指引,詳見以下章節。
  • 將已知且可靠的使用者加入使用者群組並執行該政策。

此流程有助於評估用戶對令牌保護執行的準備程度。

步驟 1:配置終端使用者裝置

請在每台裝置上手動或透過群組政策或 Intune 完成以下操作。

Windows

  1. 確保裝置運行的是 Windows 11 版本 26100.8246 / 26200.8246 或更新版本。

  2. 請透過設定以下登錄檔值來啟用此預覽:

    [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\BrowserCore]
    "EnablePlatformAuth"=dword:00000001
    
  3. 安裝Microsoft單 Sign-On 瀏覽器擴充功能:

    • Google Chrome:從 Chrome 網路商店安裝 Microsoft 單一登入,選擇「新增到 Chrome>新增」擴充功能,並確認它是否會出現在工具列中。
    • Microsoft Edge:前往edge://extensions,開啟允許其他商店的擴充功能,安裝 Microsoft 單一登入擴充功能,並確認已啟用。

macOS

  1. 安裝 Microsoft 公司入口網站,或透過你的 MDM 解決方案部署。 公司入口網站 作為 Microsoft Entra 登入的認證代理。
  2. 可使用以下選項之一啟用硬體支援的註冊:
  3. 請如前述 Windows 章節所述,在 Microsoft Edge 或 Google Chrome 中安裝 Microsoft 單一登入瀏覽器擴充功能。

Step 1 之後可以期待什麼

一旦裝置符合先決條件並完成設定,來自支援應用程式與瀏覽器的認證請求將不再完全在瀏覽器內部完成,而是由平台認證代理者處理。 這種行為使這些應用程式能夠使用裝置綁定的登入會話令牌,例如 主要刷新令牌(PRT),並符合令牌保護條件存取政策。

請規劃以下事項:

  • 至少要等24小時讓變更生效。 轉換至經紀人認證並非在套用註冊表值、擴展碼或平台單點設定檔後立即生效。 在這個時間窗口過後,或你的報告資料無法準確顯示準備狀況之前,不要進入第二步。
  • 大多數情況下,轉換是自動發生的。 使用者通常不會採取任何行動;現有的瀏覽器會話在變更持續傳播期間繼續運作。
  • 有些使用者會看到簡短的登入對話框。 在預覽期間,進入Azure入口的使用者可能會短暫看到「正在登入您......」的訊息。「訊息顯示新視窗正在開啟。 不會出現新視窗,也不需要使用者操作,登入會自動完成。 可選擇性地事先告知你的試點團隊,避免被報告為失敗。

步驟 2:以僅報告模式建立條件存取政策

完成第一步後等待24小時後,你可以繼續以僅舉報模式設定政策,以檢視執法準備度。

  1. 至少以條件存取管理員身份登入 Microsoft Entra 系統管理中心。
  2. 瀏覽到 Entra ID>條件存取>政策,然後選擇新政策並命名。
  3. 在 分配>使用者中,包含你的試點或測試使用者。 不要包含你組織的緊急存取或破碎帳戶。
  4. 在目標資源(Targetresources>)下,資源(前稱雲端應用程式)>包含>選擇資源,選擇Windows Azure服務管理 API。
  5. 在條件裝置>平台中,將配置設為「是」,並包含 Windows、macOS 或兩者。
  6. 在 「Conditions>Client apps」中,將 「配置 」設 為「是 」並包含 瀏覽器。 請務必不要在本次預覽中選擇 行動應用程式和桌面用戶端 。
  7. 在 存取控制>的會話中,選擇 「要求登入會話的權杖保護」,然後選擇 「選擇」。
  8. 將 啟用政策 設為 僅報告 ,並選擇 建立。

Tip

由於要求令牌保護的條件存取政策目前僅適用於 Windows 和 Apple 裝置,因此有必要保護你的環境,防止攻擊者看似來自不同平台時的政策被繞過。

此外,您應該設定下列原則:

步驟三:透過日誌和指標檢視執法準備情況

在僅報告政策生效並執行後,您應檢視政策影響,分析您的登入日誌,並使用記錄分析調查以檢查強制執行準備狀況。

登入記錄

要在管理中心查看與 Token Protection 相關的登入事件:

  1. 請至少以「條件式存取管理員」的身份登入Microsoft Entra 管理中心。
  2. 請瀏覽至 Entra ID>監控與健康>登入日誌。
  3. 將 令牌保護 – 登入會話狀態碼 欄位加入您的檢視,以快速查看相關的登入事件。 另外,請篩選到 Azure Resource Manager 資源,並將 Client app 設為瀏覽器,這樣可以隔離與這次預覽相關的登入請求。
  4. 選擇你正在調查的登入事件。
  5. 根據政策狀態,請檢視 條件存取 與 僅報告 標籤,並選擇您的令牌保護政策。
  6. 在 會話控制中,檢查政策要求是否被滿足。
  7. 選擇 「基本資訊 」標籤,並查看 「令牌保護 - 登入會話 」欄位以獲得更多資訊。

登入日誌包含 tokenProtectionStatusDetails 一個屬性,指示請求是否使用裝置綁定的標記:

"tokenProtectionStatusDetails": {
  "signInSessionStatus": "bound | unbound",
  "signInSessionStatusCode": <code>
}

Note

僅在 macOS 上,在執行令牌保護政策前已註冊為 Microsoft Entra ID 的裝置用戶,會在政策執行後被要求重新認證。 他們完成一次性裝置註冊升級,透過再次登入完成,以存取資源。 你可以透過 狀態碼 1003 和 1004 來識別這些使用者。 因為本州用戶可以自我修復, 因此有資格被執行政策。

登入會話狀態碼

要了解為何請求顯示 為未綁定 ,或是要辨識可套用該政策的使用者,請參考以下狀態碼。

狀態代碼 Description 需要採取的動作
1002 未綁定 – 請求因缺少 Microsoft Entra ID 裝置狀態而被解綁。 使用者必須註冊或加入裝置。
1003 未綁定 – 裝置未以安全憑證註冊(舊有註冊)。 Windows:此錯誤可能是因為裝置註冊類型不支援,或裝置未使用全新登入憑證註冊。
macOS: 使用者需執行一次性裝置註冊升級(自我修復)。
1004(僅限 macOS) Unbound – 裝置註冊沒有硬體支援。 使用者需執行一次性裝置註冊升級(自我修復)。
1005 未綁定——未具體說明原因。 情況不一;用相關ID進行調查。
1006 Unbound – 作業系統版本不支援。 使用者可將作業系統升級至 Windows 11 版本 26100.8246 / 26200.8246 或更新版本,或升級至支援的 macOS 版本。
1007 Unbound – 非硬體支援;登入的使用者並不是註冊的裝置擁有者。 使用者需重新註冊,或由註冊擁有者執行升級。
1008 Unbound – 用戶端不使用認證代理,例如 WAM。 客戶端沒有和平台代理整合,或者代理或擴充功能也沒安裝。 對於瀏覽器,安裝並啟用 Microsoft Single Sign-On 擴充功能,並啟用平台認證。

Tip

在瀏覽器的情境中, 1008 和 1002 是你在新手流程中最常看到的代碼。 通常代表Microsoft單 Sign-On 瀏覽器擴充功能缺失或停用、平台認證未啟用(Windows登錄EnablePlatformAuth檔值未設定)、使用不支援的瀏覽器如 Firefox 或 Safari,或應用程式不支援令牌保護。

識別可自行修復的使用者(僅限 macOS)

在 macOS 上,代碼 1003 和 1004 可透過一次性裝置註冊升級自行修復。

要識別符合規範或可透過使用者行動升級的請求,請篩選:

  • signInSessionStatus == bound 或
  • signInSessionStatus == unbound 其中 signInSessionStatusCode 或 10031004。

Microsoft Graph 非互動式登入查詢範例:

GET https://graph.microsoft.com/beta/auditLogs/signIns?$filter=(
  signInEventTypes/any(t: t eq 'nonInteractiveUser')
  and resourceDisplayName eq 'Azure Resource Manager'
  and (tokenProtectionStatusDetails/signInSessionStatusCode eq 1003
    or tokenProtectionStatusDetails/signInSessionStatusCode eq 1004
    or tokenProtectionStatusDetails/signInSessionStatus eq 'bound'))

當這些使用者執行令牌保護時,系統會提示他們再次登入,並在完成驗證後即可存取資源。

Log Analytics

你也可以使用 Log Analytics 查詢互動式和非互動式登入日誌,尋找因令牌保護執行失敗而被封鎖的請求。 這些查詢僅為範例,且可能會有所變動。 他們會在 Azure Resource Manager 資源上進行篩選,並加入準備度指標,讓你能區分硬區塊和可自行修復的區塊。

按應用程式分類的請求

以下範例查詢搜尋過去七天非互動式登入日誌,標示應用程式對 ARM 的阻擋與允許請求,並標記使用者可自我修復的阻擋。 切換 SigninLogs 到互動式瀏覽器登入頁面。

// Select the log to query (SigninLogs or AADNonInteractiveUserSignInLogs)
// SigninLogs
AADNonInteractiveUserSignInLogs
// Adjust the time range below
| where TimeGenerated > ago(7d)
| project Id, ConditionalAccessPolicies, Status, UserPrincipalName, AppDisplayName,
    ResourceDisplayName, TokenProtectionStatusDetails
| where ConditionalAccessPolicies != "[]"
| where ResourceDisplayName == "Azure Resource Manager"
// Add UserPrincipalName if you want to filter to a specific user
// | where UserPrincipalName == "<user_principal_name>"
| mv-expand todynamic(ConditionalAccessPolicies)
| where ConditionalAccessPolicies["enforcedSessionControls"] contains '["Binding"]'
    or ConditionalAccessPolicies["enforcedSessionControls"] contains '["SignInTokenProtection"]'
| where ConditionalAccessPolicies.result != "reportOnlyNotApplied"
    and ConditionalAccessPolicies.result != "notApplied"
| extend SessionNotSatisfyResult = ConditionalAccessPolicies["sessionControlsNotSatisfied"]
| extend Result = case(
    SessionNotSatisfyResult contains 'SignInTokenProtection'
        or SessionNotSatisfyResult contains 'Binding', 'Block', 'Allow')
| extend parsedBindingDetails = parse_json(TokenProtectionStatusDetails)
| extend bindingStatusCode = tostring(parsedBindingDetails["signInSessionStatusCode"])
| extend IsSelfRemediable = Result == "Block"
    and (bindingStatusCode == "1003" or bindingStatusCode == "1004")
| summarize by Id, UserPrincipalName, AppDisplayName, Result, IsSelfRemediable
| summarize Requests = count(),
    Users = dcount(UserPrincipalName),
    Allow = countif(Result == "Allow"),
    Block = countif(Result == "Block"),
    BlockSelfRemediable = countif(IsSelfRemediable == true),
    BlockedUsers = dcountif(UserPrincipalName, Result == "Block"),
    BlockedUsersSelfRemediable = dcountif(UserPrincipalName, IsSelfRemediable == true)
    by AppDisplayName
| extend PctAllowed = round(100.0 * Allow / (Allow + Block), 2)
| extend PctEnforceable = round(100.0 * (Allow + BlockSelfRemediable) / (Allow + Block), 2)
| project AppDisplayName, Requests, Users, Allow, Block,
    BlockSelfRemediable, BlockedUsers, BlockedUsersSelfRemediable,
    PctAllowed, PctEnforceable
| sort by Requests desc
使用者請求

以下查詢檢視過去七天非互動式登入日誌,突顯使用者對 ARM 的阻擋與允許請求,且具有相同自我修復且可執行的指標。

// Per-user query for the Azure portal -> ARM web app scenario
// SigninLogs
AADNonInteractiveUserSignInLogs
// Adjust the time range below
| where TimeGenerated > ago(7d)
| project Id, ConditionalAccessPolicies, UserPrincipalName, AppDisplayName,
    ResourceDisplayName, TokenProtectionStatusDetails
| where ConditionalAccessPolicies != "[]"
| where ResourceDisplayName == "Azure Resource Manager"
// Add UserPrincipalName if you want to filter to a specific user
// | where UserPrincipalName == "<user_principal_name>"
| mv-expand todynamic(ConditionalAccessPolicies)
| where ConditionalAccessPolicies["enforcedSessionControls"] contains '["Binding"]'
    or ConditionalAccessPolicies["enforcedSessionControls"] contains '["SignInTokenProtection"]'
| where ConditionalAccessPolicies.result != "reportOnlyNotApplied"
    and ConditionalAccessPolicies.result != "notApplied"
| extend SessionNotSatisfyResult = ConditionalAccessPolicies.sessionControlsNotSatisfied
| extend Result = case(
    SessionNotSatisfyResult contains 'SignInTokenProtection'
        or SessionNotSatisfyResult contains 'Binding', 'Block', 'Allow')
| extend parsedBindingDetails = parse_json(TokenProtectionStatusDetails)
| extend bindingStatusCode = tostring(parsedBindingDetails["signInSessionStatusCode"])
| extend IsSelfRemediable = Result == "Block"
    and (bindingStatusCode == "1003" or bindingStatusCode == "1004")
| summarize by Id, UserPrincipalName, AppDisplayName, ResourceDisplayName, Result, IsSelfRemediable
| summarize Requests = count(),
    Allow = countif(Result == "Allow"),
    Block = countif(Result == "Block"),
    BlockSelfRemediable = countif(IsSelfRemediable == true)
    by UserPrincipalName, AppDisplayName, ResourceDisplayName
| extend PctAllowed = round(100.0 * Allow / (Allow + Block), 2)
| extend PctEnforceable = round(100.0 * (Allow + BlockSelfRemediable) / (Allow + Block), 2)
| project UserPrincipalName, AppDisplayName, ResourceDisplayName,
    Requests, Allow, Block, BlockSelfRemediable,
    PctAllowed, PctEnforceable
| sort by UserPrincipalName asc

步驟四:執行政策

在檢視登入日誌資料並確認目標使用者和裝置都已準備好後,將 啟用政策 的開關從 僅報告 改為 開啟。