SslStream.AuthenticateAsClientAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Autentica il lato client di una connessione client-server come operazione asincrona.
Overload
| AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean) |
Chiamato dai client per autenticare il server e, facoltativamente, il client in una connessione client-server come operazione asincrona. Nel processo di autenticazione vengono utilizzati l'insieme di certificati specificato e il protocollo SSL. |
| 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 di 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 proprietà |
AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
Chiamato dai client per autenticare il server e, facoltativamente, il client in una connessione client-server come operazione asincrona. Nel processo di autenticazione vengono utilizzati l'insieme di certificati specificato e il protocollo 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.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParametri
- 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.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
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).
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 AuthenticationExceptionoggetto e 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.
Questo metodo archivia nell'attività 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).
Si applica a
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- 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 di 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);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.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As TaskParametri
- 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.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
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).
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 AuthenticationExceptionoggetto e 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.
Questo metodo archivia nell'attività 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).
Si applica a
AuthenticateAsClientAsync(String)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- 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.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String) As TaskParametri
Restituisce
Oggetto dell'attività che rappresenta l'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.
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 AuthenticationExceptionoggetto e non SslStream è più utilizzabile. È necessario chiudere questo oggetto e rimuovere tutti i riferimenti ad esso in modo che possa essere raccolto dal Garbage Collector.
Questo metodo archivia nell'attività 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).
Si applica a
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- 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 proprietà sslClientAuthenticationOptions.
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.TaskPublic Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, cancellationToken As CancellationToken) As TaskParametri
- sslClientAuthenticationOptions
- SslClientAuthenticationOptions
Contenitore delle proprietà per la connessione SSL.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
sslClientAuthenticationOptions è 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.
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 proprietà per determinare se si è verificata l'autenticazione IsMutuallyAuthenticated reciproca.
Se l'autenticazione ha esito negativo, viene visualizzato un AuthenticationExceptionoggetto e non SslStream è 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).
