FederatedAuthentication.FederationConfiguration Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets the singleton FederationConfiguration instance used by the HTTP modules in this web application.
public:
static property System::IdentityModel::Services::Configuration::FederationConfiguration ^ FederationConfiguration { System::IdentityModel::Services::Configuration::FederationConfiguration ^ get(); };public static System.IdentityModel.Services.Configuration.FederationConfiguration FederationConfiguration { get; }static member FederationConfiguration : System.IdentityModel.Services.Configuration.FederationConfigurationPublic Shared ReadOnly Property FederationConfiguration As FederationConfigurationProperty Value
The federation configuration instance.
Exceptions
The FederationConfiguration property is set to null by an event handler for the FederationConfigurationCreated event.
Remarks
A FederationConfiguration object is created and initialized from the <federationConfiguration> element in the configuration file the first time this property is accessed by one of the HTTP modules. Just after the configuration object has been initialized, the FederationConfigurationCreated event is raised to provide a developer with an opportunity to modify the newly created configuration object before it is used to initialize any of the configured HTTP modules. It can be accessed from the FederationConfigurationCreatedEventArgs.FederationConfiguration property in an event handler.
On subsequent accesses, the same configuration instance is returned.
Depending on whether specific modules are present, the property is accessed from within the following methods during initialization: ClaimsAuthorizationModule.InitializePropertiesFromConfiguration, SessionAuthenticationModule.InitializePropertiesFromConfiguration, and WSFederationAuthenticationModule.InitializePropertiesFromConfiguration.
Important
The claims authorization manager (ClaimsAuthorizationManager) that is used to evaluate claims based access checks when using the ClaimsPrincipalPermission class or the ClaimsPrincipalPermissionAttribute class is configured on the IdentityConfiguration object that is set on the federation configuration object referenced through the FederatedAuthentication.FederationConfiguration property. This is true for all applications whether they are ASP.NET applications or not.
