Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IntranetZoneCredentialPolicy Class

Note: This class is new in the .NET Framework version 2.0.

Defines a credential policy to be used for resource requests that are made using WebRequest and its derived classes.

Namespace: Microsoft.Win32
Assembly: System (in system.dll)

public class IntranetZoneCredentialPolicy : ICredentialPolicy
public class IntranetZoneCredentialPolicy implements ICredentialPolicy
public class IntranetZoneCredentialPolicy implements ICredentialPolicy

This policy allows credentials to be sent only if the requested resource is in the same domain as the client that is making the request. For many applications this is the optimal policy because it prevents network credentials from being sent with requests for resources that are not on the intranet.

NoteNote

ICredentialPolicy policies are invoked only if the WebRequest or the WebProxy that is associated with the request has credentials that are not a null reference (Nothing in Visual Basic). Setting this policy has no effect on requests that do not specify credentials.

Use the AuthenticationManager.CredentialPolicy property to set the IntranetZoneCredentialPolicy policy. The IAuthenticationModule that handles authentication for the request will invoke the ShouldSendCredential method before performing the authentication. If the requested resource is in a different domain than the client, the ShouldSendCredential method returns false, and authentication is not performed.

This policy affects all instances of WebRequest with non-null credentials in the current application domain. The policy cannot be overridden on individual requests.

The following code example demonstrates creating an instance of IntranetZoneCredentialPolicy and using it to set the credential policy for the application domain.

 public static void UseIntranetCredentialPolicy()
{
    IntranetZoneCredentialPolicy  policy = new IntranetZoneCredentialPolicy();
    AuthenticationManager.CredentialPolicy = policy;
}

System.Object
  Microsoft.Win32.IntranetZoneCredentialPolicy
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.