HttpBaseProtocolFilter.ServerCustomValidationRequested 이벤트

정의

네임스페이스:

Windows.Web.Http.Filters

이 이벤트는 SSL/TLS 연결이 서버와 설정될 때 발생합니다. 서버 SSL 인증서의 추가 유효성 검사(OS 기본값 외에도)를 수행해야 하는 경우 이 이벤트에 대한 이벤트 처리기를 구현해야 합니다.

// Register
event_token ServerCustomValidationRequested(TypedEventHandler<HttpBaseProtocolFilter, HttpServerCustomValidationRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void ServerCustomValidationRequested(event_token const* cookie) const;

// Revoke with event_revoker
HttpBaseProtocolFilter::ServerCustomValidationRequested_revoker ServerCustomValidationRequested(auto_revoke_t, TypedEventHandler<HttpBaseProtocolFilter, HttpServerCustomValidationRequestedEventArgs const&> const& handler) const;

public event TypedEventHandler<HttpBaseProtocolFilter,HttpServerCustomValidationRequestedEventArgs> ServerCustomValidationRequested;

function onServerCustomValidationRequested(eventArgs) { /* Your code */ }
httpBaseProtocolFilter.addEventListener("servercustomvalidationrequested", onServerCustomValidationRequested);
httpBaseProtocolFilter.removeEventListener("servercustomvalidationrequested", onServerCustomValidationRequested);
- or -
httpBaseProtocolFilter.onservercustomvalidationrequested = onServerCustomValidationRequested;

Public Custom Event ServerCustomValidationRequested As TypedEventHandler(Of HttpBaseProtocolFilter, HttpServerCustomValidationRequestedEventArgs) 

이벤트 유형

TypedEventHandler<HttpBaseProtocolFilter,HttpServerCustomValidationRequestedEventArgs>

Windows 요구 사항

디바이스 패밀리	Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)

설명

서버 인증서의 기본 OS 유효성 검사는 이 이벤트를 발생하기 전에 수행됩니다. 인증서가 이 유효성 검사에 실패하면 연결이 종료되고 이벤트 처리기가 호출되지 않습니다.

OS 유효성 검사의 일부를 건너뛰려면(프로덕션 시나리오에는 권장되지 않음) IgnorableServerCertificateErrors 속성을 사용하여 무시하려는 오류를 지정합니다. 그런 다음 인증서에 다른 오류가 없는 한 OS 유효성 검사가 성공한 것으로 간주되고 이벤트 처리기가 호출됩니다.

이벤트 처리기 코드는 SSL/TLS 연결 설정 중에 OS에서 동기 콜백의 일부로 실행됩니다. 연결 중에 서버의 시간이 초과되지 않도록 이벤트 처리기 코드 내에서 장기 실행 작업을 수행하지 마세요.

이벤트 처리기 코드 내에서 비동기 API를 호출해야 하는 경우 비동기 API를 호출하기 전에 지연( HttpServerCustomValidationArgs.GetDeferral 참조)을 수행해야 합니다. 완료되면 지연을 호출 합니다. 처리기 코드에서 컨트롤을 반환하는 메서드를 완료합니다.

다음 코드 조각은 이 이벤트를 구독하는 방법을 보여 줍니다.

HttpBaseProtocolFilter.ServerCustomValidationRequest += (sender, args) =>
{
	var cert = args.ServerCertificate
	// Your custom cert validation code here.
}