SslStream.AuthenticateAsClient Metod

Definition

Namnområde:
System.Net.Security
Sammansättningar:
netstandard.dll, System.Net.Security.dll
Sammansättning:
System.Net.Security.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Autentisera klientsidan för en klient-server-anslutning.

Överlagringar

Name Description
AuthenticateAsClient(SslClientAuthenticationOptions)

Autentiserar servern och eventuellt klienten i en klient-server-anslutning.
AuthenticateAsClient(String)

Anropas av klienter för att autentisera servern och eventuellt klienten i en klient-server-anslutning.
AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Anropas av klienter för att autentisera servern och eventuellt klienten i en klient-server-anslutning. Autentiseringsprocessen använder den angivna certifikatsamlingen och systemets standard-SSL-protokoll.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Anropas av klienter för att autentisera servern och eventuellt klienten i en klient-server-anslutning. Autentiseringsprocessen använder den angivna certifikatsamlingen och SSL-protokollet.

AuthenticateAsClient(SslClientAuthenticationOptions)

Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs

Autentiserar servern och eventuellt klienten i en klient-server-anslutning.

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)

Parametrar

sslClientAuthenticationOptions
SslClientAuthenticationOptions

Egenskapsväskan för SSL-anslutningen.

Undantag

ArgumentNullException

sslClientAuthenticationOptions är null.

AuthenticationException

Autentiseringen misslyckades och lämnade objektet i ett oanvändbart tillstånd.

InvalidOperationException

Autentiseringen har redan inträffat.

-eller-

Serverautentisering med detta SslStream försöktes tidigare.

-eller-

Autentisering pågår redan.

ObjectDisposedException

Det här objektet har stängts.

Kommentarer

Från och med .NET Framework 4.7 autentiserar den här metoden med None, vilket gör att operativsystemet kan välja det bästa protokollet att använda och blockera protokoll som inte är säkra. I .NET Framework 4.6 (och .NET Framework 4.5 med de senaste säkerhetskorrigeringarna installerade) är de tillåtna TLS/SSL-protokollversionerna 1.2, 1.1 och 1.0 (om du inte inaktiverar stark kryptografi genom att redigera Windows Registry). Inga klientcertifikat används i autentiseringen. Listan över återkallade certifikat kontrolleras inte under autentiseringen. Värdet som anges för targetHost måste matcha namnet på serverns certifikat.

När autentiseringen IsEncrypted lyckas måste du kontrollera egenskaperna och IsSigned för att avgöra vilka säkerhetstjänster som används av SslStream. Kontrollera egenskapen IsMutuallyAuthenticated för att avgöra om ömsesidig autentisering har inträffat.

Om autentiseringen misslyckas får du en AuthenticationException, och den SslStream kan inte längre användas. Du bör stänga det här objektet och ta bort alla referenser till det så att det kan samlas in av skräpinsamlaren.

Gäller för

AuthenticateAsClient(String)

Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs

Anropas av klienter för att autentisera servern och eventuellt klienten i en klient-server-anslutning.

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)

Parametrar

targetHost
String

Namnet på servern som delar den här SslStream.

Undantag

ArgumentNullException

targetHost är null.

AuthenticationException

Autentiseringen misslyckades och lämnade objektet i ett oanvändbart tillstånd.

InvalidOperationException

Autentiseringen har redan inträffat.

-eller-

Serverautentisering med detta SslStream försöktes tidigare.

-eller-

Autentisering pågår redan.

ObjectDisposedException

Det här objektet har stängts.

Kommentarer

Från och med .NET Framework 4.7 autentiserar den här metoden med None, vilket gör att operativsystemet kan välja det bästa protokollet att använda och blockera protokoll som inte är säkra. I .NET Framework 4.6 (och .NET Framework 4.5 med de senaste säkerhetskorrigeringarna installerade) är de tillåtna TLS/SSL-protokollversionerna 1.2, 1.1 och 1.0 (om du inte inaktiverar stark kryptografi genom att redigera Windows Registry). Inga klientcertifikat används i autentiseringen. Listan över återkallade certifikat kontrolleras inte under autentiseringen. Värdet som anges för targetHost måste matcha namnet på serverns certifikat.

