SslStream.AuthenticateAsServer Metodo

Definizione

Spazio dei nomi:

System.Net.Security

Assembly:

System.Net.Security.dll

Viene chiamato dai server per l'autenticazione del server e, facoltativamente, del client, in una connessione client-server.

Overload

AuthenticateAsServer(SslServerAuthenticationOptions)	Viene chiamato dai server per l'autenticazione del server e, facoltativamente, del client, in una connessione client-server che utilizza il certificato specificato.
AuthenticateAsServer(X509Certificate)	Viene chiamato dai server per l'autenticazione del server e, facoltativamente, del client, in una connessione client-server che utilizza il certificato specificato.
AuthenticateAsServer(X509Certificate, Boolean, Boolean)	Chiamato dai server per autenticare il server e, facoltativamente, il client in una connessione client-server usando i certificati e i requisiti specificati nonché il protocollo di sicurezza predefinito del sistema.
AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)	Chiamato dai server per autenticare il server ed eventualmente il client in una connessione client-server usando i certificati, i requisiti e il protocollo di sicurezza specificati.

AuthenticateAsServer(SslServerAuthenticationOptions)

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.

public:
 void AuthenticateAsServer(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions);

public void AuthenticateAsServer (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions);

member this.AuthenticateAsServer : System.Net.Security.SslServerAuthenticationOptions -> unit

Public Sub AuthenticateAsServer (sslServerAuthenticationOptions As SslServerAuthenticationOptions)

Parametri

sslServerAuthenticationOptions

SslServerAuthenticationOptions

Contenitore delle proprietà per la connessione SSL.

Eccezioni

ArgumentNullException

serverCertificate è null.

AuthenticationException

L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.

InvalidOperationException

L'autenticazione è già stata effettuata.

-oppure-

L'autenticazione del client con la classe SslStream è stata già tentata.

-oppure-

L'autenticazione è già in corso.

ObjectDisposedException

L'oggetto è stato chiuso.

PlatformNotSupportedException

Il metodo AuthenticateAsServer 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). L'elenco di revoche di certificati non viene controllato durante l'autenticazione. Il client non è necessario per fornire un certificato per l'autenticazione.

Questo metodo blocca fino al completamento dell'operazione. Per impedire il blocco fino al completamento dell'operazione, usare uno degli overload del BeginAuthenticateAsServer metodo.

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.

AuthenticateAsServer(X509Certificate)

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.

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate)

Parametri

serverCertificate

X509Certificate

Certificato utilizzato per autenticare il server.

Eccezioni

ArgumentNullException

serverCertificate è null.

AuthenticationException

L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.

InvalidOperationException

L'autenticazione è già stata effettuata.

-oppure-

L'autenticazione del client con la classe SslStream è stata già tentata.

-oppure-

L'autenticazione è già in corso.

ObjectDisposedException

L'oggetto è stato chiuso.

PlatformNotSupportedException

Il metodo AuthenticateAsServer 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). L'elenco di revoche di certificati non viene controllato durante l'autenticazione. Il client non è necessario per fornire un certificato per l'autenticazione.

Questo metodo blocca fino al completamento dell'operazione. Per impedire il blocco fino al completamento dell'operazione, usare uno degli overload del BeginAuthenticateAsServer metodo.

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.

AuthenticateAsServer(X509Certificate, Boolean, Boolean)

Origine:

SslStream.cs

Chiamato dai server per autenticare il server e, facoltativamente, il client in una connessione client-server usando i certificati e i requisiti specificati nonché il protocollo di sicurezza predefinito del sistema.

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean)

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.

Eccezioni

ArgumentNullException

serverCertificate è null.

AuthenticationException

L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.

InvalidOperationException

L'autenticazione è già stata effettuata.

-oppure-

L'autenticazione del client con la classe SslStream è stata già tentata.

-oppure-

L'autenticazione è già in corso.

ObjectDisposedException

L'oggetto è stato chiuso.

PlatformNotSupportedException

Il metodo AuthenticateAsServer 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 blocca fino al completamento dell'operazione. Per impedire il blocco fino al completamento dell'operazione, usare uno degli overload del BeginAuthenticateAsServer metodo.

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.

AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)

Origine:

SslStream.cs

Chiamato dai server per autenticare il server ed eventualmente il client in una connessione client-server usando i certificati, i requisiti e il protocollo di sicurezza specificati.

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

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.

Eccezioni

ArgumentNullException

serverCertificate è null.

ArgumentException

enabledSslProtocols non è un valore valido di SslProtocols.

AuthenticationException

L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.

InvalidOperationException

L'autenticazione è già stata effettuata.

-oppure-

L'autenticazione del client con la classe SslStream è stata già tentata.

-oppure-

L'autenticazione è già in corso.

ObjectDisposedException

L'oggetto è stato chiuso.

PlatformNotSupportedException

Il metodo AuthenticateAsServer 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 blocca fino al completamento dell'operazione. Per impedire il blocco fino al completamento dell'operazione, usare uno degli overload del BeginAuthenticateAsServer metodo.

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.