Export (0) Print
Expand All

FederationConfiguration Class

.NET Framework 4.5

Exposes properties that contain federation settings that control the behavior of the WS-Federation Authentication Module (WSFederationAuthenticationModule) and the Session Authentication Module (SessionAuthenticationModule) in web applications.

System::Object
  System.IdentityModel.Services.Configuration::FederationConfiguration

Namespace:  System.IdentityModel.Services.Configuration
Assembly:  System.IdentityModel.Services (in System.IdentityModel.Services.dll)

public ref class FederationConfiguration

The FederationConfiguration type exposes the following members.

  NameDescription
Public methodFederationConfiguration()Initializes a new instance of the FederationConfiguration class by loading settings from the system.identityModel.services section of the configuration file.
Public methodFederationConfiguration(Boolean)Initializes a new instance of the FederationConfiguration class by optionally loading settings from the system.identityModel.services section of the configuration file.
Public methodFederationConfiguration(String)Initializes a new instance of the FederationConfiguration class from the <federationConfiguration> element with the specified name.
Top

  NameDescription
Public propertyCookieHandlerGets or sets the cookie handler to be used by the Session Authentication Module (SessionAuthenticationModule).
Public propertyCustomElementGets or sets the custom XML element, if any, present in this configuration.
Public propertyIdentityConfigurationGets or sets the IdentityConfiguration object associated with this instance.
Public propertyIsInitializedGets or sets a value that indicates whether the Initialize method has been called.
Public propertyNameGets the name associated with this instance.
Public propertyServiceCertificateGets or sets the X.509 certificate used to sign WS-Federation protocol messages.
Public propertyWsFederationConfigurationGets or sets the configuration settings for the WS-Federation Authentication Module (WSFederationAuthenticationModule).
Top

  NameDescription
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodInitializeInitializes the current instance.
Protected methodLoadConfigurationLoads the properties for the current instance from the configuration file. This method is called by constructors that initialize the newly created FederationConfiguration from configuration settings.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Public fieldStatic memberDefaultFederationConfigurationNameDefines the name of the default <federationConfiguration> element from which settings should be loaded. This is an empty string as the default element is unnamed.
Top

By default web applications have a single FederationConfiguration object that is accessed through the FederatedAuthentication::FederationConfiguration property. The first time the property is accessed a new FederationConfiguration instance is initialized from settings in the configuration file and the FederatedAuthentication::FederationConfigurationCreated event is raised. You can use the properties and methods exposed by the FederationConfiguration class to modify or replace the object initialized from configuration in an event handler. This object is available through the FederationConfigurationCreatedEventArgs::FederationConfiguration property inside the event handler.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft