IntranetZoneCredentialPolicy.ShouldSendCredential Método

Definição

Namespace:

Microsoft.Win32

Assembly:

System.dll

Retorna um Boolean que indica se as credenciais do cliente são enviadas com uma solicitação de recurso que foi feita 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á a solicitação.

request

WebRequest

O WebRequest que representa o recurso sendo solicitado.

credential

NetworkCredential

O NetworkCredential que será enviado com a solicitação se esse método retornar true.

authModule

IAuthenticationModule

O IAuthenticationModule que fará a autenticação, se a autenticação for necessária.

Retornos

Boolean

true se o recurso solicitado está no mesmo domínio que o cliente que faz a solicitação; caso contrário, false.

Implementações

ShouldSendCredential(Uri, WebRequest, NetworkCredential, IAuthenticationModule)

Exemplos

O exemplo de código a seguir demonstra derivar de IntranetZoneCredentialPolicy para permitir que as credenciais sejam enviadas para solicitações que usam HTTPS (Secure Hypertext Transfer Protocol) com autenticação básica. Usando HTTPS e autenticação básica, a senha do usuário é criptografada 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 == 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;
        }
    }

Comentários

Os aplicativos não chamam esse método diretamente; ele é chamado pelo IAuthenticationModule que é responsável por executar a autenticação com o servidor. Se esse método retornar false, o IAuthenticationModule não autenticará o cliente no servidor.

Esse método é chamado apenas para solicitações que especificam credenciais ou usam um WebProxy objeto que especifica credenciais.