SslStream.AuthenticateAsServerAsync メソッド

定義

サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。Called by servers to authenticate the server and optionally the client in a client-server connection as an asynchronous operation.

オーバーロード

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

指定された証明書、要件、およびセキュリティ プロトコルを使用して、サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、非同期操作としてサーバーによって呼び出されます。Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificates, requirements and security protocol as an asynchronous operation.

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

指定された証明書、要件、およびセキュリティ プロトコルを使用して、サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、非同期操作としてサーバーによって呼び出されます。Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificates, requirements and security protocol as an asynchronous operation.

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。Called by servers to authenticate the server and optionally the client in a client-server connection as an asynchronous operation. 認証プロセスでは、sslClientAuthenticationOptions プロパティ バッグで指定されている情報が使用されます。The authentication process uses information specified in the sslClientAuthenticationOptions property bag.

AuthenticateAsServerAsync(X509Certificate)

サーバーによって呼び出され、指定した証明書を使用して、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificate as an asynchronous operation.

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。Called by servers to authenticate the server and optionally the client in a client-server connection as an asynchronous operation. 認証プロセスでは、optionsCallback によって返される情報が使用されます。The authentication process uses information returned by optionsCallback.

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

指定された証明書、要件、およびセキュリティ プロトコルを使用して、サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、非同期操作としてサーバーによって呼び出されます。Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificates, requirements and security protocol as an asynchronous operation.

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。The X509Certificate used to authenticate the server.

clientCertificateRequired
Boolean

認証用の証明書をクライアントに要求するかどうかを指定する Boolean 値。A Boolean value that specifies whether the client is asked for a certificate for authentication. これは単なる要求であり、証明書が提供されなくても、サーバーは接続要求を受け入れることに注意してください。Note that this is only a request -- if no certificate is provided, the server still accepts the connection request.

enabledSslProtocols
SslProtocols

認証に使用されるプロトコルを表す SslProtocols 値。The SslProtocols value that represents protocols used for authentication.

checkCertificateRevocation
Boolean

認証時に証明書失効リストをオンにするかどうかを指定する Boolean 値。A Boolean value that specifies whether the certificate revocation list is checked during authentication.

戻り値

Task

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation.

例外

serverCertificatenullです。serverCertificate is null.

認証に失敗し、このオブジェクトが使用できない状態のままになっています。The authentication failed and left this object in an unusable state.

認証が既に発生しました。Authentication has already occurred.

または-or- この SslStream を使用するクライアントの認証は以前に試行されました。Client authentication using this SslStream was tried previously.

または-or- 認証が既に実行中です。Authentication is already in progress.

このオブジェクトは閉じられました。This object has been closed.

注釈

.NET Framework 4.7 より、この方法では None を使用して認証を行うため、オペレーティング システムが使用する最適なプロトコルを選択し、セキュリティで保護されていないプロトコルをブロックできるようになります。Starting with .NET Framework 4.7, this method authenticates using None, which allows the operating system to choose the best protocol to use, and to block protocols that are not secure. .NET Framework 4.6 (および最新のセキュリティ パッチがインストールされている .NET Framework 4.5) で許可されている TLS /SSL プロトコルのバージョンは 1.2、1.1 および 1.0 です (ただし、Windows のレジストリを編集して強力な暗号化を無効にしていない場合に限ります)。In .NET Framework 4.6 (and .NET Framework 4.5 with the latest security patches installed), the allowed TLS/SSL protocols versions are 1.2, 1.1, and 1.0 (unless you disable strong cryptography by editing the Windows Registry).

認証に失敗すると、が表示され、 AuthenticationException これは使用でき SslStream なくなります。If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. このオブジェクトを閉じて、ガベージコレクターによって収集されるように、このオブジェクトへのすべての参照を削除する必要があります。You should close this object and remove all references to it so that it can be collected by the garbage collector.

適用対象

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

指定された証明書、要件、およびセキュリティ プロトコルを使用して、サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、非同期操作としてサーバーによって呼び出されます。Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificates, requirements and security protocol as an asynchronous operation.

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。The X509Certificate used to authenticate the server.

