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)

Source:

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 指定的值必须与服务器证书上的名称匹配。

身份验证成功后，必须检查 IsEncrypted 和 IsSigned 属性来确定 所使用的SslStream安全服务。 IsMutuallyAuthenticated检查 属性以确定是否发生了相互身份验证。

如果身份验证失败，则会收到 ， AuthenticationException并且它 SslStream 不再可用。 应关闭此对象并删除对其的所有引用，以便垃圾回收器可以回收它。

AuthenticateAsClient(String)

Source:

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 指定的值必须与服务器证书上的名称匹配。

身份验证成功后，必须检查 IsEncrypted 和 IsSigned 属性来确定 所使用的SslStream安全服务。 IsMutuallyAuthenticated检查 属性以确定是否发生了相互身份验证。

如果身份验证失败，则会收到 ， AuthenticationException并且它 SslStream 不再可用。 应关闭此对象并删除对其的所有引用，以便垃圾回收器可以回收它。

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Source:

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 注册表禁用强加密）。

身份验证成功后，必须检查 IsEncrypted 和 IsSigned 属性来确定 所使用的SslStream安全服务。 IsMutuallyAuthenticated检查 属性以确定是否发生了相互身份验证。

如果身份验证失败，则会收到 ， AuthenticationException并且它 SslStream 不再可用。 应关闭此对象并删除对其的所有引用，以便垃圾回收器可以回收它。

注意

SSL 版本 2 协议不支持客户端证书。

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Source:

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 注册表禁用强加密）。

身份验证成功后，必须检查 IsEncrypted 和 IsSigned 属性来确定 所使用的SslStream安全服务。 IsMutuallyAuthenticated检查 属性以确定是否发生了相互身份验证。

如果身份验证失败，则会收到 ， AuthenticationException并且它 SslStream 不再可用。 应关闭此对象并删除对其的所有引用，以便垃圾回收器可以回收它。

注意

SSL 版本 2 协议不支持客户端证书。