MachineKeySection 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Windows Forms 인증, 뷰 상태 유효성 검사 및 세션 상태 애플리케이션 격리에서 암호화, 암호 해독 및 MAC(메시지 인증 코드) 작업에 사용되는 키 생성 및 알고리즘을 제어하는 구성 설정을 정의합니다. 이 클래스는 상속할 수 없습니다.
public ref class MachineKeySection sealed : System::Configuration::ConfigurationSectionpublic sealed class MachineKeySection : System.Configuration.ConfigurationSectiontype MachineKeySection = class
inherit ConfigurationSectionPublic NotInheritable Class MachineKeySection
Inherits ConfigurationSection- 상속
예제
이 섹션의 예제에서는 machineKey 섹션의 여러 특성에 대해 선언적으로 값을 지정하는 방법을 보여 줍니다. 이 특성은 클래스의 MachineKeySection 멤버로도 액세스할 수 있습니다.
구성 파일의 다음 예제에서는 machineKey 섹션에 대해 선언적으로 값을 지정하는 방법을 보여 줍니다.
<system.web>
<machineKey validationKey="AutoGenerate,IsolateApps"
decryptionKey="AutoGenerate,IsolateApps"
validation="SHA1"/>
</system.web>
이 예제에서는 SHA1을 사용합니다. SHA1 관련 충돌 문제로 인해 SHA256을 사용하는 것이 좋습니다.
다음 예제에서는 코드에서 클래스를 MachineKeySection 사용하는 방법을 보여 줍니다.
#region Using directives
using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using System.Web;
using System.Web.Configuration;
#endregion
namespace Samples.Aspnet.SystemWebConfiguration
{
class UsingMachineKeySection
{
static void Main(string[] args)
{
try
{
// Set the path of the config file.
string configPath = "";
// Get the Web application configuration object.
Configuration config = WebConfigurationManager.OpenWebConfiguration(configPath);
// Get the section related object.
MachineKeySection configSection =
(MachineKeySection)config.GetSection("system.web/machineKey");
// Display title and info.
Console.WriteLine("ASP.NET Configuration Info");
Console.WriteLine();
// Display Config details.
Console.WriteLine("File Path: {0}",
config.FilePath);
Console.WriteLine("Section Path: {0}",
configSection.SectionInformation.Name);
// Display ValidationKey property.
Console.WriteLine("ValidationKey: {0}",
configSection.ValidationKey);
// Set ValidationKey property.
configSection.ValidationKey = "AutoGenerate,IsolateApps";
// Display DecryptionKey property.
Console.WriteLine("DecryptionKey: {0}",
configSection.DecryptionKey);
// Set DecryptionKey property.
configSection.DecryptionKey = "AutoGenerate,IsolateApps";
// Display Validation property.
Console.WriteLine("Validation: {0}",
configSection.Validation);
// Set Validation property.
configSection.Validation = MachineKeyValidation.HMACSHA256;
// Update if not locked.
if (!configSection.SectionInformation.IsLocked)
{
config.Save();
Console.WriteLine("** Configuration updated.");
}
else
{
Console.WriteLine("** Could not update, section is locked.");
}
}
catch (Exception e)
{
// Unknown error.
Console.WriteLine(e.ToString());
}
// Display and wait
Console.ReadLine();
}
}
}
Imports System.Collections.Generic
Imports System.Text
Imports System.Configuration
Imports System.Web
Imports System.Web.Configuration
Namespace Samples.Aspnet.SystemWebConfiguration
Class UsingMachineKeySection
Public Shared Sub Main()
Try
' Set the path of the config file.
Dim configPath As String = ""
' Get the Web application configuration object.
Dim config As System.Configuration.Configuration = _
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration(configPath)
' Get the section related object.
Dim configSection As System.Web.Configuration.MachineKeySection = _
CType(config.GetSection("system.web/machineKey"), _
System.Web.Configuration.MachineKeySection)
' Display title and info.
Console.WriteLine("ASP.NET Configuration Info")
Console.WriteLine()
' Display Config details.
Console.WriteLine("File Path: {0}", config.FilePath)
Console.WriteLine("Section Path: {0}", configSection.SectionInformation.Name)
' Display ValidationKey property.
Console.WriteLine("ValidationKey: {0}", _
configSection.ValidationKey)
' Set ValidationKey property.
configSection.ValidationKey = "AutoGenerate,IsolateApps"
' Display DecryptionKey property.
Console.WriteLine("DecryptionKey: {0}", configSection.DecryptionKey)
' Set DecryptionKey property.
configSection.DecryptionKey = "AutoGenerate,IsolateApps"
' Display Validation value.
Console.WriteLine("Validation: {0}", configSection.Validation)
' Set Validation value.
configSection.Validation = MachineKeyValidation.HMACSHA256
' Update if not locked.
If Not configSection.SectionInformation.IsLocked Then
config.Save()
Console.WriteLine("** Configuration updated.")
Else
Console.WriteLine("** Could not update, section is locked.")
End If
Catch e As Exception
' Unknown error.
Console.WriteLine(e.ToString())
End Try
' Display and wait
Console.ReadLine()
End Sub
End Class
End Namespace
설명
클래스는 MachineKeySection 프로그래밍 방식으로 액세스 하 고 구성 파일에서 섹션의 MachineKey 콘텐츠를 수정 하는 방법을 제공 합니다.
MachineKey 섹션은 컴퓨터(Machine.config) 또는 애플리케이션(Web.config) 수준에서 구성할 수 있으며 Windows Forms 인증, 뷰 상태 유효성 검사 및 세션 상태 애플리케이션 격리에 사용되는 키와 알고리즘을 제어합니다. 이러한 기능이 웹 서버 네트워크(웹 팜)DecryptionKey에서 작동하려면 섹션의 ValidationKey 특성과 MachineKey 특성을 유효한 키 값으로 명시적이고 동일하게 구성해야 합니다. 이 값은 AutoGenerate 컴퓨터 로컬 보호를 사용하여 유지되며 둘 이상의 컴퓨터에서 동일하지 않은 암호화된 임의 비밀을 사용하므로 웹 팜에서 작동하지 않습니다.
상속자 참고
웹 팜 시나리오에서 필요한 대로 이 구성 섹션에서 키를 지정하려면 보호된 구성을 사용하여 이 섹션을 암호화하는 것이 좋습니다.
생성자
| Name | Description |
|---|---|
| MachineKeySection() |
기본 설정을 사용하여 클래스의 새 인스턴스를 MachineKeySection 초기화합니다. |
속성
| Name | Description |
|---|---|
| ApplicationName |
애플리케이션의 이름을 가져오거나 설정합니다. |
| CompatibilityMode |
.NET Framework 버전 2.0 서비스 팩 1 릴리스 후에 도입된 뷰 상태에 대해 업그레이드된 암호화 방법을 사용할지 여부를 지정하는 값을 가져오거나 설정합니다. |
| CurrentConfiguration |
현재 Configuration 인스턴스가 속한 구성 계층 구조를 나타내는 최상위 ConfigurationElement 인스턴스에 대한 참조를 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| DataProtectorType |
데이터 보호기 형식의 이름을 가져오거나 설정합니다. 기본값은 Empty입니다. |
| Decryption |
양식 인증 데이터를 암호화 및 암호 해독하는 데 사용되는 암호화 알고리즘을 지정합니다. |
| DecryptionKey |
데이터를 암호화 및 암호 해독하는 데 사용되는 키 또는 키가 생성되는 프로세스를 가져오거나 설정합니다. |
| ElementInformation |
사용자 지정할 수 없는 정보와 ElementInformation 개체의 기능이 포함된 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| ElementProperty |
ConfigurationElementProperty 개체 자체를 나타내는 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| EvaluationContext |
ContextInformation 개체에 대한 ConfigurationElement 개체를 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| HasContext |
CurrentConfiguration 속성이 |
| Item[ConfigurationProperty] |
이 구성 요소의 속성 또는 특성을 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement) |
| Item[String] |
이 구성 요소의 속성, 특성 또는 자식 요소를 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement) |
| LockAllAttributesExcept |
잠긴 특성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| LockAllElementsExcept |
잠긴 요소의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| LockAttributes |
잠긴 특성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| LockElements |
잠긴 요소의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| LockItem |
요소가 잠겨 있는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 ConfigurationElement) |
| Properties |
속성의 컬렉션을 가져옵니다. (다음에서 상속됨 ConfigurationElement) |
| SectionInformation |
개체의 SectionInformation 사용자 지정할 수 없는 정보 및 기능을 포함하는 개체를 ConfigurationSection 가져옵니다. (다음에서 상속됨 ConfigurationSection) |
| Validation |
양식 인증의 유효성을 검사하고 상태 데이터를 보는 데 사용되는 해시 알고리즘을 지정합니다. |
| ValidationAlgorithm |
양식 인증의 유효성을 검사하고 상태 데이터를 보는 데 사용되는 알고리즘의 이름을 가져오거나 설정합니다. |
| ValidationKey |
폼 인증의 유효성을 검사하고 상태 데이터를 보는 데 사용되는 키 또는 키가 생성되는 프로세스를 가져오거나 설정합니다. |
