WinHttpHandler.ServerCertificateValidationCallback Propiedad

Definición

Espacio de nombres:
System.Net.Http
Ensamblado:
System.Net.Http.WinHttpHandler.dll
Paquete:
System.Net.Http.WinHttpHandler v11.0.0-preview.4.26230.115
Source:
WinHttpHandler.cs
Source:
WinHttpHandler.cs
Source:
WinHttpHandler.cs
Source:
WinHttpHandler.cs

Obtiene o establece un método de devolución de llamada para validar el certificado de servidor. Esta devolución de llamada forma parte del protocolo de enlace 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 propiedad

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

La devolución de llamada debe devolverse true si el certificado de servidor se considera válido y se debe enviar la solicitud. De lo contrario, devuelve false.

Ejemplos

En el ejemplo de código siguiente se implementa la devolución de llamada. Si hay errores de validación, este método devuelve false la prevención de la comunicación con el servidor no autenticado. De lo contrario, permite una validación adicional y devuelve true si el certificado es 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;
};

Comentarios

El valor por defecto es null. Si esta propiedad es null, el certificado de servidor se valida mediante entidades de certificación conocidas estándar.

El argumento del delegado contiene los errores de sslPolicyErrors certificado devueltos por SSPI al autenticar el servidor. El Boolean valor devuelto por este delegado determina si la autenticación puede realizarse correctamente.

Se aplica a