SslStream.AuthenticateAsClientAsync Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net.Security

Zestaw:: System.Net.Security.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Uwierzytelnij stronę klienta połączenia klienta-serwera jako operację asynchroniczną.

Przeciążenia

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)	Wywoływane przez klientów w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera jako operacji asynchronicznej. Proces uwierzytelniania używa określonej kolekcji certyfikatów i protokołu SSL.
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)	Wywoływane przez klientów w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera jako operacji asynchronicznej. Proces uwierzytelniania używa określonej kolekcji certyfikatów i domyślnego protokołu SSL systemu.
AuthenticateAsClientAsync(String)	Wywoływane przez klientów w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera jako operacji asynchronicznej.
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)	Wywoływane przez klientów w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera jako operacji asynchronicznej. Proces uwierzytelniania używa informacji określonych w torbie `sslClientAuthenticationOptions` właściwości.

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Wywoływane przez klientów w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera jako operacji asynchronicznej. Proces uwierzytelniania używa określonej kolekcji certyfikatów i protokołu SSL.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Parametry

targetHost: String

Nazwa serwera, który udostępni ten SslStreamelement .

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.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

AuthenticationException

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

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

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

-lub- Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

Uwagi

Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, jakie usługi zabezpieczeń są używane przez usługę SslStream. Sprawdź właściwość, IsMutuallyAuthenticated aby określić, czy doszło do wzajemnego uwierzytelniania.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, otrzymasz element AuthenticationException, a to SslStream nie jest już możliwe do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było je zebrać przez moduł odśmieceń pamięci.

Uwaga

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

Dotyczy

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As Task

Parametry

targetHost: String

Nazwa serwera, który udostępni ten SslStreamelement .

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.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

AuthenticationException

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

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

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

-lub- Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

Uwagi

Uwaga

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

Dotyczy

AuthenticateAsClientAsync(String)

Wywoływane przez klientów w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera jako operacji asynchronicznej.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (string targetHost);

abstract member AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (targetHost As String) As Task

Parametry

targetHost: String

Nazwa serwera, który udostępnia ten SslStreamelement .

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

targetHost to null.

AuthenticationException

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

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

-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 jest uwierzytelniana przy użyciu None , co umożliwia systemowi operacyjnemu wybranie najlepszego używanego protokołu i blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4,6 (i .NET Framework 4,5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń) dozwolone protokoły TLS/SSL to 1,2, 1,1 i 1,0 (chyba że zostanie wyłączone silne Kryptografia, edytując rejestr systemu Windows). W uwierzytelnieniu 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.

Dotyczy

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Wywoływane przez klientów w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera jako operacji asynchronicznej. Proces uwierzytelniania używa informacji określonych w torbie sslClientAuthenticationOptions właściwości.

public:
 System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);

public System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken);

member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, cancellationToken As CancellationToken) As Task