Share via

passport Element for authentication (ASP.NET Settings Schema)

  • Article

Specifies the page to redirect to if the page requires authentication and the user has not signed on with Microsoft Passport authentication.

<passport 
   redirectUrl="redirectURL"
/>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description

redirectUrl

Required attribute.

The URL to which the request is redirected. This is typically the URL to a Passport login page.

The default is "internal".

Child Elements

None.

Parent Elements

Element Description

configuration

The required root element in every configuration file used by the common language runtime and .NET Framework applications.

system.web

Specifies the root element for the ASP.NET configuration settings in a configuration file. Contains configuration elements that configure ASP.NET Web applications and control how the applications behave.

authentication

Configures the ASP.NET authentication scheme that is used to identify users who view an ASP.NET application.

Remarks

The passport element specifies the page to redirect to if the page requires authentication and the user has not signed on with Microsoft Passport authentication. This element is only effective if the mode attribute of the authentication element is set to Passport. For more information, see Passport Authentication Provider.

Default Configuration

The following default authentication element is not explicitly configured in the machine configuration file or in the root Web.config file, but is the default configuration returned by application.

<passport redirectUrl="internal" />

Example

The following example specifies the logon page that requests are redirected to.

<configuration>
   <system.web>
      <authentication>
         <passport redirectUrl="Login.aspx"/>
      </authentication>
   </system.web>
</configuration>

Element Information

Configuration Section Handler

AuthenticationSection

Configuration Member

PassportAuthentication

Configurable Locations

Machine.config

Root level Web.config

Application level Web.config

Requirements

IIS 5.0, IIS 5.1, or IIS 6.0

.NET Framework 1.0, 1.1, or 2.0

Visual Studio 2003, or Visual Studio 2005

See Also

Tasks

How to: Configure Specific Directories Using Location Settings
How to: Lock ASP.NET Configuration Settings

Reference

authentication Element (ASP.NET Settings Schema)
system.web Element (ASP.NET Settings Schema)
forms Element for authentication (ASP.NET Settings Schema)
passport Element for authentication (ASP.NET Settings Schema)
configuration Element (General Settings Schema)
System.Configuration
System.Web.Configuration
AuthenticationSection

Concepts

Passport Authentication Provider
ASP.NET Configuration File Hierarchy and Inheritance
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios

Other Resources

ASP.NET Authentication
General Configuration Settings (ASP.NET)
ASP.NET Configuration Settings
Configuring ASP.NET Applications
ASP.NET Configuration Files
ASP.NET Configuration API