HttpListenerRequest.ClientCertificateError Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.HttpListener.dll

Źródło:

HttpListenerRequest.cs

Pobiera kod błędu, który identyfikuje problem z X509Certificate podanym przez klienta.

public:
 property int ClientCertificateError { int get(); };

public int ClientCertificateError { get; }

member this.ClientCertificateError : int

Public ReadOnly Property ClientCertificateError As Integer

Wartość właściwości

Int32

Wartość zawierająca Int32 kod błędu systemu Windows.

Wyjątki

InvalidOperationException

Certyfikat klienta nie został jeszcze zainicjowany przez wywołanie BeginGetClientCertificate(AsyncCallback, Object) metody lub GetClientCertificate()

-Lub-

Operacja jest nadal w toku.

Przykłady

Poniższy przykład kodu sprawdza tę właściwość, aby określić, czy żądanie zawiera prawidłowy certyfikat klienta.

Console.WriteLine("Listening for {0} prefixes...", listener.Prefixes.Count);
HttpListenerContext context = listener.GetContext();
HttpListenerRequest request = context.Request;
Console.WriteLine("Received a request.");
// This server requires a valid client certificate
// for requests that are not sent from the local computer.

// Did the client omit the certificate or send an invalid certificate?
if (request.IsAuthenticated &&
    request.GetClientCertificate() == null ||
    request.ClientCertificateError != 0)
{
    // Send a 403 response.
    HttpListenerResponse badCertificateResponse = context.Response ;
    SendBadCertificateResponse(badCertificateResponse);
    Console.WriteLine("Client has invalid certificate.");
    continue;
}

Console.WriteLine("Listening for {0} prefixes...", listener.Prefixes.Count)
Dim context As HttpListenerContext = listener.GetContext()
Dim request As HttpListenerRequest = context.Request
Console.WriteLine("Received a request.")
' This server requires a valid client certificate
' for requests that are not sent from the local computer.

' Did the client omit the certificate or send an invalid certificate?
If request.IsAuthenticated AndAlso request.GetClientCertificate() Is Nothing OrElse request.ClientCertificateError <> 0 Then
    ' Send a 403 response.
    Dim badCertificateResponse As HttpListenerResponse = context.Response
    SendBadCertificateResponse(badCertificateResponse)
    Console.WriteLine("Client has invalid certificate.")
    Continue Do
End If

Uwagi

Ta właściwość zawiera kod błędu systemu Windows zwrócony przez interfejs dostawcy obsługi zabezpieczeń bezpiecznego kanału (SSPI), który jest używany do sprawdzania poprawności certyfikatu. Aby uzyskać więcej informacji na temat obsługi interfejsu SSPI dla protokołu Schannel, zobacz Tworzenie bezpiecznego połączenia przy użyciu protokołu Schannel.

Zobacz też

• HttpListener
• HttpListenerContext
• HttpListenerResponse