WinHttpHandler.ServerCertificateValidationCallback Propriété

Définition

Espace de noms:
System.Net.Http
Assembly:
System.Net.Http.WinHttpHandler.dll
Paquet:
System.Net.Http.WinHttpHandler v11.0.0-preview.4.26230.115
Source:
WinHttpHandler.cs
Source:
WinHttpHandler.cs
Source:
WinHttpHandler.cs
Source:
WinHttpHandler.cs

Obtient ou définit une méthode de rappel pour valider le certificat de serveur. Ce rappel fait partie de l’établissement d’une liaison 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)

Valeur de propriété

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

Le rappel doit retourner true si le certificat de serveur est considéré comme valide et que la demande doit être envoyée. Sinon, retourne false.

Exemples

L’exemple de code suivant implémente le rappel. S’il existe des erreurs de validation, cette méthode retourne false la prévention de la communication avec le serveur non authentifié. Dans le cas contraire, elle permet une validation et un retour true supplémentaires si le certificat est valide.

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

Remarques

La valeur par défaut est null. Si cette propriété est null, le certificat de serveur est validé à l’aide des autorités de certification connues standard.

L’argument du délégué contient toutes les erreurs de certificat retournées par SSPI lors de sslPolicyErrors l’authentification du serveur. La Boolean valeur retournée par ce délégué détermine si l’authentification est autorisée à réussir.

S’applique à