Udostępnij za pośrednictwem

SslStream.AuthenticateAsClient Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net.Security
Zestaw:
System.Net.Security.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll

Uwierzytelnianie po stronie klienta połączenia klient-serwer.

Przeciążenia

AuthenticateAsClient(SslClientAuthenticationOptions)

Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer.
AuthenticateAsClient(String)

Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer.
AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer. Proces uwierzytelniania używa określonej kolekcji certyfikatów i domyślnego protokołu SSL systemu.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer. W procesie uwierzytelniania jest używana określona kolekcja certyfikatów i protokół SSL.

AuthenticateAsClient(SslClientAuthenticationOptions)

Źródło:
SslStream.cs
Źródło:
SslStream.cs
Źródło:
SslStream.cs

Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer.

public:
 void AuthenticateAsClient(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions);
public void AuthenticateAsClient (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions);
member this.AuthenticateAsClient : System.Net.Security.SslClientAuthenticationOptions -> unit
Public Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)

Parametry

sslClientAuthenticationOptions
SslClientAuthenticationOptions

Torba właściwości dla połączenia SSL.

Wyjątki

ArgumentNullException

targetHost to null.

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiono ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie już wystąpiło.

-lub-

Wcześniej próbowano użyć uwierzytelniania SslStream serwera.

-lub-

Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

Uwagi

Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń), dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączysz silną kryptografię przez edytowanie rejestru systemu Windows). W uwierzytelnianiu nie są używane żadne certyfikaty klienta. Lista odwołania certyfikatów nie jest sprawdzana podczas uwierzytelniania. Wartość określona dla targetHost musi być zgodna z nazwą certyfikatu serwera.

Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę SslStream. Sprawdź właściwość , IsMutuallyAuthenticated aby określić, czy wystąpiło wzajemne uwierzytelnianie.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony komunikat AuthenticationException, który SslStream nie jest już możliwy do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było go zebrać przez moduł odśmiecający pamięci.

Dotyczy

AuthenticateAsClient(String)

Źródło:
SslStream.cs
Źródło:
SslStream.cs
Źródło:
SslStream.cs

Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost);
public virtual void AuthenticateAsClient (string targetHost);
abstract member AuthenticateAsClient : string -> unit
override this.AuthenticateAsClient : string -> unit
Public Overridable Sub AuthenticateAsClient (targetHost As String)

Parametry

targetHost
String

Nazwa serwera, który współudzieli ten element SslStream.

Wyjątki

ArgumentNullException

targetHost to null.

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiono ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie już wystąpiło.

-lub-

Wcześniej próbowano użyć uwierzytelniania SslStream serwera.

-lub-

Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

Uwagi

Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń), dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączysz silną kryptografię przez edytowanie rejestru systemu Windows). W uwierzytelnianiu nie są używane żadne certyfikaty klienta. Lista odwołania certyfikatów nie jest sprawdzana podczas uwierzytelniania. Wartość określona dla targetHost musi być zgodna z nazwą certyfikatu serwera.

Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę SslStream. Sprawdź właściwość , IsMutuallyAuthenticated aby określić, czy wystąpiło wzajemne uwierzytelnianie.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony komunikat AuthenticationException, który SslStream nie jest już możliwy do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było go zebrać przez moduł odśmiecający pamięci.

Dotyczy

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Źródło:
SslStream.cs
Źródło:
SslStream.cs
Źródło:
SslStream.cs

Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer. Proces uwierzytelniania używa określonej kolekcji certyfikatów i domyślnego protokołu SSL systemu.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);
public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);
public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation);
abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit
Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)

Parametry

targetHost
String

Nazwa serwera, który będzie współużytkowyć ten element SslStream.

clientCertificates
X509CertificateCollection

Element X509CertificateCollection zawierający certyfikaty klienta.

checkCertificateRevocation
Boolean

Boolean Wartość określająca, czy lista odwołania certyfikatów jest sprawdzana podczas uwierzytelniania.

Uwagi

Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń), dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączysz silną kryptografię przez edytowanie rejestru systemu Windows).

Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę SslStream. Sprawdź właściwość , IsMutuallyAuthenticated aby określić, czy wystąpiło wzajemne uwierzytelnianie.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony komunikat AuthenticationException, który SslStream nie jest już możliwy do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było go zebrać przez moduł odśmiecający pamięci.

Uwaga

Certyfikaty klienta nie są obsługiwane w protokole SSL w wersji 2.

Dotyczy

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Źródło:
SslStream.cs
Źródło:
SslStream.cs
Źródło:
SslStream.cs

Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer. W procesie uwierzytelniania jest używana określona kolekcja certyfikatów i protokół SSL.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit
Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

Parametry

targetHost
String

Nazwa serwera, który będzie współużytkowyć ten element SslStream.

clientCertificates
X509CertificateCollection

Element X509CertificateCollection zawierający certyfikaty klienta.

enabledSslProtocols
SslProtocols

SslProtocols Wartość reprezentująca protokoły używane do uwierzytelniania.

checkCertificateRevocation
Boolean

Boolean Wartość określająca, czy lista odwołania certyfikatów jest sprawdzana podczas uwierzytelniania.

Uwagi

Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń), dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączysz silną kryptografię przez edytowanie rejestru systemu Windows).

Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę SslStream. Sprawdź właściwość , IsMutuallyAuthenticated aby określić, czy wystąpiło wzajemne uwierzytelnianie.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony komunikat AuthenticationException, który SslStream nie jest już możliwy do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było go zebrać przez moduł odśmiecający pamięci.

Uwaga

Certyfikaty klienta nie są obsługiwane w protokole SSL w wersji 2.

Dotyczy