SslStream.AuthenticateAsClientAsync Metodo

Definizione

Spazio dei nomi:

System.Net.Security

Assembly:

netstandard.dll, System.Net.Security.dll

Autenticare il lato client di una connessione client-server come operazione asincrona.

Overload

Nome	Descrizione
AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)	Chiamato dai client per autenticare il server e facoltativamente il client in una connessione client-server come operazione asincrona. Il processo di autenticazione usa la raccolta di certificati e il protocollo SSL specificati.
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)	Chiamato dai client per autenticare il server e facoltativamente il client in una connessione client-server come operazione asincrona. Il processo di autenticazione usa la raccolta di certificati specificata e il protocollo SSL predefinito del sistema.
AuthenticateAsClientAsync(String)	Chiamato dai client per autenticare il server e facoltativamente il client in una connessione client-server come operazione asincrona.
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)	Chiamato dai client per autenticare il server e facoltativamente il client in una connessione client-server come operazione asincrona. Il processo di autenticazione usa le informazioni specificate nel contenitore delle sslClientAuthenticationOptions proprietà.

AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Origine:

SslStream.cs

Chiamato dai client per autenticare il server e facoltativamente il client in una connessione client-server come operazione asincrona. Il processo di autenticazione usa la raccolta di certificati e il protocollo SSL specificati.

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

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

Parametri

targetHost

String

Nome del server che condividerà l'oggetto SslStream.

clientCertificates

X509CertificateCollection

Oggetto X509CertificateCollection che contiene i certificati client.

enabledSslProtocols

SslProtocols

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

checkCertificateRevocation

Boolean

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

Restituisce

Task

Oggetto attività che rappresenta l'operazione asincrona.

Eccezioni

AuthenticationException

L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.

InvalidOperationException

L'autenticazione è già stata eseguita.

oppure

L'autenticazione del server che usa questa operazione SslStream è stata tentata in precedenza.

oppure

L'autenticazione è già in corso.

ObjectDisposedException

Questo 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 migliore da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le patch di sicurezza più recenti installate), le versioni dei protocolli TLS/SSL consentite sono 1.2, 1.1 e 1.0 (a meno che non si disabiliti la crittografia avanzata modificando il Registro di sistema di Windows).

Quando l'autenticazione ha esito positivo, è necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da SslStream. Controllare la IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.

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

Annotazioni

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

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean).

AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Origine:

SslStream.cs

Chiamato dai client per autenticare il server e facoltativamente il client in una connessione client-server come operazione asincrona. Il processo di autenticazione usa la raccolta di certificati specificata e il protocollo SSL predefinito del sistema.

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

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

Parametri

targetHost

String

Nome del server che condividerà l'oggetto SslStream.

clientCertificates

X509CertificateCollection

Oggetto X509CertificateCollection che contiene i certificati client.

checkCertificateRevocation

Boolean

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

Restituisce

Task

Oggetto attività che rappresenta l'operazione asincrona.

Eccezioni

AuthenticationException

L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.

InvalidOperationException

L'autenticazione è già stata eseguita.

oppure

L'autenticazione del server che usa questa operazione SslStream è stata tentata in precedenza.

oppure

L'autenticazione è già in corso.

ObjectDisposedException

Questo 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 migliore da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le patch di sicurezza più recenti installate), le versioni dei protocolli TLS/SSL consentite sono 1.2, 1.1 e 1.0 (a meno che non si disabiliti la crittografia avanzata modificando il Registro di sistema di Windows).

Quando l'autenticazione ha esito positivo, è necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da SslStream. Controllare la IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.

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

Annotazioni

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

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AuthenticateAsClient(String, X509CertificateCollection, Boolean).

AuthenticateAsClientAsync(String)

Origine:

SslStream.cs

Chiamato dai client per autenticare il server e facoltativamente il client in una connessione client-server come operazione asincrona.

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

Parametri

targetHost

String

Nome del server che condivide l'oggetto SslStream.

Restituisce

Task

Oggetto attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

targetHost è null.

AuthenticationException

L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.

InvalidOperationException

L'autenticazione è già stata eseguita.

oppure

L'autenticazione del server che usa questa operazione SslStream è stata tentata in precedenza.

oppure

L'autenticazione è già in corso.

ObjectDisposedException

Questo 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 migliore da usare e di bloccare i protocolli non sicuri. In .NET Framework 4.6 (e .NET Framework 4.5 con le patch di sicurezza più recenti installate), le versioni dei protocolli TLS/SSL consentite sono 1.2, 1.1 e 1.0 (a meno che non si disabiliti la crittografia avanzata modificando il Registro di sistema di Windows). Nell'autenticazione non vengono usati certificati client. 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.

Quando l'autenticazione ha esito positivo, è necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da SslStream. Controllare la IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.

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

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AuthenticateAsClient(String).

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Origine:

SslStream.cs

Chiamato dai client per autenticare il server e facoltativamente il client in una connessione client-server come operazione asincrona. Il processo di autenticazione usa le informazioni specificate nel contenitore delle sslClientAuthenticationOptions proprietà.

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

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

Parametri

sslClientAuthenticationOptions

SslClientAuthenticationOptions

Contenitore delle proprietà per la connessione SSL.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento.

Restituisce

Task

Oggetto attività che rappresenta l'operazione asincrona.

Eccezioni

ArgumentNullException

sslClientAuthenticationOptions è null.

AuthenticationException

L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.

InvalidOperationException

L'autenticazione è già stata eseguita.

oppure

L'autenticazione del server che usa questa operazione SslStream è stata tentata in precedenza.

oppure

L'autenticazione è già in corso.

ObjectDisposedException

Questo oggetto è stato chiuso.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Quando l'autenticazione ha esito positivo, è necessario controllare le IsEncrypted proprietà e IsSigned per determinare quali servizi di sicurezza vengono usati da SslStream. Controllare la IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.

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

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da AuthenticateAsClient(SslClientAuthenticationOptions).