IntranetZoneCredentialPolicy.ShouldSendCredential Método

Definição

Espaço de Nomes:
Microsoft.Win32
Assemblagem:
System.dll

Retorna a Boolean que indica se as credenciais do cliente são enviadas com um pedido para um recurso feito usando 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

O Uri que receberá o pedido.

request
WebRequest

O WebRequest que representa o recurso solicitado.

credential
NetworkCredential

O NetworkCredential que será enviado com o pedido se este método devolver true.

authModule
IAuthenticationModule

O IAuthenticationModule que realizará a autenticação, caso seja necessária a autenticação.

Devoluções

Boolean

true se o recurso solicitado estiver no mesmo domínio do cliente que faz o pedido; caso contrário, false.

Implementações

ShouldSendCredential(Uri, WebRequest, NetworkCredential, IAuthenticationModule)

Exemplos

O exemplo de código seguinte demonstra a derivação de IntranetZoneCredentialPolicy para permitir o envio de credenciais para pedidos que utilizam o Protocolo Seguro de Transferência de Hipertexto (HTTPS) com autenticação básica. Usando HTTPS e autenticação básica, a palavra-passe do utilizador é encriptada antes de ser enviada pela rede.

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

Observações

As aplicações não chamam este método diretamente; é chamada pelo IAuthenticationModule responsável por realizar a autenticação com o servidor. Se este método devolver false, não IAuthenticationModule autenticará o cliente ao servidor.

Este método é chamado apenas para pedidos que especificam credenciais ou utilizam um WebProxy objeto que especifique credenciais.

Aplica-se a