MachineKeySection Klasse

Definition

public ref class MachineKeySection sealed : System::Configuration::ConfigurationSection

public sealed class MachineKeySection : System.Configuration.ConfigurationSection

type MachineKeySection = class
    inherit ConfigurationSection

Public NotInheritable Class MachineKeySection
Inherits ConfigurationSection

Vererbung

Object

ConfigurationElement

ConfigurationSection

MachineKeySection

Beispiele

Das Beispiel in diesem Abschnitt veranschaulicht, wie Werte deklarativ für mehrere Attribute des Abschnitts machineKey angegeben werden, auf die auch als Member der MachineKeySection -Klasse zugegriffen werden kann.

Das folgende Beispiel aus einer Konfigurationsdatei zeigt, wie Werte deklarativ für den Abschnitt machineKey angegeben werden.

<system.web>  
  <machineKey validationKey="AutoGenerate,IsolateApps"   
    decryptionKey="AutoGenerate,IsolateApps"   
    validation="SHA1"/>  
</system.web>  

In diesem Beispiel wird SHA1 verwendet. Microsoft empfiehlt aufgrund der Konflikte mit SHA1 SHA256.

Im folgenden Beispiel wird veranschaulicht, wie die MachineKeySection -Klasse im Code verwendet wird.

#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

Hinweise

Die MachineKeySection -Klasse bietet eine Möglichkeit, programmgesteuert auf den Inhalt des Abschnitts MachineKey in der Konfigurationsdatei zuzugreifen und diesen zu ändern. Der MachineKey Abschnitt kann auf Computerebene (Machine.config) oder Anwendungsebene (Web.config) konfiguriert werden und steuert die Schlüssel und Algorithmen, die für die Windows Forms-Authentifizierung, die Überprüfung des Ansichtszustands und die Anwendungsisolation von Sitzungszuständen verwendet werden. Damit eines dieser Features über ein Netzwerk von Webservern (eine Webfarm) hinweg funktioniert, müssen die DecryptionKey Attribute und ValidationKey des MachineKey Abschnitts explizit und identisch mit gültigen Schlüsselwerten konfiguriert werden. Der AutoGenerate Wert funktioniert nicht für Webfarmen, da er auf einem kryptografisch zufälligen Geheimnis basiert, das mithilfe des computerlokalen Schutzes beibehalten wird und nicht auf mehreren Computern identisch ist.

Hinweise für Vererber

Wenn Sie schlüssel in diesem Konfigurationsabschnitt angeben möchten, wie es in Webfarmszenarien erforderlich ist, wird empfohlen, diesen Abschnitt mithilfe der geschützten Konfiguration zu verschlüsseln.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• ConfigurationSection
• Anmeldeinformationen zur Formularauthentifizierung