SslStream.AuthenticateAsServerAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
服务器调用此方法，对客户端-服务器连接中的服务器及客户端（可选）进行身份验证以作为异步操作。
重载
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
由服务器调用，以通过异步操作的形式使用指定的证书、要求和安全协议对客户端 - 服务器连接中的服务器和客户端（可选）进行身份验证。 |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
由服务器调用，以通过异步操作的形式使用指定的证书、要求和安全协议对客户端 - 服务器连接中的服务器和客户端（可选）进行身份验证。 |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
服务器调用此方法，对客户端-服务器连接中的服务器及客户端（可选）进行身份验证以作为异步操作。 身份验证过程使用 |
| AuthenticateAsServerAsync(X509Certificate) |
服务器调用此方法，使用指定的证书对客户端-服务器连接中的服务器及客户端（可选）进行身份验证以作为异步操作。 |
| AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken) |
服务器调用此方法，对客户端-服务器连接中的服务器及客户端（可选）进行身份验证以作为异步操作。 身份验证过程使用 |
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.TaskPublic 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 值，该值表示进行身份验证所使用的协议。
返回
表示异步操作的任务对象。
例外
serverCertificate 为 null。
身份验证失败，并使此对象处于不可用的状态。
此对象已关闭。
注解
从 .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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As Task参数
- serverCertificate
- X509Certificate
用于对服务器进行身份验证的 X509Certificate 。
- clientCertificateRequired
- Boolean
一个 Boolean 值，该值指定是否向客户端请求证书用于进行身份验证。 请注意，这只是一个请求 - 如果没有提供任何证书，服务器仍然可接受连接请求。
返回
表示异步操作的任务对象。
例外
serverCertificate 为 null。
身份验证失败，并使此对象处于不可用的状态。
此对象已关闭。
注解
从 .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, Boolean)异常。
适用于
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.TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As Task参数
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
SSL 连接的属性包。
- cancellationToken
- CancellationToken
要监视取消请求的标记。
返回
表示异步操作的任务对象。
例外
ServerCertificateSelectionCallback 或 ServerCertificate 或 ServerCertificateContext 为 null，并且未在 SslStream 构造函数中设置 LocalCertificateSelectionCallback。
sslServerAuthenticationOptions 为 null。
身份验证失败，并使此对象处于不可用的状态。
此对象已关闭。
取消令牌已取消。 此异常存储在返回的任务中。
注解
如果身份验证失败，则会收到 一个 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.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As Task参数
- serverCertificate
- X509Certificate
用于对服务器进行身份验证的证书。
返回
表示异步操作的任务对象。
例外
serverCertificate 为 null。
身份验证失败，并使此对象处于不可用的状态。
此对象已关闭。
Windows 95、Windows 98 或 Windows Millennium 上不支持 AuthenticateAsServerAsync 方法。
注解
从 .NET Framework 4.7 开始，此方法使用 None 进行身份验证，这允许操作系统选择要使用的最佳协议，并将其用于阻止不安全的协议。 在 .NET Framework 4.6（以及安装了最新安全修补程序的 .NET Framework 4.5）中，允许的 TLS/SSL 协议版本为 1.2、1.1 和 1.0（除非通过编辑 Windows 注册表禁用强加密）。
此方法使用 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.TaskPublic Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As Task参数
- optionsCallback
- ServerOptionsSelectionCallback
回调委托。
- state
- Object
要在调用回调时传递给 optionsCallback 的状态对象。
- cancellationToken
- CancellationToken
要监视取消请求的标记。
返回
表示异步操作的任务对象。
例外
ServerCertificateSelectionCallback 或 ServerCertificate 或 ServerCertificateContext 为 null，并且未在 SslStream 构造函数中设置 LocalCertificateSelectionCallback。
身份验证失败，并使此对象处于不可用的状态。
此对象已关闭。
取消令牌已取消。 此异常存储在返回的任务中。
注解
如果身份验证失败，则会收到 一个 AuthenticationException，并且它 SslStream 不再可用。 应关闭此对象并删除对其的所有引用，以便垃圾回收器可以收集它。
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