WinHttpHandler.ServerCertificateValidationCallback Egenskap

Definition

Hämtar eller anger en återanropsmetod för att verifiera servercertifikatet. Det här återanropet är en del av SSL-handskakningen.

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)

Egenskapsvärde

Återanropet ska returneras true om servercertifikatet anses vara giltigt och begäran ska skickas. Annars returnerar false.

Exempel

I följande kodexempel implementeras återanropet. Om det finns valideringsfel returnerar false den här metoden att förhindra kommunikation med den oautentiserade servern. Annars kan ytterligare validering och returneras true om certifikatet är giltigt.

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

Kommentarer

Standardvärdet är null. Om den här egenskapen är nullverifieras servercertifikatet med hjälp av välkända standardcertifikatutfärdare.

Ombudets sslPolicyErrors argument innehåller eventuella certifikatfel som returneras av SSPI när servern autentiseras. Värdet Boolean som returneras av det här ombudet avgör om autentiseringen tillåts lyckas.

Gäller för