SslStream.AuthenticateAsServer 方法

参考

定义

命名空间:: System.Net.Security

程序集:: System.Net.Security.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

服务器调用此方法，以便对客户端-服务器连接中的服务器及客户端（可选）进行身份验证。

重载

AuthenticateAsServer(SslServerAuthenticationOptions)	服务器调用此方法，以便使用指定的证书对客户端-服务器连接中的服务器及客户端（可选）进行身份验证。
AuthenticateAsServer(X509Certificate)	服务器调用此方法，以便使用指定的证书对客户端-服务器连接中的服务器及客户端（可选）进行身份验证。
AuthenticateAsServer(X509Certificate, Boolean, Boolean)	由服务器调用，以使用指定的证书、要求和系统默认安全协议在客户端 - 服务器连接中对服务器和客户端（可选）进行身份验证。
AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)	由服务器调用，以使用指定的证书、要求和安全协议在客户端 - 服务器连接中对服务器和客户端（可选）进行身份验证。

AuthenticateAsServer(SslServerAuthenticationOptions)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

服务器调用此方法，以便使用指定的证书对客户端-服务器连接中的服务器及客户端（可选）进行身份验证。

public:
 void AuthenticateAsServer(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions);

public void AuthenticateAsServer (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions);

member this.AuthenticateAsServer : System.Net.Security.SslServerAuthenticationOptions -> unit

Public Sub AuthenticateAsServer (sslServerAuthenticationOptions As SslServerAuthenticationOptions)

参数

sslServerAuthenticationOptions: SslServerAuthenticationOptions

SSL 连接的属性包。

例外

ArgumentNullException

serverCertificate 为 null。

AuthenticationException

身份验证失败，并使此对象处于不可用的状态。

InvalidOperationException

已进行了身份验证。

或

之前已尝试使用此 SslStream 进行了客户端身份验证。

或

身份验证已在进行中。

ObjectDisposedException

此对象已关闭。

PlatformNotSupportedException

Windows 95、Windows 98 或 Windows Millennium 上不支持 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)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

服务器调用此方法，以便使用指定的证书对客户端-服务器连接中的服务器及客户端（可选）进行身份验证。

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 Millennium 上不支持 AuthenticateAsServer 方法。

注解

此方法在操作完成之前会阻止。若要防止在操作完成之前阻塞，请使用方法重载之 BeginAuthenticateAsServer 一。

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

适用于

AuthenticateAsServer(X509Certificate, Boolean, Boolean)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

由服务器调用，以使用指定的证书、要求和系统默认安全协议在客户端 - 服务器连接中对服务器和客户端（可选）进行身份验证。

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

例外

ArgumentNullException

serverCertificate 为 null。

AuthenticationException

身份验证失败，并使此对象处于不可用的状态。

InvalidOperationException

已进行了身份验证。

或

之前已尝试使用此 SslStream 进行了客户端身份验证。

或

身份验证已在进行中。

ObjectDisposedException

此对象已关闭。

PlatformNotSupportedException

Windows 95、Windows 98 或 Windows Millennium 上不支持 AuthenticateAsServer 方法。

注解

此方法在操作完成之前会阻止。若要防止在操作完成之前阻塞，请使用方法重载之 BeginAuthenticateAsServer 一。

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

适用于

AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

由服务器调用，以使用指定的证书、要求和安全协议在客户端 - 服务器连接中对服务器和客户端（可选）进行身份验证。

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

参数

serverCertificate: X509Certificate

用于对服务器进行身份验证的 X509Certificate 。

clientCertificateRequired: Boolean

一个 Boolean 值，该值指定是否向客户端请求证书用于进行身份验证。请注意，这只是一个请求 - 如果没有提供任何证书，服务器仍然可接受连接请求。

enabledSslProtocols: SslProtocols

SslProtocols 值，该值表示进行身份验证所使用的协议。

checkCertificateRevocation: Boolean

一个 Boolean 值，该值指定身份验证期间是否检查证书吊销列表。

例外

ArgumentNullException

serverCertificate 为 null。

ArgumentException

enabledSslProtocols 不是有效的 SslProtocols 值。

AuthenticationException

身份验证失败，并使此对象处于不可用的状态。

InvalidOperationException

已进行了身份验证。

或

之前已尝试使用此 SslStream 进行了客户端身份验证。

或

身份验证已在进行中。

ObjectDisposedException

此对象已关闭。

PlatformNotSupportedException

Windows 95、Windows 98 或 Windows Millennium 上不支持 AuthenticateAsServer 方法。

注解

此方法在操作完成之前会阻止。若要防止在操作完成之前阻塞，请使用方法重载之 BeginAuthenticateAsServer 一。

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

适用于

通过

SslStream.AuthenticateAsServer 方法

定义

重载

AuthenticateAsServer(SslServerAuthenticationOptions)

参数

例外

注解

适用于

AuthenticateAsServer(X509Certificate)

参数

例外

注解

适用于

AuthenticateAsServer(X509Certificate, Boolean, Boolean)

参数

例外

注解

适用于

AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)

参数

例外

注解

适用于

其他资源