FormsAuthentication.EnableCrossAppRedirects 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 a value indicating whether authenticated users can be redirected to URLs in other Web applications.
public:
static property bool EnableCrossAppRedirects { bool get(); };
public static bool EnableCrossAppRedirects { get; }
static member EnableCrossAppRedirects : bool
Public Shared ReadOnly Property EnableCrossAppRedirects As Boolean
Property Value
true
if authenticated users can be redirected to URLs in other Web applications; otherwise, false
. The default is false
.
Examples
The following code example sets the enableCrossAppRedirects
attribute to true
in the Web.config file for an ASP.NET application.
<authentication mode="Forms">
<forms loginUrl="member_login.aspx"
cookieless="UseUri"
requireSSL="true"
enableCrossAppRedirects="true" />
</authentication>
Remarks
The EnableCrossAppRedirects property value is set using the enableCrossAppRedirects
attribute of the forms configuration element.
The EnableCrossAppRedirects property is checked within the RedirectFromLoginPage method when the redirect URL does not point to a page in the current application. If EnableCrossAppRedirects is true
, then the redirect is performed; if EnableCrossAppRedirects is false
, the browser is redirected to the page defined in the DefaultUrl property.
Note
When you redirect pages across applications, you must make sure that specific attributes in the forms configuration element are duplicated across the authenticated applications. For more information and an example, see Forms Authentication Across Applications.
Important
When cross-application redirects are allowed, your site is vulnerable to an exploit that directs users to a malicious Web site but uses the login page for your site. Always verify that the redirect URL that is returned by the GetRedirectUrl method is a URL that you expect so that you can make sure that you allow redirects only to approved Web sites. You must also verify that the redirect URL uses the appropriate protocol (HTTP or HTTPS). To perform these verifications, you can add a postback event handler to your login page, or you can add a handler for the LoggedIn event of the Login control.