SslStream.AuthenticateAsServer メソッド

定義

名前空間:

System.Net.Security

アセンブリ:

System.Net.Security.dll

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

オーバーロード

AuthenticateAsServer(SslServerAuthenticationOptions)	サーバーによって呼び出され、指定した証明書を使用して、クライアントとサーバー間の接続でサーバーとオプションでクライアントを認証します。
AuthenticateAsServer(X509Certificate)	サーバーによって呼び出され、指定した証明書を使用して、クライアントとサーバー間の接続でサーバーとオプションでクライアントを認証します。
AuthenticateAsServer(X509Certificate, Boolean, Boolean)	指定された証明書と要件、およびシステムの既定のセキュリティ プロトコルを使用して、サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、サーバーによって呼び出されます。
AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)	指定された証明書、要件、およびセキュリティ プロトコルを使用して、サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、サーバーによって呼び出されます。

AuthenticateAsServer(SslServerAuthenticationOptions)

ソース:

SslStream.cs

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

public:
 void AuthenticateAsServer(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions);

public void AuthenticateAsServer (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions);

member this.AuthenticateAsServer : System.Net.Security.SslServerAuthenticationOptions -> unit

Public Sub AuthenticateAsServer (sslServerAuthenticationOptions As SslServerAuthenticationOptions)

パラメーター

sslServerAuthenticationOptions

SslServerAuthenticationOptions

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

例外

ArgumentNullException

serverCertificate が nullです。

AuthenticationException

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

InvalidOperationException

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

または

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

または

認証が既に実行中です。

ObjectDisposedException

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

PlatformNotSupportedException

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

注釈

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

このメソッドは、操作が完了するまでブロックします。 操作が完了するまでブロックされないようにするには、いずれかのメソッド オーバーロードを BeginAuthenticateAsServer 使用します。

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

AuthenticateAsServer(X509Certificate)

ソース:

SslStream.cs

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

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate)

パラメーター

serverCertificate

X509Certificate

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

例外

ArgumentNullException

serverCertificate が nullです。

AuthenticationException

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

InvalidOperationException

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

または

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

または

認証が既に実行中です。

ObjectDisposedException

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

PlatformNotSupportedException

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

注釈

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

このメソッドは、操作が完了するまでブロックします。 操作が完了するまでブロックされないようにするには、いずれかのメソッド オーバーロードを BeginAuthenticateAsServer 使用します。

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

AuthenticateAsServer(X509Certificate, Boolean, Boolean)

ソース:

SslStream.cs

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

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean)

パラメーター

serverCertificate

X509Certificate

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

clientCertificateRequired

Boolean

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

checkCertificateRevocation

Boolean

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

例外

ArgumentNullException

serverCertificate が nullです。

AuthenticationException

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

InvalidOperationException

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

または

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

または

認証が既に実行中です。

ObjectDisposedException

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

PlatformNotSupportedException

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

注釈

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

このメソッドは、操作が完了するまでブロックします。 操作が完了するまでブロックされないようにするには、いずれかのメソッド オーバーロードを BeginAuthenticateAsServer 使用します。

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

AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)

ソース:

SslStream.cs

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

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

パラメーター

serverCertificate

X509Certificate

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

clientCertificateRequired

Boolean

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

enabledSslProtocols

SslProtocols

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

checkCertificateRevocation

Boolean

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

例外

ArgumentNullException

serverCertificate が nullです。

ArgumentException

enabledSslProtocols は有効な SslProtocols 値ではありません。

AuthenticationException

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

InvalidOperationException

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

または

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

または

認証が既に実行中です。

ObjectDisposedException

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

PlatformNotSupportedException

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

注釈

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

このメソッドは、操作が完了するまでブロックします。 操作が完了するまでブロックされないようにするには、いずれかのメソッド オーバーロードを BeginAuthenticateAsServer 使用します。

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