SslStream.AuthenticateAsServerAsync 方法

参考

定义

命名空间:: System.Net.Security

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

程序集:: System.dll

程序集:: netstandard.dll

重要

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

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

重载

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)	由服务器调用，以通过异步操作的形式使用指定的证书、要求和安全协议对客户端 - 服务器连接中的服务器和客户端（可选）进行身份验证。
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)	由服务器调用，以通过异步操作的形式使用指定的证书、要求和安全协议对客户端 - 服务器连接中的服务器和客户端（可选）进行身份验证。
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)	服务器调用此方法，对客户端-服务器连接中的服务器及客户端（可选）进行身份验证以作为异步操作。身份验证过程使用 `sslClientAuthenticationOptions` 属性包中指定的信息。
AuthenticateAsServerAsync(X509Certificate)	服务器调用此方法，使用指定的证书对客户端-服务器连接中的服务器及客户端（可选）进行身份验证以作为异步操作。
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)	服务器调用此方法，对客户端-服务器连接中的服务器及客户端（可选）进行身份验证以作为异步操作。身份验证过程使用 `optionsCallback` 返回的信息。

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

参数

serverCertificate: X509Certificate

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

clientCertificateRequired: Boolean

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

enabledSslProtocols: SslProtocols

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

checkCertificateRevocation: Boolean

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

Task

表示异步操作的任务对象。

例外

ArgumentNullException

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

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

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)异常。

适用于

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As Task

参数

serverCertificate: X509Certificate

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

clientCertificateRequired: Boolean

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

checkCertificateRevocation: Boolean

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

Task

表示异步操作的任务对象。

例外

ArgumentNullException

serverCertificate 为 null。

AuthenticationException

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

InvalidOperationException

已进行了身份验证。

或

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

或

身份验证已在进行中。

ObjectDisposedException

此对象已关闭。

注解

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

适用于

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

服务器调用此方法，对客户端-服务器连接中的服务器及客户端（可选）进行身份验证以作为异步操作。身份验证过程使用 sslClientAuthenticationOptions 属性包中指定的信息。

public:
 System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);

public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken);

member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As Task

参数

sslServerAuthenticationOptions: SslServerAuthenticationOptions

SSL 连接的属性包。

cancellationToken: CancellationToken

要监视取消请求的标记。

Task

表示异步操作的任务对象。

例外

ArgumentNullException

ServerCertificateSelectionCallback 或 ServerCertificate 或 ServerCertificateContext 为 null，并且未在 SslStream 构造函数中设置 LocalCertificateSelectionCallback。

ArgumentNullException

sslServerAuthenticationOptions 为 null。

AuthenticationException

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

InvalidOperationException

已进行了身份验证。

或

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

或

身份验证已在进行中。

ObjectDisposedException

此对象已关闭。

OperationCanceledException

取消令牌已取消。此异常存储在返回的任务中。

注解

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

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 AuthenticateAsServer(SslServerAuthenticationOptions)异常。

适用于

AuthenticateAsServerAsync(X509Certificate)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);

public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);

abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As Task

参数

serverCertificate: X509Certificate

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

Task

表示异步操作的任务对象。

例外

ArgumentNullException

serverCertificate 为 null。

AuthenticationException

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

InvalidOperationException

已进行了身份验证。

或

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

或

身份验证已在进行中。

ObjectDisposedException

此对象已关闭。

PlatformNotSupportedException

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

注解

此方法使用 Default进行身份验证。身份验证期间不会检查证书吊销列表。客户端不需要提供用于身份验证的证书。

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

此方法存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 AuthenticateAsServer(X509Certificate)异常。

适用于

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

Source:: SslStream.cs

Source:: SslStream.cs

Source:: SslStream.cs

服务器调用此方法，对客户端-服务器连接中的服务器及客户端（可选）进行身份验证以作为异步操作。身份验证过程使用 optionsCallback 返回的信息。

public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.ServerOptionsSelectionCallback optionsCallback, object? state, System.Threading.CancellationToken cancellationToken = default);

member this.AuthenticateAsServerAsync : System.Net.Security.ServerOptionsSelectionCallback * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

optionsCallback: ServerOptionsSelectionCallback

回调委托。

state: Object

要在调用回调时传递给 optionsCallback 的状态对象。

cancellationToken: CancellationToken

要监视取消请求的标记。

Task

表示异步操作的任务对象。

例外

ArgumentNullException

ServerCertificateSelectionCallback 或 ServerCertificate 或 ServerCertificateContext 为 null，并且未在 SslStream 构造函数中设置 LocalCertificateSelectionCallback。

AuthenticationException

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

InvalidOperationException

已进行了身份验证。

或

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

或

身份验证已在进行中。

ObjectDisposedException

此对象已关闭。

OperationCanceledException

取消令牌已取消。此异常存储在返回的任务中。

注解

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

适用于

通过

SslStream.AuthenticateAsServerAsync 方法

定义

重载

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

参数

返回

例外

注解

适用于

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

参数

返回

例外

注解

适用于

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

参数

返回

例外

注解

适用于

AuthenticateAsServerAsync(X509Certificate)

参数

返回

例外

注解

适用于

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

参数

返回

例外

注解

适用于

其他资源