passport Element for authentication (ASP.NET Settings Schema)

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

configuration Element (General Settings Schema)
  system.web Element (ASP.NET Settings Schema)
    authentication Element (ASP.NET Settings Schema)
      passport Element for authentication (ASP.NET Settings Schema)

<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

ASP.NET Configuration File Hierarchy and Inheritance

Securing ASP.NET Configuration

ASP.NET Configuration Scenarios

Other Resources

ASP.NET Authentication

Passport Authentication Provider

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

ASP.NET Web Site Administration

ASP.NET Configuration Files

ASP.NET Configuration API