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 di una connessione client-server.
Overload
| Nome | Descrizione |
|---|---|
| AuthenticateAsClient(SslClientAuthenticationOptions) |
Autentica 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 del sistema. |
| AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, 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 e il protocollo SSL specificati. |
AuthenticateAsClient(SslClientAuthenticationOptions)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
Autentica 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
sslClientAuthenticationOptions è null.
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione del server che usa 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). Nell'autenticazione non vengono usati certificati client. L'elenco di revoche di certificati non viene controllato durante l'autenticazione. Il valore specificato per targetHost deve corrispondere al nome nel 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 IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.
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.
Si applica a
AuthenticateAsClient(String)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- 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 -> unit
Public Overridable Sub AuthenticateAsClient (targetHost As String)
Parametri
Eccezioni
targetHost è null.
L'autenticazione non è riuscita e ha lasciato l'oggetto in uno stato inutilizzabile.
L'autenticazione è già stata eseguita.
oppure
L'autenticazione del server che usa 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). Nell'autenticazione non vengono usati certificati client. L'elenco di revoche di certificati non viene controllato durante l'autenticazione. Il valore specificato per targetHost deve corrispondere al nome nel 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 IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.
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.
Si applica a
AuthenticateAsClient(String, X509CertificateCollection, Boolean)
- Origine:
- SslStream.cs
- Origine:
- SslStream.cs
- 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 del 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 -> unit
Public 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 Boolean che specifica se l'elenco di revoche di certificati viene controllato durante l'autenticazione.
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).
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 IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.
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.
Annotazioni
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
- 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 e il protocollo SSL specificati.
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 -> unit
Public 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 utilizzati per l'autenticazione.
- checkCertificateRevocation
- Boolean
Valore Boolean che specifica se l'elenco di revoche di certificati viene controllato durante l'autenticazione.
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).
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 IsMutuallyAuthenticated proprietà per determinare se si è verificata l'autenticazione reciproca.
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.
Annotazioni
I certificati client non sono supportati nel protocollo SSL versione 2.