clientCertificateRequired
Boolean

認証用の証明書をクライアントに要求するかどうかを指定する Boolean 値。A Boolean value that specifies whether the client is asked for a certificate for authentication. これは単なる要求であり、証明書が提供されなくても、サーバーは接続要求を受け入れることに注意してください。Note that this is only a request -- if no certificate is provided, the server still accepts the connection request.

checkCertificateRevocation
Boolean

認証時に証明書失効リストをオンにするかどうかを指定する Boolean 値。A Boolean value that specifies whether the certificate revocation list is checked during authentication.

戻り値

Task

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation.

例外

serverCertificatenullです。serverCertificate is null.

認証に失敗し、このオブジェクトが使用できない状態のままになっています。The authentication failed and left this object in an unusable state.

認証が既に発生しました。Authentication has already occurred.

または-or- この SslStream を使用するクライアントの認証は以前に試行されました。Client authentication using this SslStream was tried previously.

または-or- 認証が既に実行中です。Authentication is already in progress.

このオブジェクトは閉じられました。This object has been closed.

注釈

.NET Framework 4.7 より、この方法では None を使用して認証を行うため、オペレーティング システムが使用する最適なプロトコルを選択し、セキュリティで保護されていないプロトコルをブロックできるようになります。Starting with .NET Framework 4.7, this method authenticates using None, which allows the operating system to choose the best protocol to use, and to block protocols that are not secure. .NET Framework 4.6 (および最新のセキュリティ パッチがインストールされている .NET Framework 4.5) で許可されている TLS /SSL プロトコルのバージョンは 1.2、1.1 および 1.0 です (ただし、Windows のレジストリを編集して強力な暗号化を無効にしていない場合に限ります)。In .NET Framework 4.6 (and .NET Framework 4.5 with the latest security patches installed), the allowed TLS/SSL protocols versions are 1.2, 1.1, and 1.0 (unless you disable strong cryptography by editing the Windows Registry).

認証に失敗すると、が表示され、 AuthenticationException これは使用でき SslStream なくなります。If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. このオブジェクトを閉じて、ガベージコレクターによって収集されるように、このオブジェクトへのすべての参照を削除する必要があります。You should close this object and remove all references to it so that it can be collected by the garbage collector.

適用対象

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。Called by servers to authenticate the server and optionally the client in a client-server connection as an asynchronous operation. 認証プロセスでは、sslClientAuthenticationOptions プロパティ バッグで指定されている情報が使用されます。The authentication process uses information specified in the sslClientAuthenticationOptions property bag.

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 接続のプロパティ バッグ。The property bag for the SSL connection.

cancellationToken
CancellationToken

キャンセル要求を監視するためのトークン。The token to monitor for cancellation requests.

戻り値

Task

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation.

例外

ServerCertificateSelectionCallbackServerCertificate、または ServerCertificateContextnull であり、LocalCertificateSelectionCallbackSslStream コンストラクターで設定されていません。Either ServerCertificateSelectionCallback or ServerCertificate or ServerCertificateContext is null and LocalCertificateSelectionCallback is not set in the SslStream constructor.

sslServerAuthenticationOptionsnullです。sslServerAuthenticationOptions is null.

認証に失敗し、このオブジェクトが使用できない状態のままになっています。The authentication failed and left this object in an unusable state.

認証が既に発生しました。Authentication has already occurred.

または-or- この SslStream を使用するクライアントの認証は以前に試行されました。Client authentication using this SslStream was tried previously.

または-or- 認証が既に実行中です。Authentication is already in progress.

このオブジェクトは閉じられました。This object has been closed.

注釈

認証に失敗すると、が表示され、 AuthenticationException これは使用でき SslStream なくなります。If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. このオブジェクトを閉じて、ガベージコレクターによって収集されるように、このオブジェクトへのすべての参照を削除する必要があります。You should close this object and remove all references to it so that it can be collected by the garbage collector.

適用対象

AuthenticateAsServerAsync(X509Certificate)

サーバーによって呼び出され、指定した証明書を使用して、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificate as an asynchronous operation.

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

サーバーの認証に使用する証明書。The certificate used to authenticate the server.

