你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

基于会话的身份验证(预览版)

基于会话的身份验证缩短了 AI 代理和应用的每次请求认证和授权时间,同时保留了组织已依赖的安全控制。 在基于会话的身份验证中,代理或应用程序只需使用 Microsoft Entra ID 进行一次身份验证,为容器建立一个短命会话,并利用该会话进行后续读取。

基于会话的身份验证非常适合用于读取量大、延迟敏感的工作负载,这些工作负载需要使用相同身份向同一容器发出大量请求,例如 AI 代理、AI 训练与推理、分析以及高性能计算。

Important

基于会话的认证目前处于预览阶段。 有关适用于处于预览版的 Azure 功能的条款,请参阅 Microsoft 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 访问令牌。 由于在创建会话时已验证身份和权限,因此每次请求的身份验证和授权时间有所缩短。

会话流程包含以下步骤:

  1. 客户端获得 Microsoft Entra ID 访问令牌用于 Azure 存储。
  2. 客户端调用目标容器的 创建会话 操作。 Azure 存储 通过使用 Microsoft Entra ID 访问令牌授权该请求。
  3. Azure 存储 返回会话凭据和会话过期时间。
  4. 客户端使用会话凭据为同一容器中的 blob 授权 Get Blob 请求。
  5. 要继续读取数据,客户端在当前会话到期前创建一个新会话。

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 请求,且不会因额外的会话创建请求而受益。

Billing

创建会话按您的存储账户的标准写入事务计费。 使用 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 会自动管理完整的会话生命周期:

  • 创建一个会话并缓存其凭据。
  • 自动使用会话密钥签名每个请求。
  • 使用会话令牌执行 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,您的应用程序必须在当前会话到期前创建会话、签署请求并创建替换会话。

  1. 创建会话。 调用容器上的创建会话操作,并使用 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 或更高版本中支持。 有关详细信息,请参阅 创建会话 REST API 文档。

  2. 通过会话读取一个 blob。 调用获取 Blob 操作。 授权头包含会话令牌以及使用会话密钥计算的签名。 会话密钥本身从未被发送。

    示例请求

    GET https://myaccount.blob.core.windows.net/mycontainer/myblob
    Authorization: Session {SessionToken}:{Signature}
    x-ms-version: {version}
    

    有关详细信息,请参阅 创建会话 REST API 文档。

  3. 在到期前续订。 会话在五分钟后到期,且无法延长。 会话过期时发出的请求失败。 当需要不中断访问时,请在当前会话到期前创建一个替代会话。

注意事项和限制

  • 要使用此功能,您必须获得批准才能加入预览。 有关详细信息,请参阅 入门。
  • 基于会话的身份验证仅限于 Get Blob 操作。 会话令牌仅支持 Get Blob 操作;所有其他操作都需要 Microsoft Entra ID 访问令牌。 Azure 存储 SDK 会自动处理此事,根据操作选择使用哪个令牌。
  • 基于会话的身份验证可以减少高频读取工作负载的身份验证和授权时间。 Azure 存储 不会对每个 Get Blob 请求执行完整的 OAuth 令牌验证和授权评估,而是建立一个临时安全上下文,该上下文可在后续请求中重复使用。 这缩短了每次请求的身份验证和授权时间,有助于为吞吐量密集且延迟敏感的工作负载提供更可预测的延迟。
  • 当在短时间内执行大量 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 角色时遵循最小权限原则。 仅在应用程序要求的最窄范围内授予读取权限。 有关详细信息,请参阅分配用于访问 Blob 数据的 Azure 角色。
  • 会话采用透明的安全边界设计。 会话的范围只限于单个容器,绑定创建该容器的身份,并在五分钟后失效。 通过会话发出的所有请求都归属于原始的 Microsoft Entra ID 身份。 会话凭据无法无限期重复使用,必须在过期后重新创建。 会话还绑定到源客户端 IP,有助于防止会话凭据被其他机器重复使用。
  • 不支持:
    • 获取 Blob 操作的 Blob 索引标签,这意味着在使用会话令牌时,你看不到与所访问 blob 关联的任何标签。
    • 可在次要帐户上执行 Get Blob 读取操作;你只能在主帐户上调用 Get Blob,并使用会话令牌作为身份验证方法。
    • 不支持页 blob 和追加 blob,仅支持块 blob。
    • 用户绑定用户委派 SAS、用户委派 SAS、服务 SAS、账户 SAS 和共享密钥授权,仅支持 Microsoft Entra ID 进行身份验证。
    • Microsoft Purview 不支持会话令牌。

监控基于会话的身份验证

Azure 存储 将创建会话请求和会话内发出的请求记录到 Azure Monitor 资源日志中。 要收集这些日志,请为 Blob 存储 配置诊断设置,将 StorageRead 日志发送到 Log Analytics 工作区、存储帐户或事件中心。 有关详细信息,请参阅 监视 Azure Blob 存储。

创建会话请求

创建会话请求以操作名为 CreateSession 的 StorageRead 类别显示,认证类型为 OAuth。 每个条目包括:

  • 呼叫者身份:创建会话的 Microsoft Entra ID 安全主体,包括其对象 ID、租户 ID、用户主体名称和客户端应用程序 ID。
  • 授权决策:评估的操作、授予访问权限的 Azure 角色分配和角色定义,以及结果。
  • 会话 ID: 会话的唯一标识符。
  • 目标容器: 会话范围对应的存储账户和容器。
  • 网络和请求详情: 呼叫方 IP 地址、协议、TLS 版本、状态码、延迟、客户端请求 ID 和用户代理。

会话内发出的请求

由会话授权的获取 Blob 请求以操作名为 GetBlob 的 StorageRead 类别显示,认证类型为 Session。 每个条目中没有调用者的身份和授权详细信息,而是包含用于授权请求的会话 ID 、被读取的 blob、呼叫方 IP 地址和标准请求详细信息。

要查找会话内请求背后的 Microsoft Entra ID 身份,请将 GetBlob 操作中的会话 ID 与相应的 CreateSession 操作中的会话 ID 匹配。 “创建会话”条目记录 Microsoft Entra 身份以及授权该会话的 Azure 角色分配。

Troubleshooting

当会话请求失败时,请检查响应头中有关失败的具体信息。

问题 建议的操作
创建会话请求失败 验证请求使用有效的 Microsoft Entra ID 访问令牌,针对目标容器,使用 HTTPS,并且安全主体具有所需的权限。
获取 Blob 请求返回授权错误 验证会话是为同一容器创建的,并且 Microsoft Entra ID 安全主体对请求的 blob 具有读取权限。
会话已过期或未找到 创建一个新会话,并使用新的会话凭据重试获取 Blob 请求。
会话令牌无效 丢弃当前会话凭据,创建一个新会话,并确保凭据值未被修改。
不同的操作使用会话授权时失败 仅在获取 Blob 操作中使用基于会话的身份验证。 在其他操作中使用 Microsoft Entra ID 访问令牌。

后续步骤