Lenguaje

IntranetZoneCredentialPolicy.ShouldSendCredential Método

Definición

Espacio de nombres:
Microsoft.Win32
Ensamblado:
System.dll

Devuelve un Boolean valor de tipo que indica si las credenciales del cliente se envían con una solicitud de un recurso que se realizó mediante 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

Parámetros

challengeUri
Uri

que Uri recibirá la solicitud.

request
WebRequest

WebRequest que representa el recurso que se solicita.

credential
NetworkCredential

que NetworkCredential se enviará con la solicitud si este método devuelve true.

authModule
IAuthenticationModule

que IAuthenticationModule llevará a cabo la autenticación, si se requiere autenticación.

Devoluciones

Boolean

true si el recurso solicitado está en el mismo dominio que el cliente que realiza la solicitud; de lo contrario, false.

Implementaciones

ShouldSendCredential(Uri, WebRequest, NetworkCredential, IAuthenticationModule)

Ejemplos

En el ejemplo de código siguiente se muestra cómo derivar de IntranetZoneCredentialPolicy para permitir que se envíen credenciales para las solicitudes que usan el Protocolo seguro de transferencia de hipertexto (HTTPS) con autenticación básica. Con la autenticación HTTPS y básica, la contraseña de usuario se cifra antes de enviarse a través de la red.

// 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 )
      {
         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 )
            {
                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;
        }
    }

Comentarios

Las aplicaciones no llaman directamente a este método; lo llama el IAuthenticationModule que es responsable de realizar la autenticación con el servidor. Si este método devuelve false, el IAuthenticationModule no autenticará al cliente en el servidor.

Este método solo se llama a para las solicitudes que especifican credenciales o usan un WebProxy objeto que especifica las credenciales.

Se aplica a