Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Реализация элемента <machineKey> в ASP.NET является заменяемой. Это позволяет направлять большинство вызовов криптографических подпрограмм ASP.NET через заменяющий механизм защиты данных, включая новую систему защиты данных.
Установка пакета
Примечание
Новая система защиты данных может быть установлена только в существующем приложении ASP.NET, предназначенным для .NET Framework 4.5.1 или более поздней версии. Установка завершится ошибкой, если приложение предназначено для .NET Framework 4.5 или ниже.
Чтобы установить новую систему защиты данных в существующий проект .NET Framework 4.5.1+, установите пакет Microsoft.AspNetCore.DataProtection.SystemWeb. Это инициализирует систему защиты данных с помощью параметров конфигурации по умолчанию.
При установке пакета в Web.config вставляется строка, которая сообщает ASP.NET использовать его для большинства криптографических операций, включая проверку подлинности форм, состояние просмотра и вызовы MachineKey.Protect. Не используется API защиты данных. Вставленная строка выглядит следующим образом.
<machineKey compatibilityMode="Framework45" dataProtectorType="..." />
Совет
Вы можете определить, активна ли новая система защиты данных, проверяя такие поля, как __VIEWSTATE, которые должны начинаться с "CfDJ8", как показано в приведенном ниже примере. " CfDJ8" — это представление в формате Base64 магического заголовка "09 F0 C9 F0", который идентифицирует полезную нагрузку, защищенную системой защиты данных.
<input type="hidden" name="__VIEWSTATE" id="__VIEWSTATE" value="CfDJ8AWPr2EQPTBGs3L2GCZOpk...">
Конфигурация пакета
Система защиты данных инициализируется с конфигурацией по умолчанию, не требующей настройки. Тем не менее, так как по умолчанию ключи сохраняются в локальной файловой системе, это не будет работать для приложений, развернутых в веб-ферме. Чтобы устранить эту проблему, можно предоставить конфигурацию, создав тип, который наследуется от DataProtectionStartup и переопределяет его метод ConfigureServices.
Ниже приведен пример пользовательского типа запуска защиты данных, который настраивает как место хранения ключей, так и способ шифрования неактивных ключей. Она также переопределяет политику изоляции приложений по умолчанию, задавая собственное имя приложения.
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");
}
}
}
Совет
Можно также использовать <machineKey applicationName="my-app" ... /> вместо явного вызова SetApplicationName. Это удобный механизм, чтобы избежать принудительного создания разработчиком типа, производного от DataProtectionStartup, если все, что им нужно было настроить, — это имя приложения.
Чтобы включить эту настраиваемую конфигурацию, вернитесь в web.config и найдите <appSettings> элемент, добавленный пакетом в файл конфигурации. Эта разметка будет выглядеть следующим образом:
<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>
Заполните пустое поле значением полного имени с указанием сборки для типа, производного от DataProtectionStartup, который вы только что создали. Если имя приложения — DataProtectionDemo, это будет выглядеть следующим образом.
<add key="aspnet:dataProtectionStartupType"
value="DataProtectionDemo.MyDataProtectionStartup, DataProtectionDemo" />
Недавно настроенная система защиты данных теперь готова к использованию внутри приложения.
ASP.NET Core