SslStream.BeginAuthenticateAsClient 메서드

참조

정의

네임스페이스:: System.Net.Security

어셈블리:: System.Net.Security.dll

어셈블리:: System.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

클라이언트-서버 연결의 클라이언트측을 인증하는 작업을 시작합니다.

오버로드

BeginAuthenticateAsClient(String, AsyncCallback, Object)	서버를 인증하고 선택적으로 클라이언트를 인증하는 비동기 작업을 시작하기 위해 클라이언트에서 호출합니다.
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)	지정된 인증서 및 시스템 기본 보안 프로토콜을 사용하여 서버 및 필요에 따라 클라이언트를 인증하는 비동기 작업을 시작하기 위해 클라이언트에서 호출됩니다.
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)	지정된 인증서 및 보안 프로토콜을 사용하여 서버를 인증하고 선택적으로 클라이언트를 인증하는 비동기 작업을 시작하기 위해 클라이언트에서 호출합니다.

설명

인증이 진행되는 동안에는 이 메서드의 오버로드가 차단되지 않습니다. 인증이 완료 될 때까지 기다리는 동안 차단 하려면 방법 중 AuthenticateAsClient 하나를 사용 합니다.

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

서버를 인증하고 선택적으로 클라이언트를 인증하는 비동기 작업을 시작하기 위해 클라이언트에서 호출합니다.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback? asyncCallback, object? asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback asyncCallback, object asyncState);

abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

매개 변수

targetHost: String

이 SslStream을 공유하는 서버의 이름입니다.

asyncCallback: AsyncCallback

인증이 완료되었을 때 호출할 매서드를 참조하는 AsyncCallback 대리자입니다.

asyncState: Object

작업에 대한 정보가 들어 있는 사용자 정의 개체입니다. 작업이 완료되면 asyncCallback 대리자에게 전달되는 개체입니다.

반환

IAsyncResult

비동기 작업의 상태를 나타내는 IAsyncResult 개체입니다.

예외

ArgumentNullException

targetHost이(가) null인 경우

AuthenticationException

인증이 실패했으며 이 개체가 사용할 수 없는 상태로 유지되는 경우

InvalidOperationException

인증이 이미 발생한 경우

또는

이 SslStream을 사용하는 서버 인증이 이전에 시도된 경우

또는

인증이 이미 진행 중인 경우

ObjectDisposedException

이 개체가 닫힌 경우.

설명

.NET Framework 4.7부터 이 메서드는 None을 통해 인증하여 운영 체제가 최상의 프로토콜을 선택하여 사용하고 안전하지 않은 프로토콜을 차단할 수 있도록 합니다. .NET Framework 4.6(및 최신 보안 패치가 설치된 .NET Framework 4.5)에서 허용된 TLS / SSL 프로토콜 버전은 1.2, 1.1 및 1.0입니다(Windows 레지스트리를 편집하여 강력한 암호화를 비활성화한 경우 제외). 인증에는 클라이언트 인증서가 사용되지 않습니다. 인증 중에 인증서 해지 목록을 확인하지 않습니다.

에 targetHost 지정된 값은 서버 인증서의 이름과 일치해야 합니다.

메서드를 호출 EndAuthenticateAsClient 하여 비동기 인증 작업을 완료해야 합니다. 일반적으로 메서드는 대리자에서 호출됩니다 asyncCallback .

이 메서드는 작업이 완료되는 동안 차단되지 않습니다. 작업이 완료될 때까지 차단하려면 메서드 오버로드 중 AuthenticateAsClient 하나를 사용합니다.

비동기 프로그래밍 모델 사용에 대한 자세한 내용은 동기 메서드 비동기 호출을 참조하세요.

를 AuthenticationException SslStream 받으면 더 이상 사용할 수 없습니다. 가비지 수집기에서 수집할 수 있도록 이 개체를 닫고 모든 참조를 제거해야 합니다.

적용 대상

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

지정된 인증서 및 시스템 기본 보안 프로토콜을 사용하여 서버 및 필요에 따라 클라이언트를 인증하는 비동기 작업을 시작하기 위해 클라이언트에서 호출됩니다.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);

abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

매개 변수

targetHost: String

이 SslStream을 공유하는 서버의 이름입니다.

clientCertificates: X509CertificateCollection

클라이언트 인증서를 포함하는 X509CertificateCollection입니다.

checkCertificateRevocation: Boolean

인증 동안 인증서 해지 목록이 확인되는지 여부를 지정하는 Boolean 값입니다.

asyncCallback: AsyncCallback

인증이 완료되었을 때 호출할 메서드를 참조하는 AsyncCallback 대리자입니다.

asyncState: Object

