共用方式為


SslStream.AuthenticateAsServerAsync 方法

定義

由伺服器呼叫做為非同步作業,以驗證用戶端與伺服器連接中的伺服器,並選擇性地驗證用戶端。

多載

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)

來源:
SslStream.cs
來源:
SslStream.cs
來源:
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 值,指定是否要在驗證期間檢查憑證撤銷清單。

傳回

工作物件,表示非同步作業。

例外狀況

serverCertificatenull

驗證失敗,且此物件處於不穩定的狀態。

已經進行驗證。

-或-

先前已嘗試過使用此 SslStream 進行用戶端驗證。

-或-

驗證已在進行中。

此物件已關閉。

備註

從 .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)

來源:
SslStream.cs
來源:
SslStream.cs
來源:
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 值,指定是否要在驗證期間檢查憑證撤銷清單。

傳回

工作物件,表示非同步作業。

例外狀況

serverCertificatenull

驗證失敗,且此物件處於不穩定的狀態。

已經進行驗證。

-或-

先前已嘗試過使用此 SslStream 進行用戶端驗證。

-或-

驗證已在進行中。

此物件已關閉。

備註

從 .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)

來源:
SslStream.cs
來源:
SslStream.cs
來源:
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

用來監視是否有取消要求的語彙基元。

傳回

工作物件,表示非同步作業。

例外狀況

sslServerAuthenticationOptionsnull

驗證失敗,且此物件處於不穩定的狀態。

已經進行驗證。

-或-

先前已嘗試過使用此 SslStream 進行用戶端驗證。

-或-

驗證已在進行中。

此物件已關閉。

取消令牌已取消。 此例外狀況會儲存在傳回的工作中。

備註

如果驗證失敗,您會收到 AuthenticationException,因此 SslStream 無法再使用。 您應該關閉這個物件,並移除它的所有參考,以便垃圾收集行程可以收集它。

這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用狀況例外狀況,例如 ArgumentException,仍會同步擲回。 如需預存的例外狀況,請參閱 所 AuthenticateAsServer(SslServerAuthenticationOptions)擲回的例外狀況。

適用於

AuthenticateAsServerAsync(X509Certificate)

來源:
SslStream.cs
來源:
SslStream.cs
來源:
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

憑證,用於驗證伺服器。

傳回

工作物件,表示非同步作業。

例外狀況

serverCertificatenull

驗證失敗,且此物件處於不穩定的狀態。

已經進行驗證。

-或-

先前已嘗試過使用此 SslStream 進行用戶端驗證。

-或-

驗證已在進行中。

此物件已關閉。

在 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)

來源:
SslStream.cs
來源:
SslStream.cs
來源:
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

用來監視是否有取消要求的語彙基元。

傳回

工作物件,表示非同步作業。

例外狀況

驗證失敗,且此物件處於不穩定的狀態。

已經進行驗證。

-或-

先前已嘗試過使用此 SslStream 進行用戶端驗證。

-或-

驗證已在進行中。

此物件已關閉。

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

如果驗證失敗,您會收到 AuthenticationException,因此 SslStream 無法再使用。 您應該關閉此物件,並移除它的所有參考,以便垃圾收集行程可以收集它。

適用於