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)

來源:: SslStream.cs

來源:: SslStream.cs

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

來源:: SslStream.cs

來源:: SslStream.cs

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

來源:: SslStream.cs

來源:: SslStream.cs

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

來源:: SslStream.cs

來源:: SslStream.cs

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

參數

例外狀況

備註

適用於

其他資源