Condividi tramite


SslStream.BeginAuthenticateAsClient Metodo

Definizione

Avvia un'operazione per autenticare il lato client di una connessione client-server.

Overload

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Viene chiamato dai client per avviare un'operazione asincrona di autenticazione del server e, facoltativamente, del client.

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

Chiamato dai client per avviare un'operazione asincrona per autenticare il server e, facoltativamente, il client usando i certificati specificati e il protocollo di sicurezza predefinito del sistema.

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

Viene chiamato dai client per avviare un'operazione asincrona di autenticazione del server e, facoltativamente, del client, utilizzando i certificati e il protocollo di sicurezza specificati.

Commenti

Gli overload di questo metodo non bloccano mentre è in corso l'autenticazione. Per bloccare l'attesa del completamento dell'autenticazione, usare uno dei AuthenticateAsClient metodi .

BeginAuthenticateAsClient(String, AsyncCallback, Object)

Origine:
SslStream.cs
Origine:
SslStream.cs
Origine:
SslStream.cs

Viene chiamato dai client per avviare un'operazione asincrona di autenticazione del server e, facoltativamente, del client.

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

Parametri

targetHost
String

Nome del server che condivide questo oggetto SslStream.

asyncCallback
AsyncCallback

Delegato AsyncCallback che fa riferimento al metodo da richiamare al completamento dell'autenticazione.

asyncState
Object

Oggetto definito dall'utente che contiene informazioni sull'operazione. Questo oggetto viene passato al delegato asyncCallback al completamento dell'operazione.

Restituisce

Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.

Eccezioni

targetHost è null.

L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.

L'autenticazione è già stata effettuata.

-oppure-

L'autenticazione del server con la classe SslStream è stata già tentata.

-oppure-

L'autenticazione è già in corso.

L'oggetto è stato chiuso.

Commenti

A partire da .NET Framework 4.7 questo metodo esegue l'autenticazione con None, che consente al sistema operativo di scegliere il protocollo ottimale da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le ultime patch di sicurezza installate), le versioni dei protocolli TLS/SSL consentite sono 1.0, 1.1 e 1.2 (a meno che non si disabiliti la crittografia avanzata, modificando il Registro di sistema Windows). Nessun certificato client viene usato nell'autenticazione. L'elenco di revoche di certificati non viene controllato durante l'autenticazione.

Il valore specificato per targetHost deve corrispondere al nome nel certificato del server.

L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsClient metodo . In genere, il metodo viene richiamato dal asyncCallback delegato.

Questo metodo non blocca al termine dell'operazione. Per bloccare fino al completamento dell'operazione, usare uno degli overload del AuthenticateAsClient metodo.

Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni

Se si riceve un AuthenticationExceptionoggetto , non SslStream è più utilizzabile. È necessario chiudere questo oggetto e rimuovere tutti i riferimenti ad esso in modo che possa essere raccolto dal Garbage Collector.

Si applica a

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

Origine:
SslStream.cs
Origine:
SslStream.cs
Origine:
SslStream.cs

Chiamato dai client per avviare un'operazione asincrona per autenticare il server e, facoltativamente, il client usando i certificati specificati e il protocollo di sicurezza predefinito del sistema.

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

Parametri

targetHost
String

Nome del server che condivide questo oggetto SslStream.

clientCertificates
X509CertificateCollection

Oggetto X509CertificateCollection che contiene i certificati client.

checkCertificateRevocation
Boolean

Valore di Boolean che specifica se durante l'autenticazione viene controllato l'elenco di revoche di certificati.

asyncCallback
AsyncCallback

Delegato AsyncCallback che fa riferimento al metodo da richiamare al completamento dell'autenticazione.

asyncState
Object

Oggetto definito dall'utente che contiene informazioni sull'operazione. Questo oggetto viene passato al delegato asyncCallback al completamento dell'operazione.

Restituisce

Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.

Eccezioni

targetHost è null.

L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.

L'autenticazione è già stata effettuata.