När autentiseringen IsEncrypted lyckas måste du kontrollera egenskaperna och IsSigned för att avgöra vilka säkerhetstjänster som används av SslStream. Kontrollera egenskapen IsMutuallyAuthenticated för att avgöra om ömsesidig autentisering har inträffat.

Om autentiseringen misslyckas får du en AuthenticationException, och den SslStream kan inte längre användas. Du bör stänga det här objektet och ta bort alla referenser till det så att det kan samlas in av skräpinsamlaren.

Gäller för

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs

Anropas av klienter för att autentisera servern och eventuellt klienten i en klient-server-anslutning. Autentiseringsprocessen använder den angivna certifikatsamlingen och systemets standard-SSL-protokoll.

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)

Parametrar

targetHost
String

Namnet på den server som ska dela den här SslStream.

clientCertificates
X509CertificateCollection

Som X509CertificateCollection innehåller klientcertifikat.

checkCertificateRevocation
Boolean

Ett Boolean värde som anger om listan över återkallade certifikat kontrolleras under autentiseringen.

Kommentarer

Från och med .NET Framework 4.7 autentiserar den här metoden med None, vilket gör att operativsystemet kan välja det bästa protokollet att använda och blockera protokoll som inte är säkra. I .NET Framework 4.6 (och .NET Framework 4.5 med de senaste säkerhetskorrigeringarna installerade) är de tillåtna TLS/SSL-protokollversionerna 1.2, 1.1 och 1.0 (om du inte inaktiverar stark kryptografi genom att redigera Windows Registry).

När autentiseringen IsEncrypted lyckas måste du kontrollera egenskaperna och IsSigned för att avgöra vilka säkerhetstjänster som används av SslStream. Kontrollera egenskapen IsMutuallyAuthenticated för att avgöra om ömsesidig autentisering har inträffat.

Om autentiseringen misslyckas får du en AuthenticationException, och den SslStream kan inte längre användas. Du bör stänga det här objektet och ta bort alla referenser till det så att det kan samlas in av skräpinsamlaren.

Note

Klientcertifikat stöds inte i SSL version 2-protokollet.

Gäller för

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs
Källa:
SslStream.cs

Anropas av klienter för att autentisera servern och eventuellt klienten i en klient-server-anslutning. Autentiseringsprocessen använder den angivna certifikatsamlingen och SSL-protokollet.

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)

Parametrar

targetHost
String

Namnet på den server som ska dela den här SslStream.

clientCertificates
X509CertificateCollection

Som X509CertificateCollection innehåller klientcertifikat.

enabledSslProtocols
SslProtocols

Värdet SslProtocols som representerar protokoll som används för autentisering.

checkCertificateRevocation
Boolean

Ett Boolean värde som anger om listan över återkallade certifikat kontrolleras under autentiseringen.

Kommentarer

Från och med .NET Framework 4.7 autentiserar den här metoden med None, vilket gör att operativsystemet kan välja det bästa protokollet att använda och blockera protokoll som inte är säkra. I .NET Framework 4.6 (och .NET Framework 4.5 med de senaste säkerhetskorrigeringarna installerade) är de tillåtna TLS/SSL-protokollversionerna 1.2, 1.1 och 1.0 (om du inte inaktiverar stark kryptografi genom att redigera Windows Registry).

När autentiseringen IsEncrypted lyckas måste du kontrollera egenskaperna och IsSigned för att avgöra vilka säkerhetstjänster som används av SslStream. Kontrollera egenskapen IsMutuallyAuthenticated för att avgöra om ömsesidig autentisering har inträffat.

Om autentiseringen misslyckas får du en AuthenticationException, och den SslStream kan inte längre användas. Du bör stänga det här objektet och ta bort alla referenser till det så att det kan samlas in av skräpinsamlaren.

Note

Klientcertifikat stöds inte i SSL version 2-protokollet.

Gäller för