SslStream.AuthenticateAsClientAsync 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 av en klient-serveranslutning som en asynkron åtgärd.

Överlagringar

Name Description
AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)

Anropas av klienter för att autentisera servern och eventuellt klienten i en klient-server-anslutning som en asynkron åtgärd. Autentiseringsprocessen använder den angivna certifikatsamlingen och SSL-protokollet.
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)

Anropas av klienter för att autentisera servern och eventuellt klienten i en klient-server-anslutning som en asynkron åtgärd. Autentiseringsprocessen använder den angivna certifikatsamlingen och systemets standard-SSL-protokoll.
AuthenticateAsClientAsync(String)

Anropas av klienter för att autentisera servern och eventuellt klienten i en klient-server-anslutning som en asynkron åtgärd.
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

Anropas av klienter för att autentisera servern och eventuellt klienten i en klient-server-anslutning som en asynkron åtgärd. Autentiseringsprocessen använder information som anges i egenskapsväskan sslClientAuthenticationOptions .

AuthenticateAsClientAsync(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 som en asynkron åtgärd. Autentiseringsprocessen använder den angivna certifikatsamlingen och SSL-protokollet.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

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.

Returer

Task

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

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

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.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean).

Gäller för

AuthenticateAsClientAsync(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 som en asynkron åtgärd. Autentiseringsprocessen använder den angivna certifikatsamlingen och systemets standard-SSL-protokoll.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation);
public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation);
public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation);
abstract member AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As Task

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.

Returer

Task

Aktivitetsobjektet som representerar den asynkrona åtgärden.

Undantag

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

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.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av AuthenticateAsClient(String, X509CertificateCollection, Boolean).

Gäller för

AuthenticateAsClientAsync(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 som en asynkron åtgärd.

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::String ^ targetHost);
public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync(string targetHost);
abstract member AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : string -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsClientAsync (targetHost As String) As Task

Parametrar

targetHost
String

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

Returer

Task

Aktivitetsobjektet som representerar den asynkrona åtgärden.

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.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av AuthenticateAsClient(String).

Gäller för

AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)

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 som en asynkron åtgärd. Autentiseringsprocessen använder information som anges i egenskapsväskan sslClientAuthenticationOptions .

public:
 System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task AuthenticateAsClientAsync(System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);
public System.Threading.Tasks.Task AuthenticateAsClientAsync(System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions, System.Threading.CancellationToken cancellationToken);
member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, cancellationToken As CancellationToken) As Task

Parametrar

sslClientAuthenticationOptions
SslClientAuthenticationOptions

Egenskapsväskan för SSL-anslutningen.

cancellationToken
CancellationToken

Token som ska övervakas för annulleringsbegäranden.

Returer

Task

Aktivitetsobjektet som representerar den asynkrona åtgärden.

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.

OperationCanceledException

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

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.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av AuthenticateAsClient(SslClientAuthenticationOptions).

Gäller för