You need to enable JavaScript to run this app. .NET Azure Blob存储v12 SDK迁移:如何结合Azure Key Vault实现Blob加密?
优惠活动
大模型
产品
解决方案
定价
更多

.NET Azure Blob存储v12 SDK迁移:如何结合Azure Key Vault实现Blob加密?

Azure Blob Storage v12 SDK 结合 Azure Key Vault 的客户端侧加密实现

从v11迁移到v12 SDK的过程中,客户端侧加密的API做了完全重构,原有的BlobEncryptionPolicy类、BlobRequestOptions.EncryptionPolicy配置项已经被彻底移除,旧版基于v11的加密教程和现有代码无法直接复用到v12生态,整套能力被迁移到独立的扩展包中实现。

所需依赖

实现该能力需要引入以下NuGet包:

  • Azure.Storage.Blobs:Blob存储核心SDK
  • Azure.Security.KeyVault.Keys:对接Key Vault的密钥操作SDK
  • Azure.Identity:统一Azure服务的身份认证实现
  • Azure.Storage.Blobs.Encryption:v12版本的Blob客户端侧加密扩展

核心实现逻辑

v12版本没有沿用旧版手动拼接加密策略、给每个请求单独传加密选项的模式,而是在客户端初始化阶段就注入加密配置,后续的上传、下载操作会自动完成透明的加密、解密流程,密钥解析逻辑也被抽成了独立的接口实现,替换了旧版的密钥解析器能力。

对应旧版代码的迁移示例

原来v11中手动获取RSA密钥、构造加密策略、给每个上传请求传自定义选项的逻辑,在v12中的实现流程如下:

  1. 初始化认证实例和密钥解析器,完成Key Vault密钥的拉取
    // 初始化统一身份认证,可根据实际场景替换为托管身份、服务主体等认证方式
    var credential = new DefaultAzureCredential();
    // 初始化Key Vault密钥解析器,对应v11版本的cloudResolver能力
    var keyResolver = new KeyResolver(credential);
    // 拉取指定的Key Vault RSA密钥,对应v11版本通过ResolveKeyAsync获取的rsa对象
    var key = await keyResolver.ResolveKeyAsync(
        keyId: new Uri("https://contosokeyvault.vault.azure.net/keys/TestRSAKey1"),
        cancellationToken: CancellationToken.None);
    
  2. 初始化带加密能力的Blob客户端,完成加密配置注入
    // 为Blob客户端添加客户端侧加密配置,对应v11中手动构造BlobEncryptionPolicy的流程
    var blobClientOptions = new BlobClientOptions()
        .AddClientSideEncryption(
            keyEncryptionKey: key,
            keyEncryptionKeyResolver: keyResolver);
    // 初始化Blob容器客户端
    var containerClient = new BlobContainerClient(
        containerUri: new Uri("https://<你的存储账号>.blob.core.windows.net/<容器名>"),
        credential: credential,
        clientOptions: blobClientOptions);
    
  3. 执行Blob操作,无需额外传递加密相关请求参数
    // 获取目标块Blob引用,对应v11的CloudBlockBlob实例
    var blobClient = containerClient.GetBlobClient("MyFile.txt");
    // 上传文件,SDK会自动完成加密流程
    using var fileStream = File.OpenRead(@"C:\Temp\MyFile.txt");
    await blobClient.UploadAsync(fileStream, overwrite: true);
    

迁移注意事项

  • v12的客户端加密格式和v11旧版完全不兼容:通过v11加密的旧Blob文件无法直接通过v12客户端解密,需要单独做格式适配迁移;v12加密生成的Blob也无法被旧版SDK识别读取
  • 权限配置需要满足两点:给认证的服务身份授予Key Vault的密钥封装/解封装(wrap/unwrap key)操作权限,同时授予Blob存储的对应读写权限
  • 旧版中通过BlobRequestOptions传递的请求级自定义配置,在v12中可通过BlobClientOptions统一配置,不需要再在每个请求方法中单独传递

内容的提问来源于stack exchange,提问作者d1no

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.20 01:15:08