SslStream.BeginAuthenticateAsClient Metoda

Definicja

Przestrzeń nazw:

System.Net.Security

Zestaw:

System.Net.Security.dll

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

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);

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

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

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 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.

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

Ź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);

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

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

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 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.

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

Ź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);

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

IAsyncResult Obiekt wskazujący stan operacji asynchronicznej.

Wyjątki

ArgumentNullException

targetHost to null.

ArgumentException

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

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 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.