Reemplazar machineKey> de ASP.NET en ASP.NET Core

La implementación del elemento <machineKey> en ASP.NET se puede reemplazar. Esto permite que la mayoría de las llamadas a las rutinas criptográficas de ASP.NET se enruten a través de un mecanismo de protección de datos de reemplazo, incluido el nuevo sistema de protección de datos.

Instalación del paquete

Para instalar el nuevo sistema de protección de datos en un proyecto existente ASP.NET 4.5.1+, instale el paquete Microsoft.AspNetCore.DataProtection.SystemWeb. Esto creará una instancia del sistema de protección de datos mediante los valores de configuración predeterminados.

Al instalar el paquete, este inserta una línea en Web.config que indica a ASP.NET que la use para la mayoría de las operaciones criptográficas, incluida la autenticación de formularios, el estado de vista y las llamadas a MachineKey.Protect. No usa la API de protección de datos. En la línea que se inserta pone lo siguiente.

<machineKey compatibilityMode="Framework45" dataProtectorType="..." />

<input type="hidden" name="__VIEWSTATE" id="__VIEWSTATE" value="CfDJ8AWPr2EQPTBGs3L2GCZOpk...">

Configuración de paquete

Se crea una instancia del sistema de protección de datos con una configuración predeterminada de configuración cero. Sin embargo, dado que, de forma predeterminada, las claves se conservan en el sistema de archivos local, esto no servirá para las aplicaciones que se implementen en una granja de servidores. Para resolverlo, puede proporcionar la configuración mediante la creación de un tipo que subclasifique DataProtectionStartup e invalide su método ConfigureServices.

A continuación se muestra un ejemplo de un tipo de inicio de protección de datos personalizado que configura tanto dónde se conservan las claves como cómo se cifran en rest. También invalida la directiva de aislamiento de aplicaciones predeterminada proporcionando su propio nombre de aplicación.

using System;
using System.IO;
using Microsoft.AspNetCore.DataProtection;
using Microsoft.AspNetCore.DataProtection.SystemWeb;
using Microsoft.Extensions.DependencyInjection;

namespace DataProtectionDemo
{
    public class MyDataProtectionStartup : DataProtectionStartup
    {
        public override void ConfigureServices(IServiceCollection services)
        {
            services.AddDataProtection()
                .SetApplicationName("my-app")
                .PersistKeysToFileSystem(new DirectoryInfo(@"\\server\share\myapp-keys\"))
                .ProtectKeysWithCertificate("thumbprint");
        }
    }
}

Para habilitar esta configuración personalizada, vuelva a Web.config y busque el elemento <appSettings> que el paquete instala agregado al archivo de configuración. El resultado tendrá un aspecto similar al siguiente:

<appSettings>
  <!--
  If you want to customize the behavior of the ASP.NET Core Data Protection stack, set the
  "aspnet:dataProtectionStartupType" switch below to be the fully-qualified name of a
  type which subclasses Microsoft.AspNetCore.DataProtection.SystemWeb.DataProtectionStartup.
  -->
  <add key="aspnet:dataProtectionStartupType" value="" />
</appSettings>

Rellene el valor en blanco con el nombre completo del ensamblado del tipo derivado de DataProtectionStartup que acaba de crear. Si el nombre de la aplicación es DataProtectionDemo, sería similar al siguiente.

<add key="aspnet:dataProtectionStartupType"
     value="DataProtectionDemo.MyDataProtectionStartup, DataProtectionDemo" />

El sistema de protección de datos recién configurado ya está listo para su uso dentro de la aplicación.