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)

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

傳回

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)

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

傳回

Task

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

例外狀況

ArgumentNullException

serverCertificate 為 null。

AuthenticationException

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

InvalidOperationException

已經進行驗證。

-或-

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

-或-

驗證已在進行中。

ObjectDisposedException

此物件已關閉。

備註

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

適用於

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

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

傳回

Task

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

例外狀況

ArgumentNullException

ServerCertificateSelectionCallback、ServerCertificate 或 ServerCertificateContext 為 null，且 LocalCertificateSelectionCallback 未在 SslStream 建構函式中設定。

ArgumentNullException

sslServerAuthenticationOptions 為 null。

AuthenticationException

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

InvalidOperationException

已經進行驗證。

-或-

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

-或-

驗證已在進行中。

ObjectDisposedException

此物件已關閉。

OperationCanceledException

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

備註

如果驗證失敗，您會收到 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

憑證，用於驗證伺服器。

傳回

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)

來源:: 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

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

傳回

Task

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

例外狀況

ArgumentNullException

ServerCertificateSelectionCallback、ServerCertificate 或 ServerCertificateContext 為 null，且 LocalCertificateSelectionCallback 未在 SslStream 建構函式中設定。

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)

參數

傳回

例外狀況

備註

適用於

其他資源