Schlüsselspeicheranbieter in ASP.NET Core

Das Paket Microsoft.AspNetCore.DataProtection.StackExchangeRedis ermöglicht die Speicherung von Datenschutzschlüsseln in einem Redis-Cache. Schlüssel können über mehrere Instanzen einer Webanwendung verteilt werden. Apps können Authentifizierungs-Cookies oder CSRF-Schutz über mehrere Server hinweg gemeinsam nutzen.

Das Paket Microsoft.AspNetCore.DataProtection.Redis ermöglicht die Speicherung von Datenschutzschlüsseln in einem Redis-Cache. Schlüssel können über mehrere Instanzen einer Webanwendung verteilt werden. Apps können Authentifizierungs-Cookies oder CSRF-Schutz über mehrere Server hinweg gemeinsam nutzen.

Um Redis zu konfigurieren, rufen Sie eine der PersistKeysToStackExchangeRedis-Überladungen auf:

public void ConfigureServices(IServiceCollection services)
{
    var redis = ConnectionMultiplexer.Connect("<URI>");
    services.AddDataProtection()
        .PersistKeysToStackExchangeRedis(redis, "DataProtection-Keys");
}

Um Redis zu konfigurieren, rufen Sie eine der PersistKeysToRedis-Überladungen auf:

public void ConfigureServices(IServiceCollection services)
{
    var redis = ConnectionMultiplexer.Connect("<URI>");
    services.AddDataProtection()
        .PersistKeysToRedis(redis, "DataProtection-Keys");
}

Entity Framework Core

Das Paket Microsoft.AspNetCore.DataProtection.EntityFrameworkCore bietet einen Mechanismus zum Speichern von Datenschutzschlüsseln für eine Datenbank mit Entity Framework Core. Das NuGet-Paket Microsoft.AspNetCore.DataProtection.EntityFrameworkCore muss der Projektdatei hinzugefügt werden, es ist nicht Teil des Microsoft.AspNetCore.App Metapakets.

Mit diesem Paket können Schlüssel über mehrere Instanzen einer Webanwendung hinweg gemeinsam genutzt werden.

Um den EF Core-Anbieter zu konfigurieren, rufen Sie die PersistKeysToDbContext-Methode auf:

public void ConfigureServices(IServiceCollection services)
{
    services.Configure<CookiePolicyOptions>(options =>
    {
        options.CheckConsentNeeded = context => true;
        options.MinimumSameSitePolicy = SameSiteMode.None;
    });

    services.AddDbContext<ApplicationDbContext>(options =>
        options.UseSqlServer(
            Configuration.GetConnectionString("DefaultConnection")));

    // Add a DbContext to store your Database Keys
    services.AddDbContext<MyKeysContext>(options =>
        options.UseSqlServer(
            Configuration.GetConnectionString("MyKeysConnection")));

    // using Microsoft.AspNetCore.DataProtection;
    services.AddDataProtection()
        .PersistKeysToDbContext<MyKeysContext>();

    services.AddDefaultIdentity<IdentityUser>()
        .AddDefaultUI(UIFramework.Bootstrap4)
        .AddEntityFrameworkStores<ApplicationDbContext>();
    services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
}

Wenn Sie möchten, dass Codekommentare in anderen Sprachen als Englisch angezeigt werden, informieren Sie uns in diesem GitHub-Issue.

Der generische Parameter TContext, muss von DbContext erben und IDataProtectionKeyContext implementieren:

using Microsoft.AspNetCore.DataProtection.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;
using WebApp1.Data;

namespace WebApp1
{
    class MyKeysContext : DbContext, IDataProtectionKeyContext
    {
        // A recommended constructor overload when using EF Core 
        // with dependency injection.
        public MyKeysContext(DbContextOptions<MyKeysContext> options) 
            : base(options) { }

        // This maps to the table that stores keys.
        public DbSet<DataProtectionKey> DataProtectionKeys { get; set; }
    }
}

Erstellen Sie die DataProtectionKeys-Tabelle.

Add-Migration AddDataProtectionKeys -Context MyKeysContext
Update-Database -Context MyKeysContext

dotnet ef migrations add AddDataProtectionKeys --context MyKeysContext
dotnet ef database update --context MyKeysContext

MyKeysContext ist die im vorherigen Codebeispiel definierte DbContext. Wenn Sie einen DbContext mit einem anderen Namen verwenden, ersetzen Sie Ihren DbContext-Namen durch MyKeysContext.

Die Klasse/Entität DataProtectionKeys übernimmt die in der folgenden Tabelle dargestellte Struktur.