작업에 대한 정보가 들어 있는 사용자 정의 개체입니다. 작업이 완료되면 asyncCallback 대리자에게 전달되는 개체입니다.

반환

IAsyncResult

비동기 작업의 상태를 나타내는 IAsyncResult 개체입니다.

예외

ArgumentNullException

targetHost이(가) null인 경우

AuthenticationException

인증이 실패했으며 이 개체가 사용할 수 없는 상태로 유지되는 경우

InvalidOperationException

인증이 이미 발생한 경우

또는

이 SslStream을 사용하는 서버 인증이 이전에 시도된 경우

또는

인증이 이미 진행 중인 경우

ObjectDisposedException

이 개체가 닫힌 경우.

설명

에 targetHost 지정된 값은 서버 인증서의 이름과 일치해야 합니다.

메서드를 호출 EndAuthenticateAsClient 하여 비동기 인증 작업을 완료해야 합니다. 일반적으로 메서드는 대리자에서 호출됩니다 asyncCallback .

이 메서드는 작업이 완료되는 동안 차단되지 않습니다. 작업이 완료될 때까지 차단하려면 메서드 오버로드 중 AuthenticateAsClient 하나를 사용합니다.

비동기 프로그래밍 모델 사용에 대한 자세한 내용은 동기 메서드 비동기 호출을 참조하세요.

를 AuthenticationException SslStream 받으면 더 이상 사용할 수 없습니다. 가비지 수집기에서 수집할 수 있도록 이 개체를 닫고 모든 참조를 제거해야 합니다.

참고

클라이언트 인증서는 SSL 버전 2 프로토콜에서 지원되지 않습니다.

적용 대상

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

지정된 인증서 및 보안 프로토콜을 사용하여 서버를 인증하고 선택적으로 클라이언트를 인증하는 비동기 작업을 시작하기 위해 클라이언트에서 호출합니다.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);

public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);

abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

매개 변수

targetHost: String

이 SslStream을 공유하는 서버의 이름입니다.

clientCertificates: X509CertificateCollection

클라이언트 인증서를 포함하는 X509CertificateCollection입니다.

enabledSslProtocols: SslProtocols

인증에 사용되는 프로토콜을 나타내는 SslProtocols 값입니다.

checkCertificateRevocation: Boolean

인증 동안 인증서 해지 목록이 확인되는지 여부를 지정하는 Boolean 값입니다.

asyncCallback: AsyncCallback

인증이 완료되었을 때 호출할 메서드를 참조하는 AsyncCallback 대리자입니다.

asyncState: Object

작업에 대한 정보가 들어 있는 사용자 정의 개체입니다. 작업이 완료되면 asyncCallback 대리자에게 전달되는 개체입니다.

반환

IAsyncResult

비동기 작업의 상태를 나타내는 IAsyncResult 개체입니다.

예외

ArgumentNullException

targetHost은 null입니다.

ArgumentException

enabledSslProtocols는 유효한 SslProtocols 값이 아닙니다.

AuthenticationException

인증이 실패했으며 이 개체가 사용할 수 없는 상태로 유지되는 경우

InvalidOperationException

인증이 이미 발생한 경우

또는

이 SslStream을 사용하는 서버 인증이 이전에 시도된 경우

또는

인증이 이미 진행 중인 경우

ObjectDisposedException

이 개체가 닫힌 경우.

설명

에 targetHost 지정된 값은 서버 인증서의 이름과 일치해야 합니다.

메서드를 호출 EndAuthenticateAsClient 하여 비동기 인증 작업을 완료해야 합니다. 일반적으로 메서드는 대리자에서 호출됩니다 asyncCallback .

이 메서드는 작업이 완료되는 동안 차단되지 않습니다. 작업이 완료될 때까지 차단하려면 메서드 오버로드 중 AuthenticateAsClient 하나를 사용합니다.

비동기 프로그래밍 모델 사용에 대한 자세한 내용은 동기 메서드 비동기 호출을 참조하세요.

를 AuthenticationException SslStream 받으면 더 이상 사용할 수 없습니다. 가비지 수집기에서 수집할 수 있도록 이 개체를 닫고 모든 참조를 제거해야 합니다.

참고

클라이언트 인증서는 SSL 버전 2 프로토콜에서 지원되지 않습니다.

적용 대상

다음을 통해 공유

SslStream.BeginAuthenticateAsClient 메서드

정의

오버로드

설명

BeginAuthenticateAsClient(String, AsyncCallback, Object)

매개 변수

반환

예외

설명

적용 대상

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

매개 변수

반환

예외

설명

적용 대상

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

매개 변수

반환

예외

설명

적용 대상

추가 리소스