戻り値

Task

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation.

例外

serverCertificatenullです。serverCertificate is null.

認証に失敗し、このオブジェクトが使用できない状態のままになっています。The authentication failed and left this object in an unusable state.

認証が既に発生しました。Authentication has already occurred.

または-or- この SslStream を使用するクライアントの認証は以前に試行されました。Client authentication using this SslStream was tried previously.

または-or- 認証が既に実行中です。Authentication is already in progress.

このオブジェクトは閉じられました。This object has been closed.

Windows 95、Windows 98、および Windows ME (Millennium Edition) では、AuthenticateAsServerAsync メソッドはサポートされていません。The AuthenticateAsServerAsync method is not supported on Windows 95, Windows 98, or Windows Millennium.

注釈

.NET Framework 4.7 より、この方法では None を使用して認証を行うため、オペレーティング システムが使用する最適なプロトコルを選択し、セキュリティで保護されていないプロトコルをブロックできるようになります。Starting with .NET Framework 4.7, this method authenticates using None, which allows the operating system to choose the best protocol to use, and to block protocols that are not secure. .NET Framework 4.6 (および最新のセキュリティ パッチがインストールされている .NET Framework 4.5) で許可されている TLS /SSL プロトコルのバージョンは 1.2、1.1 および 1.0 です (ただし、Windows のレジストリを編集して強力な暗号化を無効にしていない場合に限ります)。In .NET Framework 4.6 (and .NET Framework 4.5 with the latest security patches installed), the allowed TLS/SSL protocols versions are 1.2, 1.1, and 1.0 (unless you disable strong cryptography by editing the Windows Registry).

このメソッドは、を使用して認証を Default 行います。This method authenticates using Default. 証明書失効リストは、認証時に確認されません。The certificate revocation list is not checked during authentication. クライアントは、認証用の証明書を提供する必要はありません。The client is not required to provide a certificate for authentication.

認証に失敗すると、が表示され、 AuthenticationException これは使用でき SslStream なくなります。If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. このオブジェクトを閉じて、ガベージコレクターによって収集されるように、このオブジェクトへのすべての参照を削除する必要があります。You should close this object and remove all references to it so that it can be collected by the garbage collector.

適用対象

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

サーバーによって呼び出され、クライアントとサーバー間の接続で非同期操作としてサーバーと (オプションで) クライアントを認証します。Called by servers to authenticate the server and optionally the client in a client-server connection as an asynchronous operation. 認証プロセスでは、optionsCallback によって返される情報が使用されます。The authentication process uses information returned by 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

コールバック デリゲート。The callback delegate.

state
Object

コールバックが呼び出されたときに optionsCallback に渡す状態オブジェクト。The state object to pass to optionsCallback when the callback is invoked.

cancellationToken
CancellationToken

キャンセル要求を監視するためのトークン。The token to monitor for cancellation requests.

戻り値

Task

非同期操作を表すタスク オブジェクト。The task object representing the asynchronous operation.

例外

ServerCertificateSelectionCallbackServerCertificate、または ServerCertificateContextnull であり、LocalCertificateSelectionCallbackSslStream コンストラクターで設定されていません。Either ServerCertificateSelectionCallback or ServerCertificate or ServerCertificateContext is null and LocalCertificateSelectionCallback is not set in the SslStream constructor.

認証に失敗し、このオブジェクトが使用できない状態のままになっています。The authentication failed and left this object in an unusable state.

認証が既に発生しました。Authentication has already occurred.

または-or- この SslStream を使用するクライアントの認証は以前に試行されました。Client authentication using this SslStream was tried previously.

または-or- 認証が既に実行中です。Authentication is already in progress.

このオブジェクトは閉じられました。This object has been closed.

注釈

認証に失敗すると、が表示され、 AuthenticationException これは使用でき SslStream なくなります。If the authentication fails, you receive a AuthenticationException, and this SslStream is no longer useable. このオブジェクトを閉じて、ガベージコレクターによって収集されるように、このオブジェクトへのすべての参照を削除する必要があります。You should close this object and remove all references to it so that it can be collected by the garbage collector.

適用対象