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)

ソース:: SslStream.cs

ソース:: SslStream.cs

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

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: 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 指定する値は、サーバーの証明書の名前と一致する必要があります。

非同期プログラミングモデルの使用の詳細については、「非同期的に同期メソッドを呼び出す」を参照してください。

注意

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

適用対象

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

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: 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 指定する値は、サーバーの証明書の名前と一致する必要があります。

非同期プログラミングモデルの使用の詳細については、「非同期的に同期メソッドを呼び出す」を参照してください。

注意

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

適用対象

次の方法で共有

SslStream.BeginAuthenticateAsClient メソッド

定義

オーバーロード

注釈

BeginAuthenticateAsClient(String, AsyncCallback, Object)

パラメーター

戻り値

例外

注釈

適用対象

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

パラメーター

戻り値

例外

注釈

適用対象

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

パラメーター

戻り値

例外

注釈

適用対象

その他のリソース