IntranetZoneCredentialPolicy.ShouldSendCredential 方法

定义

命名空间:

Microsoft.Win32

程序集:

System.dll

返回一个 Boolean，该值指示客户端的凭据是否随使用 WebRequest 发出的资源请求一起发送。

public:
 virtual bool ShouldSendCredential(Uri ^ challengeUri, System::Net::WebRequest ^ request, System::Net::NetworkCredential ^ credential, System::Net::IAuthenticationModule ^ authModule);

public virtual bool ShouldSendCredential (Uri challengeUri, System.Net.WebRequest request, System.Net.NetworkCredential credential, System.Net.IAuthenticationModule authModule);

abstract member ShouldSendCredential : Uri * System.Net.WebRequest * System.Net.NetworkCredential * System.Net.IAuthenticationModule -> bool
override this.ShouldSendCredential : Uri * System.Net.WebRequest * System.Net.NetworkCredential * System.Net.IAuthenticationModule -> bool

Public Overridable Function ShouldSendCredential (challengeUri As Uri, request As WebRequest, credential As NetworkCredential, authModule As IAuthenticationModule) As Boolean

参数

challengeUri

Uri

将接收该请求的 Uri。

request

WebRequest

表示被请求的资源的 WebRequest。

credential

NetworkCredential

将随请求一起发送的 NetworkCredential（如果此方法返回 true）。

authModule

IAuthenticationModule

将执行身份验证的 IAuthenticationModule（如果要求身份验证）。

返回

Boolean

如果所请求的资源与发出请求的客户端在同一个域中，则为 true；否则为 false。

实现

ShouldSendCredential(Uri, WebRequest, NetworkCredential, IAuthenticationModule)

示例

下面的代码示例演示如何从 派生 IntranetZoneCredentialPolicy ，以允许为使用具有基本身份验证的安全超文本传输协议 (HTTPS) 的请求发送凭据。 使用 HTTPS 和基本身份验证，先加密用户密码，然后再通过网络发送。

// The following class allows credentials to be sent if they are for requests for resources
// in the same domain, or if the request uses the HTTPSscheme and basic authentication is 
// required.
public ref class HttpsBasicCredentialPolicy: public IntranetZoneCredentialPolicy
{
public:
   HttpsBasicCredentialPolicy(){}

   virtual bool ShouldSendCredential( Uri^ challengeUri, WebRequest^ request, NetworkCredential^ credential, IAuthenticationModule^ authModule ) override
   {
      Console::WriteLine( L"Checking custom credential policy for HTTPS and basic." );
      bool answer = IntranetZoneCredentialPolicy::ShouldSendCredential( challengeUri, request, credential, authModule );
      if ( answer == true )
      {
         Console::WriteLine( L"Sending credential for intranet resource." );
         return answer;
      }

      // Determine whether the base implementation returned false for basic and HTTPS.
      if ( request->RequestUri->Scheme == Uri::UriSchemeHttps && authModule->AuthenticationType->Equals( L"Basic" ) )
      {
         Console::WriteLine( L"Sending credential for HTTPS and basic." );
         return true;
      }

      return false;
   }
};

// The following class allows credentials to be sent if they are for requests for resources
// in the same domain, or if the request uses the HTTPSscheme and basic authentication is
// required.

       public class HttpsBasicCredentialPolicy: IntranetZoneCredentialPolicy
    {
        public HttpsBasicCredentialPolicy()
        {
        }

        public override bool ShouldSendCredential(Uri challengeUri,
            WebRequest request,
            NetworkCredential credential,
            IAuthenticationModule authModule)
        {
            Console.WriteLine("Checking custom credential policy for HTTPS and basic.");
            bool answer = base.ShouldSendCredential(challengeUri, request, credential, authModule);

            if (answer == true)
            {
                Console.WriteLine("Sending credential for intranet resource.");
                return answer;
            }
            // Determine whether the base implementation returned false for basic and HTTPS.
            if (request.RequestUri.Scheme == Uri.UriSchemeHttps &&
                authModule.AuthenticationType == "Basic")
            {
                Console.WriteLine("Sending credential for HTTPS and basic.");
                return true;
            }
            return false;
        }
    }

注解

应用程序不直接调用此方法;它由 IAuthenticationModule 负责对服务器执行身份验证的 调用。 如果此方法返回 false， IAuthenticationModule 则 不会向服务器对客户端进行身份验证。

仅对指定凭据或使用 WebProxy 指定凭据的对象的请求调用此方法。