HttpListenerRequest.ClientCertificateError 속성

정의

네임스페이스:

System.Net

어셈블리:

System.Net.HttpListener.dll

Source:

HttpListenerRequest.cs

클라이언트에서 제공한 X509Certificate와 관련된 문제를 식별하는 오류 코드를 가져옵니다.

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

public int ClientCertificateError { get; }

member this.ClientCertificateError : int

Public ReadOnly Property ClientCertificateError As Integer

속성 값

Int32

Windows 오류 코드가 들어 있는 Int32 값입니다.

예외

InvalidOperationException

BeginGetClientCertificate(AsyncCallback, Object) 또는 GetClientCertificate() 메서드에 대한 호출에 의해 아직 클라이언트 인증서가 초기화되지 않았습니다.

또는

작업이 아직 진행 중입니다.

예제

다음 코드 예제에서는 요청에 유효한 클라이언트 인증서를 포함 하는지 여부를 확인 하려면이 속성을 확인 합니다.

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

설명

이 속성에는 인증서의 유효성을 검사하는 데 사용되는 보안 채널(Schannel) SSPI(보안 지원 공급자 인터페이스)에서 반환된 Windows 오류 코드가 포함되어 있습니다. Schannel에 대한 SSPI 지원에 대한 자세한 내용은 Schannel을 사용하여 보안 연결 만들기를 참조하세요.

추가 정보

• HttpListener
• HttpListenerContext
• HttpListenerResponse