次の方法で共有


SslStream.AuthenticateAsServerAsync メソッド

定義

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

オーバーロード

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 値。

戻り値

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

例外

serverCertificatenullです。

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

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

または

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

または

認証が既に実行中です。

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

注釈

.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

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

checkCertificateRevocation
Boolean

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

戻り値

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

例外

serverCertificatenullです。

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

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

または

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

または

認証が既に実行中です。

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

注釈

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

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

戻り値

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

例外

ServerCertificateSelectionCallbackServerCertificate、または ServerCertificateContextnull であり、LocalCertificateSelectionCallbackSslStream コンストラクターで設定されていません。

sslServerAuthenticationOptionsnullです。

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

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

または

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

または

認証が既に実行中です。

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

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

注釈

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

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの 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

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

戻り値

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

例外

serverCertificatenullです。

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

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

または

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

または

認証が既に実行中です。

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

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

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

戻り値

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

例外

ServerCertificateSelectionCallbackServerCertificate、または ServerCertificateContextnull であり、LocalCertificateSelectionCallbackSslStream コンストラクターで設定されていません。

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

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

または

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

または

認証が既に実行中です。

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

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

注釈

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

適用対象