-oppure-

L'autenticazione del server con la classe SslStream è stata già tentata.

-oppure-

L'autenticazione è già in corso.

L'oggetto è stato chiuso.

Commenti

A partire da .NET Framework 4.7 questo metodo esegue l'autenticazione con None, che consente al sistema operativo di scegliere il protocollo ottimale da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le ultime patch di sicurezza installate), le versioni dei protocolli TLS/SSL consentite sono 1.0, 1.1 e 1.2 (a meno che non si disabiliti la crittografia avanzata, modificando il Registro di sistema Windows).

Il valore specificato per targetHost deve corrispondere al nome nel certificato del server.

L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsClient metodo . In genere, il metodo viene richiamato dal asyncCallback delegato.

Questo metodo non blocca al termine dell'operazione. Per bloccare fino al completamento dell'operazione, usare uno degli overload del AuthenticateAsClient metodo.

Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni

Se si riceve un AuthenticationExceptionoggetto , non SslStream è più utilizzabile. È necessario chiudere questo oggetto e rimuovere tutti i riferimenti ad esso in modo che possa essere raccolto dal Garbage Collector.

Nota

I certificati client non sono supportati nel protocollo SSL versione 2.

Si applica a

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

Origine:
SslStream.cs
Origine:
SslStream.cs
Origine:
SslStream.cs

Viene chiamato dai client per avviare un'operazione asincrona di autenticazione del server e, facoltativamente, del client, utilizzando i certificati e il protocollo di sicurezza specificati.

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

Parametri

targetHost
String

Nome del server che condivide questo oggetto SslStream.

clientCertificates
X509CertificateCollection

Oggetto X509CertificateCollection che contiene i certificati client.

enabledSslProtocols
SslProtocols

Valore SslProtocols che rappresenta i protocolli usato per l'autenticazione.

checkCertificateRevocation
Boolean

Valore di Boolean che specifica se durante l'autenticazione viene controllato l'elenco di revoche di certificati.

asyncCallback
AsyncCallback

Delegato AsyncCallback che fa riferimento al metodo da richiamare al completamento dell'autenticazione.

asyncState
Object

Oggetto definito dall'utente che contiene informazioni sull'operazione. Questo oggetto viene passato al delegato asyncCallback al completamento dell'operazione.

Restituisce

Oggetto IAsyncResult che indica lo stato dell'operazione asincrona.

Eccezioni

targetHost è null.

enabledSslProtocols non è un valore valido di SslProtocols.

L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.

L'autenticazione è già stata effettuata.

-oppure-

L'autenticazione del server con la classe SslStream è stata già tentata.

-oppure-

L'autenticazione è già in corso.

L'oggetto è stato chiuso.

Commenti

A partire da .NET Framework 4.7 questo metodo esegue l'autenticazione con None, che consente al sistema operativo di scegliere il protocollo ottimale da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le ultime patch di sicurezza installate), le versioni dei protocolli TLS/SSL consentite sono 1.0, 1.1 e 1.2 (a meno che non si disabiliti la crittografia avanzata, modificando il Registro di sistema Windows).

Il valore specificato per targetHost deve corrispondere al nome nel certificato del server.

L'operazione di autenticazione asincrona deve essere completata chiamando il EndAuthenticateAsClient metodo . In genere, il metodo viene richiamato dal asyncCallback delegato.

Questo metodo non blocca al termine dell'operazione. Per bloccare fino al completamento dell'operazione, usare uno degli overload del AuthenticateAsClient metodo.

Per informazioni dettagliate sull'uso del modello di programmazione asincrona, vedere Chiamata asincrona di metodi sincroni

Se si riceve un AuthenticationExceptionoggetto , non SslStream è più utilizzabile. È necessario chiudere questo oggetto e rimuovere tutti i riferimenti ad esso in modo che possa essere raccolto dal Garbage Collector.

Nota

I certificati client non sono supportati nel protocollo SSL versione 2.

Si applica a