SslStream.AuthenticateAsServer 方法

  • 參考

定義

命名空間:
System.Net.Security
組件:
System.Net.Security.dll
組件:
System.dll
組件:
netstandard.dll

由伺服器呼叫以驗證用戶端與伺服器連接中的伺服器及 (選擇性地驗證) 用戶端。

多載

AuthenticateAsServer(SslServerAuthenticationOptions)

由伺服器呼叫，以使用指定的憑證來驗證用戶端與伺服器連接中的伺服器及 (選擇性地驗證) 用戶端。
AuthenticateAsServer(X509Certificate)

由伺服器呼叫，以使用指定的憑證來驗證用戶端與伺服器連接中的伺服器及 (選擇性地驗證) 用戶端。
AuthenticateAsServer(X509Certificate, Boolean, Boolean)

已由伺服器呼叫，使用指定的憑證和需求，以及使用系統預設安全性通訊協定，來驗證用戶端與伺服器連線中的伺服器和用戶端 (選擇性)。
AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)

已由伺服器呼叫，使用指定的憑證、需求及安全性通訊協定，來驗證伺服器和用戶端伺服器連線中的用戶端 (選擇性)。

AuthenticateAsServer(SslServerAuthenticationOptions)

由伺服器呼叫，以使用指定的憑證來驗證用戶端與伺服器連接中的伺服器及 (選擇性地驗證) 用戶端。

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)

由伺服器呼叫，以使用指定的憑證來驗證用戶端與伺服器連接中的伺服器及 (選擇性地驗證) 用戶端。

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 方法。

備註

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

已由伺服器呼叫，使用指定的憑證和需求，以及使用系統預設安全性通訊協定，來驗證用戶端與伺服器連線中的伺服器和用戶端 (選擇性)。

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 方法。

備註

從 .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, Boolean, SslProtocols, Boolean)

已由伺服器呼叫，使用指定的憑證、需求及安全性通訊協定，來驗證伺服器和用戶端伺服器連線中的用戶端 (選擇性)。

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 方法。

備註

從 .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 無法再使用。 您應該關閉這個物件，並移除它的所有參考，以便垃圾收集行程可以收集它。

適用於