你当前正在访问 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 存储 定价。