WinHttpHandler.ServerCertificateValidationCallback Propriedade

Definição

Espaço de Nomes:
System.Net.Http
Assemblagem:
System.Net.Http.WinHttpHandler.dll
Pacote:
System.Net.Http.WinHttpHandler v11.0.0-preview.4.26230.115
Origem:
WinHttpHandler.cs
Origem:
WinHttpHandler.cs
Origem:
WinHttpHandler.cs
Origem:
WinHttpHandler.cs

Recebe ou define um método de callback para validar o certificado do servidor. Este callback faz parte do handshake SSL.

public:
 property Func<System::Net::Http::HttpRequestMessage ^, System::Security::Cryptography::X509Certificates::X509Certificate2 ^, System::Security::Cryptography::X509Certificates::X509Chain ^, System::Net::Security::SslPolicyErrors, bool> ^ ServerCertificateValidationCallback { Func<System::Net::Http::HttpRequestMessage ^, System::Security::Cryptography::X509Certificates::X509Certificate2 ^, System::Security::Cryptography::X509Certificates::X509Chain ^, System::Net::Security::SslPolicyErrors, bool> ^ get(); void set(Func<System::Net::Http::HttpRequestMessage ^, System::Security::Cryptography::X509Certificates::X509Certificate2 ^, System::Security::Cryptography::X509Certificates::X509Chain ^, System::Net::Security::SslPolicyErrors, bool> ^ value); };
public Func<System.Net.Http.HttpRequestMessage,System.Security.Cryptography.X509Certificates.X509Certificate2,System.Security.Cryptography.X509Certificates.X509Chain,System.Net.Security.SslPolicyErrors,bool>? ServerCertificateValidationCallback { get; set; }
public Func<System.Net.Http.HttpRequestMessage,System.Security.Cryptography.X509Certificates.X509Certificate2,System.Security.Cryptography.X509Certificates.X509Chain,System.Net.Security.SslPolicyErrors,bool> ServerCertificateValidationCallback { get; set; }
member this.ServerCertificateValidationCallback : Func<System.Net.Http.HttpRequestMessage, System.Security.Cryptography.X509Certificates.X509Certificate2, System.Security.Cryptography.X509Certificates.X509Chain, System.Net.Security.SslPolicyErrors, bool> with get, set
Public Property ServerCertificateValidationCallback As Func(Of HttpRequestMessage, X509Certificate2, X509Chain, SslPolicyErrors, Boolean)

Valor de Propriedade

Func<HttpRequestMessage,X509Certificate2,X509Chain,SslPolicyErrors,Boolean>

O callback deve ser retornado true se o certificado do servidor for considerado válido e o pedido deve ser enviado. Caso contrário, retorna false.

Exemplos

O exemplo de código seguinte implementa o callback. Se houver erros de validação, este método devolve, false impedindo a comunicação com o servidor não autenticado. Caso contrário, permite validação adicional e retorno true se o certificado for válido.

var handler = new WinHttpHandler();
handler.ServerCertificateValidationCallback = (httpRequestMessage, certificate, chain, sslPolicyErrors) =>
{
    if (sslPolicyErrors == SslPolicyErrors.None)
    {
        // TODO: Implement additional custom certificate validation logic here.
        return true;
    }
    // Do not allow this client to communicate with unauthenticated servers.
    return false;
};

Observações

O valor predefinido é null. Se esta propriedade for null, o certificado do servidor é validado usando autoridades certificadoras padrão e bem conhecidas.

O argumento sslPolicyErrors do delegado contém quaisquer erros de certificado devolvidos pelo SSPI durante a autenticação do servidor. O Boolean valor devolvido por este delegado determina se a autenticação pode ter sucesso.

Aplica-se a