Important
基於會話的認證目前仍處於預覽階段。 您的訂閱必須先啟用才能預覽,才能使用「建立會話」操作。
Create Session 操作會建立一個五分鐘的會話,範圍限定在容器上。 會話提供憑證,可用來授權對該容器內資源的後續請求。
會話適用於對同一容器執行多個請求的工作負載,能減少後續請求所需的認證與授權處理。
Request
您可以建構 Create Session 要求,如下所示。 必須使用 HTTPS 格式。
| Method | 要求 URI | HTTP 版本 |
|---|---|---|
POST |
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=session |
HTTP/1.1 |
把 myaccount 替換成你儲存帳號的名稱,mycontainer 替換成建立會話的容器名稱。
URI 參數
請求 URI 需要以下參數。
| Parameter | Description |
|---|---|
restype |
Required. 一定是容器。 指定請求適用於容器資源。 |
comp |
Required. 一定是會議。 指定建立會話操作。 |
請求標頭
以下請求標頭是必需的:
| 請求標頭 | Description |
|---|---|
Authorization |
Required. 透過使用 Microsoft Entra 存取權杖授權建立會話請求。 |
Date 或 x-ms-date |
Required. 指定要求的國際標準時間(UTC)。 |
x-ms-version |
Required. 指定要用於此要求的作業版本。 Create Session 僅支援版本或更新版本 2026-02-06 。 如需詳細資訊,請參閱 Azure 儲存體服務的版本。 |
建立會話必須透過 Microsoft Entra 存取權杖授權。 基於 session 的授權無法用來建立 session。
要求本文
請求主體具有以下 XML 格式:
<?xml version="1.0" encoding="utf-8"?>
<CreateSessionRequest>
<AuthenticationType>HMAC</AuthenticationType>
</CreateSessionRequest>
下表描述請求體的元素。
| Element | Required | Description |
|---|---|---|
AuthenticationType |
Yes | 規定使用該會話請求的認證機制。 目前支援的金額為 HMAC。 當指定 HMAC 時,Create Session 會回傳一個會話金鑰,客戶端用來簽署後續請求。 |
範例要求
POST /mycontainer?restype=container&comp=session HTTP/1.1
Host: myaccount.blob.core.windows.net
Authorization: Bearer {Microsoft Entra access token}
x-ms-date: {date}
x-ms-version: {version}
Content-Type: application/xml
<?xml version="1.0" encoding="utf-8"?>
<CreateSessionRequest>
<AuthenticationType>HMAC</AuthenticationType>
</CreateSessionRequest>
回應
成功操作會回傳狀態碼 201(已建立)。
回應機構
回應實體包含新建立會話的資訊與憑證。
<?xml version="1.0" encoding="utf-8"?>
<CreateSessionResult>
<Id>4e6a585b-5fd9-49f5-aa81-014a9dbaa5cc</Id>
<Expiration>2025-08-25T19:48:17.8038151Z</Expiration>
<AuthenticationType>HMAC</AuthenticationType>
<Credentials>
<SessionToken>aB1cD2eF-3gH4iJ5kL6-mN7oP8qR=</SessionToken>
<SessionKey>aaaaaaaa0b0b1c1c2d2d333333333333==</SessionKey>
</Credentials>
</CreateSessionResult>
回應內容包括以下要素:
| Element | Description |
|---|---|
Id |
會話的唯一識別碼。 |
Expiration |
會議結束的時間點。 |
AuthenticationType |
與會話相關的認證機制。 |
Credentials |
包含授權使用會話請求所需的憑證。 |
SessionToken |
一個不透明的標記,用於授權會話中後續的請求。 將會話令牌視為安全憑證。 |
SessionKey |
對於 HMAC 會話,對稱金鑰用於使用共享金鑰簽署協定簽署請求。 把會話金鑰當作安全憑證來處理。 |
Authorization
建立會話需要 Microsoft Entra ID 授權。
- 請用 Microsoft Entra 存取權杖授權請求。
會話的範圍是請求 URI 中指定的容器,且不會授予超過 Microsoft Entra 安全主體權限以外的權限。 主體必須有權限對所請求的資源執行 Get Blob。
使用 Get Blob 的會議
對於 HMAC 會話,請使用回傳的 SessionToken 和 SessionKey 授權後續的 Get Blob 請求。
用戶端使用會話金鑰簽署請求,並在授權標頭中包含所產生的簽章與會話標記:
Authorization: Session {SessionToken}:{Signature}
例如:
GET /mycontainer/myblob HTTP/1.1
Host: myaccount.blob.core.windows.net
Authorization: Session {SessionToken}:{Signature}
x-ms-version: {version}
會話的範圍是建立它的容器。
會話壽命與續期
會話會在五分鐘後到期,但如果所提供的 OAUTH 代幣較早到期,會話可能會更早失效。 當現有會話到期或不再有效時,客戶應該重新申請新會話。
會話狀態
對使用會話授權的請求回應可以包含會話狀態資訊。
| 會話狀態 | Description |
|---|---|
session_expiring |
該會話即將到期或將失效。 用戶端應在現有會話無法使用前取得新會話。 |
session_expired |
該會話已過期、未被發現或已被撤銷。 該會話已無法再使用。 客戶應該建立一個新的會話。 |
session_token_invalid |
所提供的會話令牌形式錯誤或語法無效。 |
session_expiring狀態可在回應標頭中回傳x-ms-auth-info。
當 401 未授權時,會話授權失敗時,服務可在標頭中回傳會話錯誤資訊 WWW-Authenticate 。
當所提供的會話有效但未授權該請求的資源或操作時,請求也可能因 403 禁止 而失敗。
備註
Context
當會話建立時,Azure Blob 儲存體 會評估呼叫者的 Microsoft Entra 身份以及適用的 RBAC 和 ABAC 權限。 後續請求會依此會話上下文授權。
Scope
會話的範圍是請求中 Create Session 指定的容器,無法用來存取其他容器。 它不會授予除創建該身份外的權限。
在會話生命週期內所做的權限變更,當建立新會話時生效。
許可評估
建立會話會在會話建立時評估授權。 帳號、容器或權限的變更不會反映在現有的工作階段中。 當現有五分鐘會議結束後,新建會話時,這些變更會反映出來。
網路背景
會話會保留建立時所適用的網路上下文。 後續使用該會話的請求必須來自同一用戶端 IP 位址。 來自不同用戶端 IP 位址的請求會被拒絕。
安全性
SessionToken 和 SessionKey 是安全憑證,應受到保護,避免被揭露。
Limitations
基於會話的認證目前僅支援取得 Blob 操作。 不支援以下案例:
- 使用 Session 憑證的 Get Blob 請求的 Blob 標籤。
- 把 Blob 請求傳到次要帳號。
- Microsoft Purview 使用會話憑證。
其他 Blob 儲存體 操作必須使用現有支援的授權機制。
Billing
定價請求可以來自使用 Blob 儲存體 API 的客戶端,無論是直接透過 Blob 儲存體 REST API 或透過 Azure 儲存體 客戶端函式庫。 這些要求會依交易產生費用。 交易類型決定了帳戶的收費方式。 例如,已讀交易在不同於寫入交易的計費類別中產生費用。
下表顯示根據儲存帳戶類型建立會話請求的計費類別:
| 作業 | 記憶體帳戶類型 | 計費類別 |
|---|---|---|
| 建立會議 | 進階區塊 Blob 標準一般用途 v2 標準一般用途 v1 |
寫入操作 |
欲了解指定計費類別的定價,請參閱 Azure Blob 儲存體 定價。