Azure.Extensions.AspNetCore.DataProtection.Blobs 1.3.4

Azure Storage Blob Key Store for Microsoft.AspNetCore.DataProtection

Azure.Extensions.AspNetCore.DataProtection.Blobs 包允许将 ASP.NET Core DataProtection 密钥存储在 Azure Blob Storage 中。密钥可以跨多个 Web 应用的实例共享。应用可以跨多台服务器共享身份验证 Cookie 或 CSRF 保护。

入门

安装包

使用 NuGet 安装包

dotnet add package Azure.Extensions.AspNetCore.DataProtection.Blobs

先决条件

您需要一个 Azure 订阅，存储账户 和 存储容器 以使用此包。

要创建一个新的存储帐户，您可以使用 Azure 门户、Azure PowerShell 或 Azure CLI。以下是一个使用 Azure CLI 的示例。

az storage account create --name <storage-account> --resource-group <resource-group> --location westus --sku Standard_LRS
az storage container create --account-name <storage-account> -n <container>

# Give write access to a user
az role assignment create --role "Storage Blob Data Contributor" --assignee <your_email> --scope "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>/blobServices/default/containers/<container>"

# OR give write access to a service principal (application)
az role assignment create --role "Storage Blob Data Contributor" --assignee-object-id <application_id> --scope "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>/blobServices/default/containers/<container>"

关键概念

线程安全

我们保证所有客户端实例的方法都是线程安全的，并且互不干扰（请参阅指导方针）。这确保了重用客户端实例的建议总是安全的，即使在多线程的情况下。

其他概念

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

示例

要启用将密钥持久化到 Azure Blob 存储，请调用 PersistKeysToAzureBlobStorage 方法。提供的 Uri 必须是以下形式的 blob URI：https://{storage_account}.blob.core.windows.net/{container}/{blob}。

public void ConfigureServices(IServiceCollection services)
{
    services
        .AddDataProtection()
        .PersistKeysToAzureBlobStorage(new Uri("<full-blob-URI>"), new DefaultAzureCredential());
}

Azure Identity 库 为 Azure Active Directory 认证提供了简单支持。

使用连接字符串进行身份验证

public void ConfigureServices(IServiceCollection services)
{
    services
        .AddDataProtection()
        .PersistKeysToAzureBlobStorage("<connection string>", "<container name>", "<blob name>");
}

下一步

了解更多关于 ASP.NET Core 中的数据保护 的信息。

贡献

本项目欢迎贡献和建议。大多数贡献都需要您同意一项贡献者许可协议（CLA），声明您有权，并且实际上确实已经授予我们使用您贡献的权利。有关详细信息，请访问 cla.microsoft.com。

本项目采用了 Microsoft Open Source Code of Conduct。有关更多信息，请参阅 行为准则 FAQ 或通过 [email protected] 联系我们，以解决任何额外的问题或评论。