SslStream.AuthenticateAsClientAsync メソッド

定義

名前空間:: System.Net.Security

アセンブリ:: netstandard.dll, System.Net.Security.dll

アセンブリ:: System.Net.Security.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

クライアントとサーバーの接続のクライアント側を非同期操作として認証します。

オーバーロード

名前	説明
AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)	サーバーを認証するためにクライアントによって呼び出され、必要に応じてクライアントとサーバーの接続内のクライアントが非同期操作として呼び出されます。認証プロセスでは、指定された証明書コレクションと SSL プロトコルが使用されます。
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)	サーバーを認証するためにクライアントによって呼び出され、必要に応じてクライアントとサーバーの接続内のクライアントが非同期操作として呼び出されます。認証プロセスでは、指定された証明書コレクションとシステムの既定の SSL プロトコルが使用されます。
AuthenticateAsClientAsync(String)	サーバーを認証するためにクライアントによって呼び出され、必要に応じてクライアントとサーバーの接続内のクライアントが非同期操作として呼び出されます。
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)	サーバーを認証するためにクライアントによって呼び出され、必要に応じてクライアントとサーバーの接続内のクライアントが非同期操作として呼び出されます。認証プロセスでは、 `sslClientAuthenticationOptions` プロパティバッグで指定された情報が使用されます。

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: 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);

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

非同期操作を表すタスクオブジェクト。

例外

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 レジストリを編集して強力な暗号化を無効にしない限り)。

認証が成功したら、 IsEncrypted プロパティと IsSigned プロパティを確認して、 SslStreamで使用されるセキュリティサービスを決定する必要があります。 IsMutuallyAuthenticatedプロパティを調べて、相互認証が行われたかどうかを確認します。

認証に失敗した場合は、 AuthenticationExceptionを受け取り、この SslStream は使用できなくなります。ガベージコレクターが収集できるように、このオブジェクトを閉じて、そのオブジェクトへの参照をすべて削除する必要があります。

Note

クライアント証明書は、SSL バージョン 2 プロトコルではサポートされていません。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)によってスローされる例外を参照してください。

適用対象

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: 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);

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

非同期操作を表すタスクオブジェクト。

例外

AuthenticationException

認証に失敗し、このオブジェクトは使用できない状態のままです。

InvalidOperationException

認証は既に行われました。

-又は-

この SslStream を使用したサーバー認証は、以前に試行されました。

-又は-

認証は既に進行中です。

ObjectDisposedException

このオブジェクトは閉じられています。

注釈

Note

クライアント証明書は、SSL バージョン 2 プロトコルではサポートされていません。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 AuthenticateAsClient(String, X509CertificateCollection, Boolean)によってスローされる例外を参照してください。

適用対象

AuthenticateAsClientAsync(String)

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: 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

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

targetHost は nullです。

AuthenticationException

認証に失敗し、このオブジェクトは使用できない状態のままです。

InvalidOperationException

認証は既に行われました。

-又は-

この SslStream を使用したサーバー認証は、以前に試行されました。

-又は-

認証は既に進行中です。

ObjectDisposedException

このオブジェクトは閉じられています。

注釈

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 AuthenticateAsClient(String)によってスローされる例外を参照してください。

適用対象

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: 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);

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

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

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

パラメーター

sslClientAuthenticationOptions: SslClientAuthenticationOptions

SSL 接続のプロパティバッグ。

cancellationToken: CancellationToken

キャンセル要求を監視するトークン。

返品

Task

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

sslClientAuthenticationOptions は nullです。

AuthenticationException

認証に失敗し、このオブジェクトは使用できない状態のままです。

InvalidOperationException

認証は既に行われました。

-又は-

この SslStream を使用したサーバー認証は、以前に試行されました。

-又は-

認証は既に進行中です。

ObjectDisposedException

このオブジェクトは閉じられています。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

注釈

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 AuthenticateAsClient(SslClientAuthenticationOptions)によってスローされる例外を参照してください。

適用対象

フィードバック

このページはお役に立ちましたか?