Azure.Extensions.AspNetCore.Configuration.Secrets 1.3.1

Microsoft.Extensions.Configuration 的 Azure Key Vault Secrets 配置提供程序

Azure.Extensions.AspNetCore.Configuration.Secrets 包允许使用 Azure Key Vault Secrets 存储配置值。

入门

安装包

使用 NuGet 安装包

dotnet add package Azure.Extensions.AspNetCore.Configuration.Secrets

先决条件

您需要一个 Azure 订阅 和 Azure Key Vault 来使用此包。

要创建新的密钥保管库，您可以使用 Azure 门户，Azure PowerShell 或 Azure CLI。以下是一个使用 Azure CLI 的示例

az keyvault create --name MyVault --resource-group MyResourceGroup --location westus
az keyvault secret set --vault-name MyVault --name MySecret --value "hVFkk965BuUv"

Azure 角色访问控制

在使用Azure基于角色的访问控制时，您正在认证的标识必须具有"密钥保管库读取器"和"密钥保管库秘密用户"角色。"密钥保管库读取器"角色允许扩展列出秘密，而"密钥保管库秘密用户"则允许检索它们的值。

az role assignment create --role "Key Vault Reader" --assignee {i.e [email protected]} --scope /subscriptions/{subscriptionid}/resourcegroups/{resource-group-name}
az role assignment create --role "Key Vault Secrets User" --assignee {i.e [email protected]} --scope /subscriptions/{subscriptionid}/resourcegroups/{resource-group-name}

关键概念

线程安全

我们保证所有客户端实例方法都是线程安全的，并且彼此独立（《[指南](https://azure.github.io/azure-sdk/dotnet_introduction.html#dotnet-service-methods-thread-safety)》）。这确保了重用客户端实例的建议始终是安全的，即使在多线程中也是如此。

其他概念

客户端选项 | 访问响应 | 长时间运行操作 | 处理失败 | 诊断 | 模拟 | 客户端生命周期

示例

要从Azure密钥保管库密钥中加载初始化配置，请在ConfigurationBuilder上调用AddAzureKeyVault。

ConfigurationBuilder builder = new ConfigurationBuilder();
builder.AddAzureKeyVault(new Uri("<Vault URI>"), new DefaultAzureCredential());

IConfiguration configuration = builder.Build();
Console.WriteLine(configuration["MySecret"]);

Azure标识库提供了对Azure Active Directory认证的简单支持。

下一步

深入了解ASP.NET Core中的配置。

贡献

此项目欢迎贡献和建议。大多数贡献要求您同意一个贡献者许可协议（CLA），声明您拥有并确实授予我们使用您的贡献的权力。有关详细信息，请访问cla.microsoft.com。

此项目已采用Microsoft开源行为准则。有关更多信息，请参阅行为准则常见问题解答或通过[email protected]提出任何额外的疑问或评论。