Udostępnij za pośrednictwem


SslStream.BeginAuthenticateAsClient Metoda

Definicja

Rozpoczyna operację uwierzytelniania po stronie klienta połączenia klient-serwer.

Przeciążenia

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Wywoływane przez klientów, aby rozpocząć operację asynchroniczną w celu uwierzytelnienia serwera i opcjonalnie klienta.

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

Wywoływane przez klientów, aby rozpocząć operację asynchroniczną w celu uwierzytelnienia serwera i opcjonalnie klienta przy użyciu określonych certyfikatów i domyślnego protokołu zabezpieczeń systemu.

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

Wywoływane przez klientów, aby rozpocząć operację asynchroniczną w celu uwierzytelnienia serwera i opcjonalnie klienta przy użyciu określonych certyfikatów i protokołu zabezpieczeń.

Uwagi

Przeciążenia tej metody nie blokują się, gdy uwierzytelnianie jest w toku. Aby zablokować podczas oczekiwania na ukończenie uwierzytelniania, użyj jednej z AuthenticateAsClient metod.

BeginAuthenticateAsClient(String, AsyncCallback, Object)

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

Wywoływane przez klientów, aby rozpocząć operację asynchroniczną w celu uwierzytelnienia serwera i opcjonalnie klienta.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametry

targetHost
String

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

asyncCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu uwierzytelniania.

asyncState
Object

Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji. Ten obiekt jest przekazywany do delegata po zakończeniu asyncCallback operacji.

Zwraca

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

Wyjątki

targetHost to null.

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

Uwierzytelnianie zostało już zrobione.

-lub-

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

-lub-

Uwierzytelnianie jest już w toku.

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 wersji .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łączono silną kryptografię przez edytowanie rejestru 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.

Operacja uwierzytelniania asynchronicznego musi zostać ukończona przez wywołanie EndAuthenticateAsClient metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback .

Ta metoda nie blokuje się po zakończeniu operacji. Aby zablokować działanie do momentu zakończenia operacji, użyj jednego z AuthenticateAsClient przeciążeń metody.

Aby uzyskać szczegółowe informacje o korzystaniu z asynchronicznego modelu programowania, zobacz Wywoływanie metod synchronicznych asynchronicznie

Jeśli otrzymasz element AuthenticationException, nie jest to SslStream 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.

Dotyczy

BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)

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

Wywoływane przez klientów, aby rozpocząć operację asynchroniczną w celu uwierzytelnienia serwera i opcjonalnie klienta przy użyciu określonych certyfikatów i domyślnego protokołu zabezpieczeń systemu.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametry

targetHost
String

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

clientCertificates
X509CertificateCollection

Zawierające X509CertificateCollection certyfikaty klienta.

checkCertificateRevocation
Boolean

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

asyncCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu uwierzytelniania.

asyncState
Object

Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji. Ten obiekt jest przekazywany do delegata po zakończeniu asyncCallback operacji.

Zwraca

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

Wyjątki

targetHost to null.

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

Uwierzytelnianie zostało już zrobione.

-lub-

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

-lub-

Uwierzytelnianie jest już w toku.

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 wersji .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łączono silną kryptografię przez edytowanie rejestru systemu Windows).

Wartość określona dla targetHost musi być zgodna z nazwą certyfikatu serwera.

Operacja uwierzytelniania asynchronicznego musi zostać ukończona przez wywołanie EndAuthenticateAsClient metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback .

Ta metoda nie blokuje się po zakończeniu operacji. Aby zablokować działanie do momentu zakończenia operacji, użyj jednego z AuthenticateAsClient przeciążeń metody.

Aby uzyskać szczegółowe informacje o korzystaniu z asynchronicznego modelu programowania, zobacz Wywoływanie metod synchronicznych asynchronicznie

Jeśli otrzymasz element AuthenticationException, nie jest to SslStream 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

BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)

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

Wywoływane przez klientów, aby rozpocząć operację asynchroniczną w celu uwierzytelnienia serwera i opcjonalnie klienta przy użyciu określonych certyfikatów i protokołu zabezpieczeń.

public:
 virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Parametry

targetHost
String

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

clientCertificates
X509CertificateCollection

Zawierające X509CertificateCollection 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.

asyncCallback
AsyncCallback

Delegat AsyncCallback , który odwołuje się do metody wywoływania po zakończeniu uwierzytelniania.

asyncState
Object

Obiekt zdefiniowany przez użytkownika, który zawiera informacje o operacji. Ten obiekt jest przekazywany do delegata po zakończeniu asyncCallback operacji.

Zwraca

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

Wyjątki

targetHost to null.

enabledSslProtocols jest nieprawidłową SslProtocols wartością.

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

Uwierzytelnianie zostało już zrobione.

-lub-

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

-lub-

Uwierzytelnianie jest już w toku.

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 wersji .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łączono silną kryptografię przez edytowanie rejestru systemu Windows).

Wartość określona dla targetHost musi być zgodna z nazwą certyfikatu serwera.

Operacja uwierzytelniania asynchronicznego musi zostać ukończona przez wywołanie EndAuthenticateAsClient metody . Zazwyczaj metoda jest wywoływana przez delegata asyncCallback .

Ta metoda nie blokuje się po zakończeniu operacji. Aby zablokować działanie do momentu zakończenia operacji, użyj jednego z AuthenticateAsClient przeciążeń metody.

Aby uzyskać szczegółowe informacje o korzystaniu z asynchronicznego modelu programowania, zobacz Wywoływanie metod synchronicznych asynchronicznie

Jeśli otrzymasz element AuthenticationException, nie jest to SslStream 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