SslStream.AuthenticateAsClient メソッド

定義

名前空間:

System.Net.Security

アセンブリ:

System.Net.Security.dll

クライアントとサーバー間の接続のクライアント側を認証します。

オーバーロード

AuthenticateAsClient(SslClientAuthenticationOptions)	サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、クライアントによって呼び出されます。
AuthenticateAsClient(String)	サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、クライアントによって呼び出されます。
AuthenticateAsClient(String, X509CertificateCollection, Boolean)	サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、クライアントによって呼び出されます。 認証プロセスでは、指定された証明書コレクション、およびシステムの既定の SSL プロトコルを使用します。
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)	サーバーおよび必要に応じてクライアントとサーバー間の接続にあるクライアントを認証するために、クライアントによって呼び出されます。 認証プロセスには、指定した証明書コレクションおよび SSL プロトコルが使用されます。

AuthenticateAsClient(SslClientAuthenticationOptions)

ソース:

SslStream.cs

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

public:
 void AuthenticateAsClient(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions);

public void AuthenticateAsClient (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions);

member this.AuthenticateAsClient : System.Net.Security.SslClientAuthenticationOptions -> unit

Public Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)

パラメーター

sslClientAuthenticationOptions

SslClientAuthenticationOptions

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

例外

ArgumentNullException

targetHost が 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 のレジストリを編集して強力な暗号化を無効にしていない場合に限ります)。 認証ではクライアント証明書は使用されません。 認証中に証明書失効リストがチェックされません。 に targetHost 指定する値は、サーバーの証明書の名前と一致している必要があります。

認証が成功したら、 プロパティと IsSigned プロパティをチェックIsEncryptedして、 によって使用されるセキュリティ サービスを決定するSslStream必要があります。 プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。

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

AuthenticateAsClient(String)

ソース:

SslStream.cs

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

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost);

public virtual void AuthenticateAsClient (string targetHost);

abstract member AuthenticateAsClient : string -> unit
override this.AuthenticateAsClient : string -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String)

パラメーター

targetHost

String

この SslStream を共有するサーバーの名前。

例外

ArgumentNullException

targetHost が 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 のレジストリを編集して強力な暗号化を無効にしていない場合に限ります)。 認証ではクライアント証明書は使用されません。 認証中に証明書失効リストがチェックされません。 に targetHost 指定する値は、サーバーの証明書の名前と一致している必要があります。

認証が成功したら、 プロパティと IsSigned プロパティをチェックIsEncryptedして、 によって使用されるセキュリティ サービスを決定するSslStream必要があります。 プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。

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

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

ソース:

SslStream.cs

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

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)

パラメーター

targetHost

String

この SslStream を共有するサーバーの名前。

clientCertificates

X509CertificateCollection

クライアント証明書を格納している X509CertificateCollection。

checkCertificateRevocation

Boolean

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

注釈

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

認証が成功したら、 プロパティと IsSigned プロパティをチェックIsEncryptedして、 によって使用されるセキュリティ サービスを決定するSslStream必要があります。 プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。

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

注意

クライアント証明書は、SSL バージョン 2 プロトコルではサポートされていません。

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

ソース:

SslStream.cs

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

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

パラメーター

targetHost

String

この SslStream を共有するサーバーの名前。

clientCertificates

X509CertificateCollection

クライアント証明書を格納している X509CertificateCollection。

enabledSslProtocols

SslProtocols

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

checkCertificateRevocation

Boolean

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

注釈

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

認証が成功したら、 プロパティと IsSigned プロパティをチェックIsEncryptedして、 によって使用されるセキュリティ サービスを決定するSslStream必要があります。 プロパティを IsMutuallyAuthenticated 調べて、相互認証が行われたかどうかを確認します。

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

注意

クライアント証明書は、SSL バージョン 2 プロトコルではサポートされていません。