SslStream.AuthenticateAsServerAsync メソッド

リファレンス

定義

名前空間:: System.Net.Security

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

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

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

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

オーバーロード

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

ソース:: SslStream.cs

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

ソース:: SslStream.cs

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

checkCertificateRevocation: Boolean

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

戻り値

Task

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

例外

ArgumentNullException

serverCertificate が nullです。

AuthenticationException

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

InvalidOperationException

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

または

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

または

認証が既に実行中です。

ObjectDisposedException

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

注釈

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

適用対象

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

ソース:: SslStream.cs

ソース:: SslStream.cs

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

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

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

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

パラメーター

sslServerAuthenticationOptions: SslServerAuthenticationOptions

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

cancellationToken: CancellationToken

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

戻り値

Task

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

例外

ArgumentNullException

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

ArgumentNullException

sslServerAuthenticationOptions が nullです。

AuthenticationException

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

InvalidOperationException

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

または

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

または

認証が既に実行中です。

ObjectDisposedException

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

OperationCanceledException

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

注釈

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

適用対象

AuthenticateAsServerAsync(X509Certificate)

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: 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 メソッドはサポートされていません。

注釈

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

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

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

適用対象

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

ソース:: SslStream.cs

ソース:: SslStream.cs

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

AuthenticationException

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

InvalidOperationException

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

または

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

または

認証が既に実行中です。

ObjectDisposedException

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

OperationCanceledException

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

注釈

適用対象

次の方法で共有

SslStream.AuthenticateAsServerAsync メソッド

定義

オーバーロード

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

パラメーター

戻り値

例外

注釈

適用対象

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

パラメーター

戻り値

例外

注釈

適用対象

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

パラメーター

戻り値

例外

注釈

適用対象

AuthenticateAsServerAsync(X509Certificate)

パラメーター

戻り値

例外

注釈

適用対象

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

パラメーター

戻り値

例外

注釈

適用対象

その他のリソース