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

Windows 95、Windows 98 或千年Windows不支持 AuthenticateAsServer 方法。

注解

从 .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 值，该值指定在身份验证期间是否检查证书吊销列表。

例外