SslStream.AuthenticateAsClient メソッド

定義

名前空間:: System.Net.Security

アセンブリ:: netstandard.dll, System.Net.Security.dll

アセンブリ:: System.Net.Security.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

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

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

オーバーロード

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

AuthenticateAsClient(SslClientAuthenticationOptions)

ソース:: SslStream.cs

ソース:: SslStream.cs

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

例外

ArgumentNullException

sslClientAuthenticationOptions は 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に指定する値は、サーバーの証明書の名前と一致する必要があります。

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

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

適用対象

AuthenticateAsClient(String)

ソース:: SslStream.cs

ソース:: SslStream.cs

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

例外

ArgumentNullException

targetHost は nullです。

AuthenticationException

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

InvalidOperationException

認証は既に行われました。

-又は-

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

-又は-

認証は既に進行中です。

ObjectDisposedException

このオブジェクトは閉じられています。

注釈

適用対象

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

ソース:: SslStream.cs

ソース:: SslStream.cs

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

注釈

Note

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

適用対象

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

ソース:: SslStream.cs

ソース:: SslStream.cs

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

注釈

Note

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

適用対象

フィードバック

このページはお役に立ちましたか?