SslStream.AuthenticateAsClientAsync 메서드

정의

네임스페이스:

System.Net.Security

어셈블리:

System.Net.Security.dll

클라이언트-서버 연결의 클라이언트측을 비동기 작업으로 인증합니다.

오버로드

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)	클라이언트-서버 연결에서 비동기 작업으로 서버 및 필요에 따라 클라이언트를 인증하기 위해 클라이언트에서 호출됩니다. 인증 프로세스에는 지정된 인증서 컬렉션과 SSL 프로토콜이 사용됩니다.
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)	클라이언트-서버 연결에서 비동기 작업으로 서버 및 필요에 따라 클라이언트를 인증하기 위해 클라이언트에서 호출됩니다. 인증 프로세스에서는 지정된 인증서 컬렉션과 시스템 기본 SSL 프로토콜을 사용합니다.
AuthenticateAsClientAsync(String)	클라이언트-서버 연결에서 비동기 작업으로 서버 및 필요에 따라 클라이언트를 인증하기 위해 클라이언트에서 호출됩니다.
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)	클라이언트-서버 연결에서 비동기 작업으로 서버 및 필요에 따라 클라이언트를 인증하기 위해 클라이언트에서 호출됩니다. 인증 프로세스는 sslClientAuthenticationOptions 속성 모음에 지정된 정보를 사용합니다.

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Source:

SslStream.cs

클라이언트-서버 연결에서 비동기 작업으로 서버 및 필요에 따라 클라이언트를 인증하기 위해 클라이언트에서 호출됩니다. 인증 프로세스에는 지정된 인증서 컬렉션과 SSL 프로토콜이 사용됩니다.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

매개 변수

targetHost

String

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

clientCertificates

X509CertificateCollection

클라이언트 자격 증명이 들어 있는 X509CertificateCollection입니다.

enabledSslProtocols

SslProtocols

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

checkCertificateRevocation

Boolean

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

반환

Task

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

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 레지스트리를 편집하여 강력한 암호화를 비활성화한 경우 제외).

인증에 성공하면 및 IsSigned 속성을 검사 IsEncrypted 에서 사용되는 SslStream보안 서비스를 결정해야 합니다. IsMutuallyAuthenticated 속성을 확인하여 상호 인증이 발생했는지 여부를 확인합니다.

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

참고

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

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)된 예외를 참조하세요.

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Source:

SslStream.cs

클라이언트-서버 연결에서 비동기 작업으로 서버 및 필요에 따라 클라이언트를 인증하기 위해 클라이언트에서 호출됩니다. 인증 프로세스에서는 지정된 인증서 컬렉션과 시스템 기본 SSL 프로토콜을 사용합니다.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As Task

매개 변수

targetHost

String

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

clientCertificates

X509CertificateCollection

클라이언트 자격 증명이 들어 있는 X509CertificateCollection입니다.

checkCertificateRevocation

Boolean

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

반환

Task

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

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 레지스트리를 편집하여 강력한 암호화를 비활성화한 경우 제외).

인증에 성공하면 및 IsSigned 속성을 검사 IsEncrypted 에서 사용되는 SslStream보안 서비스를 결정해야 합니다. IsMutuallyAuthenticated 속성을 확인하여 상호 인증이 발생했는지 여부를 확인합니다.

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

참고

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

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw AuthenticateAsClient(String, X509CertificateCollection, Boolean)된 예외를 참조하세요.

AuthenticateAsClientAsync(String)

Source:

SslStream.cs

클라이언트-서버 연결에서 비동기 작업으로 서버 및 필요에 따라 클라이언트를 인증하기 위해 클라이언트에서 호출됩니다.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost);

abstract member AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String) As Task

매개 변수

targetHost

String

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

반환

Task

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

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 지정된 값은 서버 인증서의 이름과 일치해야 합니다.

인증에 성공하면 및 IsSigned 속성을 검사 IsEncrypted 에서 사용되는 SslStream보안 서비스를 결정해야 합니다. IsMutuallyAuthenticated 속성을 확인하여 상호 인증이 발생했는지 여부를 확인합니다.

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

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw AuthenticateAsClient(String)된 예외를 참조하세요.

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Source:

SslStream.cs

클라이언트-서버 연결에서 비동기 작업으로 서버 및 필요에 따라 클라이언트를 인증하기 위해 클라이언트에서 호출됩니다. 인증 프로세스는 sslClientAuthenticationOptions 속성 모음에 지정된 정보를 사용합니다.

public:
 System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);

member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

sslClientAuthenticationOptions

SslClientAuthenticationOptions

SSL 연결의 속성 모음입니다.

cancellationToken

CancellationToken

취소 요청을 모니터링할 토큰입니다.

반환

Task

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

ArgumentNullException

sslClientAuthenticationOptions이(가) null인 경우

AuthenticationException

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

InvalidOperationException

인증이 이미 발생한 경우

또는

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

또는

인증이 이미 진행 중인 경우

ObjectDisposedException

이 개체가 닫힌 경우.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

인증이 성공하면 및 IsSigned 속성을 검사 IsEncrypted 에서 사용되는 SslStream보안 서비스를 결정해야 합니다. IsMutuallyAuthenticated 속성을 확인하여 상호 인증이 발생했는지 여부를 확인합니다.

인증에 실패하면 가 수신 AuthenticationException되며 SslStream 더 이상 사용할 수 없습니다. 가비지 수집기에서 수집할 수 있도록 이 개체를 닫고 모든 참조를 제거해야 합니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw AuthenticateAsClient(SslClientAuthenticationOptions)된 예외를 참조하세요.