SslStream.AuthenticateAsClient 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.
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
- Origine:
- SslStream.cs
- 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 -> unitPublic Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)Parametri
- sslClientAuthenticationOptions
- SslClientAuthenticationOptions
Contenitore delle proprietà per la connessione SSL.
Eccezioni
targetHost è null.
L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.
L'autenticazione è già stata effettuata.
-oppure-
L'autenticazione del server 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). 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.
Si applica a
AuthenticateAsClient(String)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- 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 -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String)Parametri
Eccezioni
targetHost è null.
L'autenticazione ha avuto esito negativo, rendendo l'oggetto inutilizzabile.
L'autenticazione è già stata effettuata.
-oppure-
L'autenticazione del server 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). 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.
Si applica a
AuthenticateAsClient(String, X509CertificateCollection, Boolean)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- 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);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 -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)Parametri
- 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.
Si applica a
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- 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);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 -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)Parametri
- 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.
