SslStream.AuthenticateAsServer メソッド

定義

名前空間:: System.Net.Security

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

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

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

オーバーロード

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

AuthenticateAsServer(X509Certificate)

指定した証明書を使用してサーバーを認証し、必要に応じてクライアントとサーバーの接続でクライアントを認証するためにサーバーによって呼び出されます。

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

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

注釈

.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)

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

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

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

注釈

適用対象

AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)

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

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)