.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存储核心SDKAzure.Security.KeyVault.Keys:对接Key Vault的密钥操作SDKAzure.Identity:统一Azure服务的身份认证实现Azure.Storage.Blobs.Encryption:v12版本的Blob客户端侧加密扩展
核心实现逻辑
v12版本没有沿用旧版手动拼接加密策略、给每个请求单独传加密选项的模式,而是在客户端初始化阶段就注入加密配置,后续的上传、下载操作会自动完成透明的加密、解密流程,密钥解析逻辑也被抽成了独立的接口实现,替换了旧版的密钥解析器能力。
对应旧版代码的迁移示例
原来v11中手动获取RSA密钥、构造加密策略、给每个上传请求传自定义选项的逻辑,在v12中的实现流程如下:
- 初始化认证实例和密钥解析器,完成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); - 初始化带加密能力的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); - 执行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
相关产品推荐
相关产品推荐

