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.
Chiamato dai server per autenticare il server e facoltativamente il client in una connessione client-server come operazione asincrona.
Overload
| Nome | Descrizione |
|---|---|
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Chiamato dai server per autenticare il server e facoltativamente il client in una connessione client-server usando i certificati, i requisiti e il protocollo di sicurezza specificati come operazione asincrona. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Chiamato dai server per autenticare il server e facoltativamente il client in una connessione client-server usando i certificati, i requisiti e il protocollo di sicurezza specificati come operazione asincrona. |
| AuthenticateAsServerAsync(X509Certificate) |
Chiamato dai server per autenticare il server e facoltativamente il client in una connessione client-server usando il certificato specificato come operazione asincrona. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Autentica 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 |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
Chiamato dai server per autenticare il server e facoltativamente il client in una connessione client-server usando i certificati, i requisiti e il protocollo di sicurezza specificati 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
X509Certificate utilizzato per autenticare il server.
- clientCertificateRequired
- Boolean
Valore Boolean che specifica se al client viene richiesto un certificato per l'autenticazione. Si noti che si tratta solo di una richiesta: se non viene fornito alcun certificato, il server accetta comunque la richiesta di connessione.
- 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.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
serverCertificate è null.
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione client con questa operazione SslStream è stata tentata in precedenza.
oppure
L'autenticazione è già in corso.
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).
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 AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
Si applica a
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
Chiamato dai server per autenticare il server e facoltativamente il client in una connessione client-server usando i certificati, i requisiti e il protocollo di sicurezza specificati 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
X509Certificate utilizzato per autenticare il server.
- clientCertificateRequired
- Boolean
Valore Boolean che specifica se al client viene richiesto un certificato per l'autenticazione. Si noti che si tratta solo di una richiesta: se non viene fornito alcun certificato, il server accetta comunque la richiesta di connessione.
- checkCertificateRevocation
- Boolean
Valore Boolean che specifica se l'elenco di revoche di certificati viene controllato durante l'autenticazione.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
serverCertificate è null.
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione client con questa operazione SslStream è stata tentata in precedenza.
oppure
L'autenticazione è già in corso.
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).
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 AuthenticateAsServer(X509Certificate, Boolean, Boolean).
Si applica a
AuthenticateAsServerAsync(X509Certificate)
Chiamato dai server per autenticare il server e facoltativamente il client in una connessione client-server usando il certificato specificato come 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.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
serverCertificate è null.
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione client con questa operazione SslStream è stata tentata in precedenza.
oppure
L'autenticazione è già in corso.
Questo 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 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).
Questo metodo esegue l'autenticazione tramite 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 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 AuthenticateAsServer(X509Certificate).
Si applica a
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
Autentica 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 sslServerAuthenticationOptions proprietà.
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);member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.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.
Valori restituiti
Oggetto attività che rappresenta l'operazione asincrona.
Eccezioni
Oppure ServerCertificateSelectionCallback o ServerCertificateServerCertificateContext è null e LocalCertificateSelectionCallback non è impostato nel SslStream costruttore.
sslServerAuthenticationOptions è null.
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione client con questa operazione SslStream è stata tentata in precedenza.
oppure
L'autenticazione è già in corso.
Questo 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 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 AuthenticateAsServer(SslServerAuthenticationOptions).