SslStream.AuthenticateAsServerAsync 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.
Viene chiamato dai server per l'autenticazione del server e, facoltativamente, del client, in una connessione client-server come un'operazione asincrona.
Overload
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Chiamato dai server per autenticare il server ed eventualmente il client in una connessione client-server usando i certificati specificati, i requisiti e il protocollo di sicurezza come operazione asincrona. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Chiamato dai server per autenticare il server ed eventualmente il client in una connessione client-server usando i certificati specificati, i requisiti e il protocollo di sicurezza come operazione asincrona. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Viene chiamato dai server per l'autenticazione del server e, facoltativamente, del client, in una connessione client-server come un'operazione asincrona. Il processo di autenticazione usa le informazioni specificate nel contenitore delle proprietà |
| AuthenticateAsServerAsync(X509Certificate) |
Viene chiamato dai server per l'autenticazione del server e, facoltativamente, del client, in una connessione client-server che utilizza il certificato specificato come un'operazione asincrona. |
| AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken) |
Viene chiamato dai server per l'autenticazione del server e, facoltativamente, del client, in una connessione client-server come un'operazione asincrona. Il processo di autenticazione usa le informazioni restituite da |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
Chiamato dai server per autenticare il server ed eventualmente il client in una connessione client-server usando i certificati specificati, i requisiti e il protocollo di sicurezza come operazione asincrona.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParametri
- serverCertificate
- X509Certificate
Certificato X509 usato per autenticare il server.
- clientCertificateRequired
- Boolean
Valore di Boolean che specifica se al client viene richiesto un certificato per l'autenticazione. Trattandosi solo di una richiesta, se non viene fornito alcun certificato, il server accetta ancora la richiesta di connessione.
- 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
serverCertificate è null.
L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.
L'autenticazione è già stata effettuata.
-oppure-
L'autenticazione del client 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).
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 AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
Si applica a
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
Chiamato dai server per autenticare il server ed eventualmente il client in una connessione client-server usando i certificati specificati, i requisiti e il protocollo di sicurezza come operazione asincrona.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As TaskParametri
- serverCertificate
- X509Certificate
Certificato X509 usato per autenticare il server.
- clientCertificateRequired
- Boolean
Valore di Boolean che specifica se al client viene richiesto un certificato per l'autenticazione. Trattandosi solo di una richiesta, se non viene fornito alcun certificato, il server accetta ancora la richiesta di connessione.
- 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
serverCertificate è null.
L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.
L'autenticazione è già stata effettuata.
-oppure-
L'autenticazione del client 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).
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 AuthenticateAsServer(X509Certificate, Boolean, Boolean).
Si applica a
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
Viene chiamato dai server per l'autenticazione del server e, facoltativamente, del client, in una connessione client-server come un'operazione asincrona. Il processo di autenticazione usa le informazioni specificate nel contenitore delle proprietà sslClientAuthenticationOptions.
public:
System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken);member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As TaskParametri
- sslServerAuthenticationOptions
- SslServerAuthenticationOptions
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
ServerCertificateSelectionCallback, ServerCertificate o ServerCertificateContext è null e LocalCertificateSelectionCallback non è impostato nel costruttore SslStream.
sslServerAuthenticationOptions è null.
L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.
L'autenticazione è già stata effettuata.
-oppure-
L'autenticazione del client 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
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 AuthenticateAsServer(SslServerAuthenticationOptions).
Si applica a
AuthenticateAsServerAsync(X509Certificate)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
Viene chiamato dai server per l'autenticazione del server e, facoltativamente, del client, in una connessione client-server che utilizza il certificato specificato come un'operazione asincrona.
public:
virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.TaskPublic Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As TaskParametri
- serverCertificate
- X509Certificate
Certificato utilizzato per autenticare il server.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
serverCertificate è null.
L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.
L'autenticazione è già stata effettuata.
-oppure-
L'autenticazione del client con la classe SslStream è stata già tentata.
-oppure-
L'autenticazione è già in corso.
L'oggetto è stato chiuso.
Il metodo AuthenticateAsServerAsync non è supportato in Windows 95, Windows 98 o Windows Millennium.
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).
Questo metodo esegue l'autenticazione usando Default. L'elenco di revoche di certificati non viene controllato durante l'autenticazione. Il client non è necessario per fornire un certificato per l'autenticazione.
Se l'autenticazione non riesce, si riceve 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 AuthenticateAsServer(X509Certificate).
Si applica a
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
Viene chiamato dai server per l'autenticazione del server e, facoltativamente, del client, in una connessione client-server come un'operazione asincrona. Il processo di autenticazione usa le informazioni restituite da optionsCallback.
public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.ServerOptionsSelectionCallback optionsCallback, object? state, System.Threading.CancellationToken cancellationToken = default);member this.AuthenticateAsServerAsync : System.Net.Security.ServerOptionsSelectionCallback * obj * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As TaskParametri
- optionsCallback
- ServerOptionsSelectionCallback
Delegato di callback.
- state
- Object
L'oggetto stato da passare a optionsCallback quando viene chiamato il callback.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento.
Restituisce
Oggetto dell'attività che rappresenta l'operazione asincrona.
Eccezioni
ServerCertificateSelectionCallback, ServerCertificate o ServerCertificateContext è null e LocalCertificateSelectionCallback non è impostato nel costruttore SslStream.
L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.
L'autenticazione è già stata effettuata.
-oppure-
L'autenticazione del client 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
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.
