SslStream.AuthenticateAsClient メソッド

定義

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

オーバーロード

AuthenticateAsClient(SslClientAuthenticationOptions)

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

AuthenticateAsClient(String)

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

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

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

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

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

AuthenticateAsClient(SslClientAuthenticationOptions)

ソース:
SslStream.cs
ソース:
SslStream.cs
ソース:
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 接続のプロパティ バッグ。

例外

targetHostnullです。

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

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

または

この SslStream を使用するサーバーの認証は以前に試行されました。

または

認証が既に実行中です。

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

注釈

.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
ソース:
SslStream.cs
ソース:
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 を共有するサーバーの名前。

例外

targetHostnullです。

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

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

または

この SslStream を使用するサーバーの認証は以前に試行されました。

または

認証が既に実行中です。

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

注釈

.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
ソース:
SslStream.cs
ソース:
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);
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
ソース:
SslStream.cs
ソース:
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);
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 プロトコルではサポートされていません。

適用対象