SslStream.AuthenticateAsServerAsync メソッド

定義

名前空間:

System.Net.Security

アセンブリ:

System.Net.Security.dll

サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。

オーバーロード

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)	指定された証明書、要件、およびセキュリティ プロトコルを使用して、サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、非同期操作としてサーバーによって呼び出されます。
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)	指定された証明書、要件、およびセキュリティ プロトコルを使用して、サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、非同期操作としてサーバーによって呼び出されます。
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)	サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。 認証プロセスでは、sslClientAuthenticationOptions プロパティ バッグで指定されている情報が使用されます。
AuthenticateAsServerAsync(X509Certificate)	サーバーによって呼び出され、指定した証明書を使用して、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)	サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。 認証プロセスでは、optionsCallback によって返される情報が使用されます。

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

ソース:

SslStream.cs

指定された証明書、要件、およびセキュリティ プロトコルを使用して、サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、非同期操作としてサーバーによって呼び出されます。

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

パラメーター

serverCertificate

X509Certificate

サーバーの認証に使用される X509Certificate。

clientCertificateRequired

Boolean

認証用の証明書をクライアントに要求するかどうかを指定する Boolean 値。 これは単なる要求であり、証明書が提供されなくても、サーバーは接続要求を受け入れることに注意してください。

enabledSslProtocols

SslProtocols

認証に使用されるプロトコルを表す SslProtocols 値。

checkCertificateRevocation

Boolean

認証時に証明書失効リストをオンにするかどうかを指定する Boolean 値。

戻り値

Task

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

例外

ArgumentNullException

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

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

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

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

ソース:

SslStream.cs

指定された証明書、要件、およびセキュリティ プロトコルを使用して、サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、非同期操作としてサーバーによって呼び出されます。

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As Task

パラメーター

serverCertificate

X509Certificate

サーバーの認証に使用される X509Certificate。

clientCertificateRequired

Boolean

認証用の証明書をクライアントに要求するかどうかを指定する Boolean 値。 これは単なる要求であり、証明書が提供されなくても、サーバーは接続要求を受け入れることに注意してください。

checkCertificateRevocation

Boolean

認証時に証明書失効リストをオンにするかどうかを指定する Boolean 値。

戻り値

Task

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

例外

ArgumentNullException

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

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

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

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

ソース:

SslStream.cs

サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。 認証プロセスでは、sslClientAuthenticationOptions プロパティ バッグで指定されている情報が使用されます。

public:
 System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);

member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

パラメーター

sslServerAuthenticationOptions

SslServerAuthenticationOptions

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

cancellationToken

CancellationToken

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

戻り値

Task

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

例外

ArgumentNullException

ServerCertificateSelectionCallback、ServerCertificate、または ServerCertificateContext が null であり、LocalCertificateSelectionCallback が SslStream コンストラクターで設定されていません。

ArgumentNullException

sslServerAuthenticationOptions が nullです。

AuthenticationException

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

InvalidOperationException

認証が既に発生しました。

または

この SslStream を使用するクライアントの認証は以前に試行されました。

または

認証が既に実行中です。

ObjectDisposedException

このオブジェクトは閉じられました。

OperationCanceledException

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

注釈

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

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

AuthenticateAsServerAsync(X509Certificate)

ソース:

SslStream.cs

サーバーによって呼び出され、指定した証明書を使用して、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);

public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);

abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As Task

パラメーター

serverCertificate

X509Certificate

サーバーの認証に使用する証明書。

戻り値

Task

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

例外

ArgumentNullException

serverCertificate が nullです。

AuthenticationException

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

InvalidOperationException

認証が既に発生しました。

または

この SslStream を使用するクライアントの認証は以前に試行されました。

または

認証が既に実行中です。

ObjectDisposedException

このオブジェクトは閉じられました。

PlatformNotSupportedException

Windows 95、Windows 98、および Windows ME (Millennium Edition) では、AuthenticateAsServerAsync メソッドはサポートされていません。

注釈

.NET Framework 4.7 より、この方法では None を使用して認証を行うため、オペレーティング システムが使用する最適なプロトコルを選択し、セキュリティで保護されていないプロトコルをブロックできるようになります。 .NET Framework 4.6 (および最新のセキュリティ パッチがインストールされている .NET Framework 4.5) で許可されている TLS /SSL プロトコルのバージョンは 1.2、1.1 および 1.0 です (ただし、Windows のレジストリを編集して強力な暗号化を無効にしていない場合に限ります)。

このメソッドは、 を使用して Default認証します。 認証中に証明書失効リストがチェックされません。 クライアントは、認証用の証明書を提供する必要はありません。

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

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

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

ソース:

SslStream.cs

サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。 認証プロセスでは、optionsCallback によって返される情報が使用されます。

public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.ServerOptionsSelectionCallback optionsCallback, object? state, System.Threading.CancellationToken cancellationToken = default);

member this.AuthenticateAsServerAsync : System.Net.Security.ServerOptionsSelectionCallback * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As Task

パラメーター

optionsCallback

ServerOptionsSelectionCallback

コールバック デリゲート。

state

Object

コールバックが呼び出されたときに optionsCallback に渡す状態オブジェクト。

cancellationToken

CancellationToken

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

戻り値

Task

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

例外

ArgumentNullException

ServerCertificateSelectionCallback、ServerCertificate、または ServerCertificateContext が null であり、LocalCertificateSelectionCallback が SslStream コンストラクターで設定されていません。

AuthenticationException

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

InvalidOperationException

認証が既に発生しました。

または

この SslStream を使用するクライアントの認証は以前に試行されました。

または

認証が既に実行中です。

ObjectDisposedException

このオブジェクトは閉じられました。

OperationCanceledException

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

注釈

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