Condividi tramite


SslStream.AuthenticateAsServerAsync Metodo

Definizione

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à sslClientAuthenticationOptions.

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 optionsCallback.

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.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Parametri

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.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As Task

Parametri

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.Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As Task

Parametri

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

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.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As Task

Parametri

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.Task
Public Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametri

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

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.

Si applica a