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 MachineKey-Abschnitts 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 MachineKey-Abschnitt 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 die Verwendung der MachineKeySection Klasse im Code veranschaulicht.

#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 MachineKey Abschnitts in der Konfigurationsdatei zuzugreifen und sie zu ändern. Der Abschnitt MachineKey kann auf Computerebene (Machine.config) oder anwendung (Web.config) konfiguriert werden und steuert die Schlüssel und Algorithmen, die für Windows Forms Authentifizierung, Ansichtsstatusüberprüfung und Anwendungsisolation mit Sitzungsstatus verwendet werden. Damit eines dieser Features über ein Netzwerk von Webservern (eine Webfarm) hinweg funktioniert, müssen die DecryptionKey Attribute ValidationKey und Attribute 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 Geheimschlüssel basiert, der mithilfe des lokalen Computers beibehalten wird und nicht über mehrere Computer hinweg identisch ist.

Hinweise für Vererber

Wenn Sie Schlüssel in diesem Konfigurationsabschnitt angeben möchten, wie in Webfarmszenarien erforderlich, empfiehlt es sich, diesen Abschnitt mithilfe der geschützten Konfiguration zu verschlüsseln.

Weitere Informationen

• ConfigurationSection
• Anmeldeinformationen für die Formularauthentifizierung