你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Important
基于会话的认证目前处于预览阶段。 您的订阅必须先启用预览,才能使用创建会话操作。
Create Session 操作创建了一个五分钟的会话,范围限定在一个容器上。 会话提供凭据,可用于授权对该容器内资源的后续请求。
会话适用于对同一容器执行多个请求的工作负载,可以减少后续请求所需的认证和授权处理。
请求
可以按如下所示构造 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. 指定要用于此请求的操作的版本。 创建会话仅支持版本或更高版本 2026-02-06 。 有关详细信息,请参阅 Azure 存储服务的版本控制。 |
创建会话必须通过使用 Microsoft Entra 访问令牌授权。 基于会话的授权不能用来创建会话。
请求主体
请求体具有以下 XML 格式:
<?xml version="1.0" encoding="utf-8"?>
<CreateSessionRequest>
<AuthenticationType>HMAC</AuthenticationType>
</CreateSessionRequest>
下表描述了请求体的元素。
| Element | Required | Description |
|---|---|---|
AuthenticationType |
Yes | 规定使用会话请求的认证机制。 目前支持的数值是HMAC。 当指定HMAC时,创建会话返回一个会话密钥,客户端用它来签署后续请求。 |
示例请求
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安全主体的权限。 主体必须有权限对所请求的资源执行获取 Blob。
使用 Get Blob 的会话
对于 HMAC 会话,使用返回的 SessionToken 和 SessionKey 授权后续的获取 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禁止 失败。
备注
上下文
会话创建时,Azure Blob 存储 会评估调用者的 Microsoft Entra 身份以及适用的 RBAC 和 ABAC 权限。 后续请求通过该会话上下文授权。
Scope
会话的范围是请求中 Create Session 指定的容器,不能用来访问其他容器。 它不会授予创建该身份的权限以外的权限。
会话生命周期内所做的权限更改,在新会话创建时生效。
许可评估
创建会话在会话创建时评估授权。 账户、容器或权限的变更不会反映在现有会话中。 当现有五分钟会话结束后,创建新会话时,这些变化会反映出来。
网络背景
会话保留了会话创建时适用的网络上下文。 后续使用该会话的请求必须来自同一客户端IP地址。 来自不同客户端IP地址的请求会被拒绝。
安全性
SessionToken 和 SessionKey 是安全凭证,应当受到保护,避免泄露。
Limitations
基于会话的认证目前仅支持 Get Blob 操作。 不支持以下场景:
- 带有使用 会话凭证的 Get Blob 请求的 Blob 标签。
- 把Blob请求发到二级账户。
- Microsoft Purview 带有会话凭证。
其他 Blob 存储 操作必须使用已有支持的授权机制。
Billing
定价请求可以来自使用 Blob 存储 API 的客户端,直接通过 Blob 存储 REST API 或通过 Azure 存储 客户端库。 这些请求按事务产生费用。 交易类型决定了账户的收费方式。 例如,已读交易在不同计费类别中产生费用,而写交易则是不同的。
下表显示了基于存储账户类型的创建会话请求的计费类别:
| 运算 | 存储账户类型 | 计费类别 |
|---|---|---|
| 创建会话 | 高级块 Blob 标准通用型 v2 标准常规用途 v1 |
写入操作 |
要了解指定计费类别的定价,请参见 Azure Blob 存储 定价。