IntranetZoneCredentialPolicy.ShouldSendCredential Método

Referência

Definição

Namespace:: Microsoft.Win32

Assembly:: System.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.

Aplica-se a

Partilhar via