IntranetZoneCredentialPolicy.ShouldSendCredential Método

Referencia

Definición

Espacio de nombres:: Microsoft.Win32

Ensamblado:: System.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Devuelve un objeto Boolean que indica si las credenciales del cliente se envían con una solicitud de recurso realizada 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

El objeto Uri que recibe la solicitud.

request: WebRequest

El objeto WebRequest que representa el recurso solicitado.

credential: NetworkCredential

El objeto NetworkCredential que debe enviarse con la solicitud si este método devuelve true.

authModule: IAuthenticationModule

El objeto IAuthenticationModule que debe realizar la autenticación, si ésta se requiere.

Devoluciones

Boolean

Es true si el recurso solicitado está en el mismo dominio que el cliente que realiza la solicitud; de lo contrario, es 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 de transferencia de hipertexto seguro (HTTPS) con autenticación básica. Con HTTPS y la autenticación 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 == 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;
        }
    }

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á el cliente en el servidor.

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

Se aplica a

Compartir a través de