RemoteCertificateValidationCallback Delegált

Definíció

Névtér:

System.Net.Security

Szerelvény:

System.dll

Ellenőrzi a hitelesítéshez használt távoli Secure Sockets Layer (SSL) tanúsítványt.

public delegate bool RemoteCertificateValidationCallback(System::Object ^ sender, X509Certificate ^ certificate, X509Chain ^ chain, SslPolicyErrors sslPolicyErrors);

public delegate bool RemoteCertificateValidationCallback(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors sslPolicyErrors);

type RemoteCertificateValidationCallback = delegate of obj * X509Certificate * X509Chain * SslPolicyErrors -> bool

Public Delegate Function RemoteCertificateValidationCallback(sender As Object, certificate As X509Certificate, chain As X509Chain, sslPolicyErrors As SslPolicyErrors) As Boolean 

Paraméterek

sender

Object

Az ellenőrzés állapotadatait tartalmazó objektum.

certificate

X509Certificate

A távoli fél hitelesítéséhez használt tanúsítvány.

chain

X509Chain

A távoli tanúsítványhoz társított hitelesítésszolgáltatók lánca.

sslPolicyErrors

SslPolicyErrors

A távoli tanúsítványhoz társított egy vagy több hiba.

Visszatérési érték

Boolean

Egy Boolean érték, amely meghatározza, hogy a megadott tanúsítvány elfogadható-e a hitelesítéshez.

Példák

Az alábbi példakód egy metódust implementál, amelyet az RemoteCertificateValidationCallback osztály egy példánya hív meg. Érvényesítési hibák esetén ez a metódus megjeleníti és visszaadja falseőket, ami megakadályozza a hitelesítés nélküli kiszolgálóval való kommunikációt.

// The following method is invoked by the RemoteCertificateValidationDelegate.
public static bool ValidateServerCertificate(
      object sender,
      X509Certificate certificate,
      X509Chain chain,
      SslPolicyErrors sslPolicyErrors)
{
   if (sslPolicyErrors == SslPolicyErrors.None)
        return true;

    Console.WriteLine("Certificate error: {0}", sslPolicyErrors);

    // Do not allow this client to communicate with unauthenticated servers.
    return false;
}

Az alábbi példakód az előző kód példában definiált metódussal hozza létre a delegáltat.

// Create a TCP/IP client socket.
// machineName is the host running the server application.
TcpClient client = new TcpClient(machineName,5000);
Console.WriteLine("Client connected.");
// Create an SSL stream that will close the client's stream.
SslStream sslStream = new SslStream(
    client.GetStream(),
    false,
    new RemoteCertificateValidationCallback (ValidateServerCertificate),
    null
    );
// The server name must match the name on the server certificate.
try
{
    sslStream.AuthenticateAsClient(serverName);
}
catch (AuthenticationException e)
{
    Console.WriteLine("Exception: {0}", e.Message);
    if (e.InnerException != null)
    {
        Console.WriteLine("Inner exception: {0}", e.InnerException.Message);
    }
    Console.WriteLine ("Authentication failed - closing the connection.");
    client.Close();
    return;
}

Megjegyzések

A meghatalmazott argumentuma sslPolicyErrors tartalmazza az SSPI által az ügyfél vagy a kiszolgáló hitelesítése során visszaadott tanúsítványhibákat. A Boolean meghatalmazott által meghívott metódus által visszaadott érték határozza meg, hogy a hitelesítés sikeres legyen-e.

Ezt a meghatalmazottat használja az SslStream osztály.

Bővítő metódusok

Name	Description
GetMethodInfo(Delegate)	Lekéri a megadott meghatalmazott által képviselt metódust képviselő objektumot.

Lásd még

• LocalCertificateSelectionCallback