SslStream.AuthenticateAsServerAsync メソッド

定義

名前空間:: System.Net.Security

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

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

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

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

サーバーを認証するためにサーバーによって呼び出され、必要に応じてクライアントとサーバーの接続で非同期操作としてクライアントが呼び出されます。

オーバーロード

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

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

ソース:: SslStream.cs

ソース:: SslStream.cs

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

ソース:: 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(ServerOptionsSelectionCallback, Object, CancellationToken)

ソース:: SslStream.cs

ソース:: SslStream.cs

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

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

AuthenticationException

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

InvalidOperationException

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

-又は-

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

-又は-

認証は既に進行中です。

ObjectDisposedException

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

OperationCanceledException

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

注釈

適用対象

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

ソース:: SslStream.cs

非同期操作として、サーバーと必要に応じてクライアントとサーバーの接続でクライアントを認証します。認証プロセスでは、 sslServerAuthenticationOptions プロパティバッグで指定された情報が使用されます。

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

sslServerAuthenticationOptions は nullです。

AuthenticationException

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

InvalidOperationException

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

-又は-

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

-又は-

認証は既に進行中です。

ObjectDisposedException

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

OperationCanceledException

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

注釈

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

適用対象

AuthenticateAsServerAsync(X509Certificate)

ソース:: SslStream.cs

ソース:: SslStream.cs

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

AuthenticateAsServerAsync メソッドは、Windows 95、Windows 98、または Windows Millennium ではサポートされていません。

注釈

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

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

適用対象

フィードバック

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