基於會話的驗證縮短了 AI 代理與應用程式的每次請求驗證與授權時間,同時保留了組織已依賴的安全控管。 在基於會話的驗證中,代理程式或應用程式只需以 Microsoft Entra ID 驗證一次,為容器建立一個短命的會話,並利用該會話進行後續讀取。
基於會話的驗證非常適合用於讀取量大、延遲敏感的工作負載,這些工作負載會使用相同身份向同一容器發出大量請求,例如 AI 代理、AI 訓練與推論、分析以及高效能運算。
Important
基於會話的認證目前仍處於預覽階段。 請參閱 Microsoft Azure 預覽補充使用條款,以了解適用於預覽版 Azure 功能的條款。
Benefits
- 增強效能。 建立工作階段時,身份與權限會被驗證一次。 後續對容器的讀取請求會使用該會話,從而降低每次請求的驗證與授權延遲。
- 同樣是最低權限存取,如今則是短暫有效。 會話使用您組織現有的最低權限存取權限模型,包括 Azure RBAC 與 Azure ABAC。 每個工作階段也被限定在一個容器內,五分鐘後到期,綁定於建立該工作階段的客戶端,且要求每個請求都必須經過簽署。
- 完全可追溯性。 Azure 儲存體 診斷日誌目前會記錄每個請求背後的 Microsoft Entra ID 身份,工作階段亦然。 使用會話時,每個請求都會與創建該會話的 Microsoft Entra ID 身份綁定,因此資安團隊能隨時掌握哪個身份(人手或代理)存取了哪些資料,以及何時存取。
- 應用程式邏輯未變更。 透過使用 Azure 儲存體 用戶端函式庫,您可以透過單一用戶端設定選項啟用基於工作階段的驗證。
基於會話的驗證如何運作
當用戶端呼叫建立會話操作時,Azure 儲存體 會驗證用戶端的 Microsoft Entra ID 身份,評估 Azure RBAC 角色指派及容器的 Azure ABAC 條件,啟動五分鐘的工作階段,並回傳會話憑證。 工作階段認證由兩部分組成:
- 會話權杖: 用來識別會話。
- 會話金鑰: 用戶端用來簽署會話中每個請求。
對於後續對同一容器的 Get Blob 請求,用戶端會連同會話令牌連同使用會話金鑰計算的簽章一起傳送,而非使用 Microsoft Entra ID 存取權杖。 由於在建立會話時已驗證身份與權限,因此每次請求的驗證與授權時間會縮短。
會話流程包含以下步驟:
- 用戶端取得用於 Azure 儲存體 的 Microsoft Entra ID 存取權杖。
- 用戶端會呼叫目標容器的 建立工作階段 操作。 Azure 儲存體 會使用 Microsoft Entra ID 存取權杖授權該請求。
- Azure 儲存體 會回傳會話憑證及會話到期時間。
- 用戶端會使用會話憑證,為同一容器中的 Blob 授權 Get Blob 要求。
- 若要繼續讀取資料,客戶端會在目前工作階段到期前建立一個新的工作階段。
Note
當您使用 Azure 儲存體 SDK 時,用戶端函式庫會自動管理完整的工作階段生命週期。
會話設計時有以下安全邊界:
- 範圍限定於單一容器。 一個工作階段只能授權對為其建立的容器中的 blob 提出的要求。
- 與原始身份綁定。 工作階段永遠不會授予超出建立該工作階段的 Microsoft Entra ID 安全主體所指派的權限。 透過該會話發出的所有請求都會歸因於該身份。
- 短暫。 一個工作階段會在五分鐘後結束。 工作階段憑證無法延長或更新;用戶端必須建立新的工作階段才能繼續。
- 綁定到用戶端的網路環境。 會話綁定到建立它的用戶端 IP 位址,這有助於防止被擷取的會話憑證被其他用戶端重播。 同一個工作階段可用於來自相同用戶端 IP 位址的多個連線。
- 已簽署的請求。 每個工作階段內的請求都會以工作階段金鑰簽署。
- 審計。 在工作階段內提出的請求會記錄在 Azure 儲存體 診斷日誌中。
何時使用基於工作階段的驗證
當以下所有條件皆成立時,請考慮基於工作階段的驗證:
- 該應用程式使用 Microsoft Entra ID 進行驗證,並使用 Azure RBAC 進行授權。
- 應用程式會對同一容器中的 blob 重複執行 Get Blob 請求。
- 應用程式能安全地管理臨時工作階段憑證,並視需要重建工作階段。 Azure 儲存體 SDK 會自動處理這件事。
當符合以下任一條件時,請勿使用基於工作階段的驗證:
- 代理程式或應用程式使用使用者委派 SAS、服務 SAS、帳戶 SAS 或共用金鑰進行驗證與授權。
- 代理程式或應用程式需要執行除取得 Blob 以外的操作。 這些操作必須使用 Microsoft Entra ID 存取權杖進行驗證與授權。 Azure 儲存體 SDK 會自動處理這件事。
- 應用程式只會偶爾或一次發出 Get Blob 請求,且不會從額外的會話建立請求中受益。
計費
建立會話會按您的儲存帳戶的標準寫入交易計費。 使用 session 發出的 Get Blob 請求會依照您儲存帳戶類型的標準交易費率計費。 欲了解更多,請參閱 Azure 儲存體 價格。
開始
要開始使用,請使用 Azure PowerShell 或 Azure CLI 註冊預覽版。
執行下列指令以註冊預覽:
Connect-AzAccount -SubscriptionId <subscription-id>
Register-AzProviderFeature -FeatureName SessionRequest -ProviderNamespace Microsoft.Storage
要檢查您的註冊狀態,請執行以下指令:
Connect-AzAccount -SubscriptionId <subscription-id>
Get-AzProviderFeature -FeatureName SessionRequest -ProviderNamespace Microsoft.Storage
Note
你的註冊可能需要幾天才能獲得核准。 註冊核准後,註冊狀態會顯示 為已註冊。
使用 Azure 儲存體 SDK 搭配工作階段
Azure 儲存體 SDK 提供了使用基於會話驗證的最簡單方式。 當您初始化 Blob 用戶端時啟用基於工作階段的驗證;其餘應用程式邏輯保持不變。
啟用基於會話的驗證時,SDK 會自動管理完整的會話生命週期:
- 建立一個會話並快取其憑證。
- 自動以會話金鑰簽署每個請求。
- 使用 session token 進行 Get Blob 操作,使用 Microsoft Entra ID 存取權杖進行其他操作。
- 在工作階段到期前更新,且不影響資料存取,讓您的應用程式永遠不需要追蹤工作階段的壽命。
您現有的程式碼繼續使用相同方法、Microsoft Entra ID 憑證及 RBAC 角色指派讀取 blob,同時享有較低延遲的讀取效果。
Note
若要使用 Azure 儲存體 SDK 的基於工作階段的驗證,請安裝最新的 Azure Blob 用戶端函式庫套件以存取資料。 例如,針對 Python,請安裝套件版本 12.31.1 或更新版本。 對於 .NET,請安裝套件版本 12.31.0-beta.1 或更新版本。
以下 SDK 範例透過工作階段讀取 blob。
using System;
using System.IO;
using System.Threading.Tasks;
using Azure.Identity;
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
string accountName = "<storage-account-name>";
string containerName = "<container-name>";
string blobName = "<blob-name>";
var options = new BlobClientOptions
{
SessionOptions = new SessionOptions
{
SessionMode = SessionMode.Enabled
}
};
var serviceClient = new BlobServiceClient(
new Uri($"https://{accountName}.blob.core.windows.net"),
new DefaultAzureCredential(),
options);
BlobContainerClient containerClient =
serviceClient.GetBlobContainerClient(containerName);
BlobClient blobClient = containerClient.GetBlobClient(blobName);
var response = await blobClient.DownloadStreamingAsync();
using Stream content = response.Value.Content;
using var reader = new StreamReader(content);
string text = await reader.ReadToEndAsync();
Console.WriteLine(text);
使用 REST API 進行工作階段
如果您直接呼叫 REST API,而非使用 Azure 儲存體 SDK,您的應用程式必須在目前工作階段到期前建立會話、簽署請求並建立替換會話。
建立會話。 呼叫容器上的「建立工作階段」操作,並以 Microsoft Entra ID 存取權杖授權該請求。 成功回應會回傳會話令牌、會話金鑰及會話到期時間。 安全儲存會話憑證,並將其關聯至建立這些憑證所對應的容器。
範例請求
POST https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=session Authorization: Bearer {Entra access token} x-ms-date: {date} x-ms-version: {version} <?xml version="1.0" encoding="utf-8"?> <CreateSessionRequest> <AuthenticationType>HMAC</AuthenticationType> </CreateSessionRequest>「建立工作階段」僅在 2026-02-06 或更新版本中受支援。 更多細節請參閱 建立 Session REST API 文件。
透過工作階段讀取一個 blob。 呼叫 Get Blob 操作。 授權標頭包含會話令牌以及使用會話金鑰計算出的簽章。 會話金鑰本身從未被傳送。
範例請求
GET https://myaccount.blob.core.windows.net/mycontainer/myblob Authorization: Session {SessionToken}:{Signature} x-ms-version: {version}更多細節請參閱 建立 Session REST API 文件。
在到期前續約。 會話在五分鐘後到期,且無法延長。 使用已過期工作階段提出的要求會失敗。 當需要不中斷的存取時,請在目前工作階段到期前建立替換工作階段。
考慮事項與限制條件
- 若要使用此功能,您必須先獲准加入預覽。 如需詳細資訊,請參閱 開始使用。
- 基於工作階段的驗證僅限於取得 Blob 操作。 會話令牌僅支援 Get Blob 操作;其他所有操作都需要 Microsoft Entra ID 存取權杖。 Azure 儲存體 SDK 會根據操作自動選擇使用哪個令牌來處理此事。
- 基於會話的驗證可縮短高頻讀取工作負載的驗證與授權時間。 與其對每個 Get Blob 請求執行完整的 OAuth 權杖驗證與授權評估,Azure 儲存體 會建立一個暫時的安全上下文,該上下文可在後續請求中重複使用。 這縮短了每次請求的驗證與授權時間,並有助於為吞吐量密集且延遲敏感的工作負載提供更可預測的延遲。
- 當在短時間內完成大量 Get Blob 請求時,最大的效益會被實現。 基於會話的驗證適用於大規模重複讀取的應用程式,在這些情況下,縮短多次請求的驗證與授權時間,可提升整體效率與延遲一致性。 每個使用者在每個容器建立多個工作階段並沒有效能上的優勢。 因此,每位有容器存取權的使用者一次應僅使用一個工作階段。
- 以工作階段為基礎的驗證需要 Microsoft Entra ID 來建立工作階段。 用戶端會以 Microsoft Entra ID 存取權杖驗證建立會話請求。 Azure 儲存體 會回傳臨時工作階段憑證,這些憑證可用於會話生命週期內後續的 Get Blob 請求。 權限不會被提升或擴充;會話會繼承已透過 Azure RBAC 和 Azure ABAC 授予 Microsoft Entra ID 身份的權限。 基於工作階段的驗證不支援使用者綁定的使用者委派 SAS、使用者委派 SAS、服務 SAS、帳戶 SAS 或共用金鑰授權。
- 工作階段會在容器層級取得授權。 容器的 Azure RBAC 與 Azure ABAC 政策會在建立會話時於容器層級評估,這些權限會在會話的整個生命週期中被使用。 這表示 Azure ABAC 政策在比容器更細緻層級時不會被評估。 此外,如果容器層級的 Azure RBAC 或 Azure ABAC 權限在會話生命週期的五分鐘內變更,該權限會在建立新的會話令牌之前不會套用。 指派 Azure 角色時,請遵循最小權限原則。 僅在應用程式所需的最窄範圍內授予讀取權限。 如需詳細資訊,請參閱 指派 Azure 角色以存取 Blob 數據。
- 工作階段採用透明的安全邊界設計。 一個工作階段會被限定在單一容器上,並綁定於建立該容器的身份,並在五分鐘後到期。 透過該工作階段發出的所有請求都會歸屬於原始的 Microsoft Entra ID 身份。 會話憑證無法無限期重複使用,必須在過期後重新建立。 會話也會綁定到原始用戶端 IP,有助於防止會話憑證被其他機器重複使用。
-
不支援:
- 取得 Blob 操作的 Blob 索引標籤,這表示在使用 Session token 時,您無法看到與所存取的 blob 相關聯的任何標籤。
- 在次要帳戶上可執行 Get Blob 讀取作業;你只能在主要帳戶上呼叫 Get Blob,並使用工作階段權杖作為驗證方式。
- 不支援頁面 Blob 與附加 Blob,僅支援區塊 Blob。
- 使用者綁定使用者委派 SAS、使用者委派 SAS、服務 SAS、帳戶 SAS 及共用金鑰授權,僅支援 Microsoft Entra ID 作為驗證。
- Microsoft Purview 不支援會話令牌。
監控基於工作階段的驗證
Azure 儲存體 會在 Azure 監視器 資源記錄中記錄 Create Session 要求及工作階段內提出的要求。 若要收集這些日誌,請為 Blob 儲存體 設定診斷設定,將 StorageRead 日誌傳送至 Log Analytics 工作區、儲存帳戶或事件中心。 如需詳細資訊,請參閱 監視 Azure Blob 儲存體。
建立工作階段要求
建立工作階段請求會以作業名稱 CreateSession 顯示於 StorageRead 類別中,且驗證類型為 OAuth。 每個條目包括:
- 呼叫者身份:建立會話的 Microsoft Entra ID 安全主體,包括其物件 ID、租戶 ID、使用者主體名稱及用戶端應用程式 ID。
- 授權決定:評估的動作、授予存取權的 Azure 角色指派與角色定義,以及結果。
- Session ID: 該會話的唯一識別碼。
- 目標容器: 工作階段所限定的儲存體帳戶和容器。
- 網路與要求詳細資料: 呼叫端 IP 位址、協定、TLS 版本、狀態碼、延遲、用戶端請求 ID 及使用者代理程式。
在工作階段內提出的請求
由工作階段授權的 Get Blob 請求會以操作名稱 GetBlob 顯示在 StorageRead 類別中,且其驗證類型為 Session。 每條記錄中包含的不是呼叫者的身分與授權詳細資料,而是用於授權該要求之工作階段的工作階段識別碼,以及所讀取的 blob、呼叫者 IP 位址及標準要求詳細資料。
若要在會話中尋找請求背後的 Microsoft Entra ID 身份,請將 GetBlob 操作中的會話 ID 與對應的 CreateSession 操作中的會話 ID 相匹配。 「建立工作階段」項目記錄 Microsoft Entra 身份以及授權該工作階段的 Azure 角色指派。
Troubleshooting
當會話請求失敗時,請檢查回應標頭以取得有關失敗的具體資訊。
| 徵兆 | 建議的動作 |
|---|---|
| 建立會話請求失敗 | 確認請求使用有效的 Microsoft Entra ID 存取權杖、鎖定目標容器、使用 HTTPS,且安全主體具備所需權限。 |
| Get Blob 要求傳回授權錯誤 | 確認該工作階段是為同一容器建立,且 Microsoft Entra ID 安全性主體對所請求的 blob 具有讀取權限。 |
| 該工作階段已過期或找不到 | 建立一個新的工作階段,並使用新的工作階段憑證重試 Get Blob 請求。 |
| 工作階段權杖無效 | 丟棄目前的會話憑證,建立新的會話,並確保憑證值未被修改。 |
| 不同的作業因工作階段授權而失敗 | 僅在取得 Blob 操作中使用基於工作階段的驗證。 其他操作可使用 Microsoft Entra ID 存取權杖。 |