SslStream.AuthenticateAsClient Metodo

Definizione

Spazio dei nomi:

System.Net.Security

Assembly:

System.Net.Security.dll

Autenticare il lato client della connessione client-server.

Overload

AuthenticateAsClient(SslClientAuthenticationOptions)	Chiamato dai client per autenticare il server e, facoltativamente, il client in una connessione client-server.
AuthenticateAsClient(String)	Chiamato dai client per autenticare il server e, facoltativamente, il client in una connessione client-server.
AuthenticateAsClient(String, X509CertificateCollection, Boolean)	Chiamato dai client per autenticare il server e, facoltativamente, il client in una connessione client-server. Il processo di autenticazione usa la raccolta di certificati specificata e il protocollo SSL predefinito di sistema.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)	Chiamato dai client per autenticare il server e, facoltativamente, il client in una connessione client-server. Nel processo di autenticazione vengono utilizzati l'insieme di certificati specificato e il protocollo SSL.

AuthenticateAsClient(SslClientAuthenticationOptions)

Origine:

SslStream.cs

Chiamato dai client per autenticare il server e, facoltativamente, il client in una connessione client-server.

public:
 void AuthenticateAsClient(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions);

public void AuthenticateAsClient (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions);

member this.AuthenticateAsClient : System.Net.Security.SslClientAuthenticationOptions -> unit

Public Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)

Parametri

sslClientAuthenticationOptions

SslClientAuthenticationOptions

Contenitore delle proprietà per la connessione SSL.

Eccezioni

ArgumentNullException

targetHost è null.

AuthenticationException

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

InvalidOperationException

L'autenticazione è già stata effettuata.

-oppure-

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

-oppure-

L'autenticazione è già in corso.

ObjectDisposedException

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). Non vengono usati certificati client nell'autenticazione. L'elenco di revoche di certificati non viene controllato durante l'autenticazione. Il valore specificato per targetHost deve corrispondere al nome del 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 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.

AuthenticateAsClient(String)

Origine:

SslStream.cs

Chiamato dai client per autenticare il server e, facoltativamente, il client in una connessione client-server.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost);

public virtual void AuthenticateAsClient (string targetHost);

abstract member AuthenticateAsClient : string -> unit
override this.AuthenticateAsClient : string -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String)

Parametri

targetHost

String

Nome del server che condivide questo oggetto SslStream.

Eccezioni

ArgumentNullException

targetHost è null.

AuthenticationException

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

InvalidOperationException

L'autenticazione è già stata effettuata.

-oppure-

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

-oppure-

L'autenticazione è già in corso.

ObjectDisposedException

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). Non vengono usati certificati client nell'autenticazione. L'elenco di revoche di certificati non viene controllato durante l'autenticazione. Il valore specificato per targetHost deve corrispondere al nome del 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 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.

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Origine:

SslStream.cs

Chiamato dai client per autenticare il server e, facoltativamente, il client in una connessione client-server. Il processo di autenticazione usa la raccolta di certificati specificata e il protocollo SSL predefinito di sistema.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)

Parametri

targetHost

String

Nome del server che condividerà questo oggetto SslStream.

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.

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

Nota

I certificati client non sono supportati nel protocollo SSL versione 2.

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Origine:

SslStream.cs

Chiamato dai client per autenticare il server e, facoltativamente, il client in una connessione client-server. Nel processo di autenticazione vengono utilizzati l'insieme di certificati specificato e il protocollo SSL.

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsClient (string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

Parametri

targetHost

String

Nome del server che condividerà questo oggetto SslStream.

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.

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

Nota

I certificati client non sono supportati nel protocollo SSL versione 2.