SslStream.AuthenticateAsClientAsync Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Hitelesítse az ügyfél-kiszolgáló kapcsolat ügyféloldalát aszinkron műveletként.
Túlterhelések
| Name | Description |
|---|---|
| AuthenticateAsClientAsync(String) |
Az ügyfelek meghívták a kiszolgáló hitelesítésére, és opcionálisan az ügyfél-kiszolgáló kapcsolatban lévő ügyfelet aszinkron műveletként. |
| AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken) |
Az ügyfelek meghívták a kiszolgáló hitelesítésére, és opcionálisan az ügyfél-kiszolgáló kapcsolatban lévő ügyfelet aszinkron műveletként. A hitelesítési folyamat a |
| AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean) |
Az ügyfelek meghívták a kiszolgáló hitelesítésére, és opcionálisan az ügyfél-kiszolgáló kapcsolatban lévő ügyfelet aszinkron műveletként. A hitelesítési folyamat a megadott tanúsítványgyűjteményt és a rendszer alapértelmezett SSL protokollját használja. |
| AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean) |
Az ügyfelek meghívták a kiszolgáló hitelesítésére, és opcionálisan az ügyfél-kiszolgáló kapcsolatban lévő ügyfelet aszinkron műveletként. A hitelesítési folyamat a megadott tanúsítványgyűjteményt és SSL-protokollt használja. |
AuthenticateAsClientAsync(String)
Az ügyfelek meghívták a kiszolgáló hitelesítésére, és opcionálisan az ügyfél-kiszolgáló kapcsolatban lévő ügyfelet aszinkron műveletként.
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.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String) As TaskParaméterek
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
targetHost az null.
A hitelesítés sikertelen volt, és ezt az objektumot használhatatlan állapotban hagyta.
A hitelesítés már megtörtént.
-vagy-
Az ezzel SslStream a kiszolgálóhitelesítéssel korábban próbálkoztak.
-vagy-
A hitelesítés már folyamatban van.
Ezt az objektumot bezárták.
Megjegyzések
A .NET Framework 4.7-től kezdve ez a módszer a None használatával hitelesít, így az operációs rendszer kiválaszthatja a legjobban használható protokollt, és letilthatja a nem biztonságos protokollokat. A .NET Framework 4.6 -ban (és .NET Framework 4.5-ben a legújabb biztonsági javítások telepítve vannak), az engedélyezett TLS/SSL protokollok verziója az 1.2, 1.1 és 1.0 (hacsak nem tiltja le az erős titkosítást a Windows beállításjegyzékének szerkesztésével). A hitelesítés nem használ ügyféltanúsítványokat. A rendszer nem ellenőrzi a visszavont tanúsítványok listáját a hitelesítés során. A megadott értéknek targetHost meg kell egyeznie a kiszolgáló tanúsítványában szereplő névvel.
Ha a hitelesítés sikeres, ellenőriznie kell a IsEncrypted tulajdonságokat, és IsSigned meg kell állapítania, hogy a rendszer milyen biztonsági szolgáltatásokat használ SslStream. Ellenőrizze a IsMutuallyAuthenticated tulajdonságot annak megállapításához, hogy történt-e kölcsönös hitelesítés.
Ha a hitelesítés sikertelen, kap egy AuthenticationException, és ez SslStream már nem használható. Zárja be ezt az objektumot, és távolítsa el az összes rá mutató hivatkozást, hogy a szemétgyűjtő összegyűjthesse.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által AuthenticateAsClient(String)kiadott kivételeket: .
A következőre érvényes:
AuthenticateAsClientAsync(SslClientAuthenticationOptions, CancellationToken)
Az ügyfelek meghívták a kiszolgáló hitelesítésére, és opcionálisan az ügyfél-kiszolgáló kapcsolatban lévő ügyfelet aszinkron műveletként. A hitelesítési folyamat a sslClientAuthenticationOptions tulajdonságcsomagban megadott adatokat használja.
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);member this.AuthenticateAsClientAsync : System.Net.Security.SslClientAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function AuthenticateAsClientAsync (sslClientAuthenticationOptions As SslClientAuthenticationOptions, cancellationToken As CancellationToken) As TaskParaméterek
- sslClientAuthenticationOptions
- SslClientAuthenticationOptions
Az SSL-kapcsolat tulajdonságtáskáját.
- cancellationToken
- CancellationToken
A lemondási kérelmek figyelésére szolgáló jogkivonat.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
sslClientAuthenticationOptions az null.
A hitelesítés sikertelen volt, és ezt az objektumot használhatatlan állapotban hagyta.
A hitelesítés már megtörtént.
-vagy-
Az ezzel SslStream a kiszolgálóhitelesítéssel korábban próbálkoztak.
-vagy-
A hitelesítés már folyamatban van.
Ezt az objektumot bezárták.
A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.
Megjegyzések
Ha a hitelesítés sikeres, ellenőriznie kell a IsEncrypted tulajdonságokat, és IsSigned meg kell állapítania, hogy a rendszer milyen biztonsági szolgáltatásokat használ SslStream. Ellenőrizze a IsMutuallyAuthenticated tulajdonságot annak megállapításához, hogy történt-e kölcsönös hitelesítés.
Ha a hitelesítés sikertelen, kap egy AuthenticationException, és ez SslStream már nem használható. Zárja be ezt az objektumot, és távolítsa el az összes rá mutató hivatkozást, hogy a szemétgyűjtő összegyűjthesse.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által AuthenticateAsClient(SslClientAuthenticationOptions)kiadott kivételeket: .
A következőre érvényes:
AuthenticateAsClientAsync(String, X509CertificateCollection, Boolean)
Az ügyfelek meghívták a kiszolgáló hitelesítésére, és opcionálisan az ügyfél-kiszolgáló kapcsolatban lévő ügyfelet aszinkron műveletként. A hitelesítési folyamat a megadott tanúsítványgyűjteményt és a rendszer alapértelmezett SSL protokollját használja.
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);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.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean) As TaskParaméterek
- clientCertificates
- X509CertificateCollection
Az X509CertificateCollection ügyféltanúsítványokat tartalmazó.
- checkCertificateRevocation
- Boolean
Egy Boolean érték, amely meghatározza, hogy a rendszer ellenőrzi-e a visszavont tanúsítványok listáját a hitelesítés során.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
A hitelesítés sikertelen volt, és ezt az objektumot használhatatlan állapotban hagyta.
A hitelesítés már megtörtént.
-vagy-
Az ezzel SslStream a kiszolgálóhitelesítéssel korábban próbálkoztak.
-vagy-
A hitelesítés már folyamatban van.
Ezt az objektumot bezárták.
Megjegyzések
A .NET Framework 4.7-től kezdve ez a módszer a None használatával hitelesít, így az operációs rendszer kiválaszthatja a legjobban használható protokollt, és letilthatja a nem biztonságos protokollokat. A .NET Framework 4.6 -ban (és .NET Framework 4.5-ben a legújabb biztonsági javítások telepítve vannak), az engedélyezett TLS/SSL protokollok verziója az 1.2, 1.1 és 1.0 (hacsak nem tiltja le az erős titkosítást a Windows beállításjegyzékének szerkesztésével).
Ha a hitelesítés sikeres, ellenőriznie kell a IsEncrypted tulajdonságokat, és IsSigned meg kell állapítania, hogy a rendszer milyen biztonsági szolgáltatásokat használ SslStream. Ellenőrizze a IsMutuallyAuthenticated tulajdonságot annak megállapításához, hogy történt-e kölcsönös hitelesítés.
Ha a hitelesítés sikertelen, kap egy AuthenticationException, és ez SslStream már nem használható. Zárja be ezt az objektumot, és távolítsa el az összes rá mutató hivatkozást, hogy a szemétgyűjtő összegyűjthesse.
Note
Az SSL 2-es verziójának protokollja nem támogatja az ügyféltanúsítványokat.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által AuthenticateAsClient(String, X509CertificateCollection, Boolean)kiadott kivételeket: .
A következőre érvényes:
AuthenticateAsClientAsync(String, X509CertificateCollection, SslProtocols, Boolean)
Az ügyfelek meghívták a kiszolgáló hitelesítésére, és opcionálisan az ügyfél-kiszolgáló kapcsolatban lévő ügyfelet aszinkron műveletként. A hitelesítési folyamat a megadott tanúsítványgyűjteményt és SSL-protokollt használja.
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);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.TaskPublic Overridable Function AuthenticateAsClientAsync (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As TaskParaméterek
- clientCertificates
- X509CertificateCollection
Az X509CertificateCollection ügyféltanúsítványokat tartalmazó.
- enabledSslProtocols
- SslProtocols
A SslProtocols hitelesítéshez használt protokollokat képviselő érték.
- checkCertificateRevocation
- Boolean
Egy Boolean érték, amely meghatározza, hogy a rendszer ellenőrzi-e a visszavont tanúsítványok listáját a hitelesítés során.
Válaszok
Az aszinkron műveletet képviselő tevékenységobjektum.
Kivételek
A hitelesítés sikertelen volt, és ezt az objektumot használhatatlan állapotban hagyta.
A hitelesítés már megtörtént.
-vagy-
Az ezzel SslStream a kiszolgálóhitelesítéssel korábban próbálkoztak.
-vagy-
A hitelesítés már folyamatban van.
Ezt az objektumot bezárták.
Megjegyzések
A .NET Framework 4.7-től kezdve ez a módszer a None használatával hitelesít, így az operációs rendszer kiválaszthatja a legjobban használható protokollt, és letilthatja a nem biztonságos protokollokat. A .NET Framework 4.6 -ban (és .NET Framework 4.5-ben a legújabb biztonsági javítások telepítve vannak), az engedélyezett TLS/SSL protokollok verziója az 1.2, 1.1 és 1.0 (hacsak nem tiltja le az erős titkosítást a Windows beállításjegyzékének szerkesztésével).
Ha a hitelesítés sikeres, ellenőriznie kell a IsEncrypted tulajdonságokat, és IsSigned meg kell állapítania, hogy a rendszer milyen biztonsági szolgáltatásokat használ SslStream. Ellenőrizze a IsMutuallyAuthenticated tulajdonságot annak megállapításához, hogy történt-e kölcsönös hitelesítés.
Ha a hitelesítés sikertelen, kap egy AuthenticationException, és ez SslStream már nem használható. Zárja be ezt az objektumot, és távolítsa el az összes rá mutató hivatkozást, hogy a szemétgyűjtő összegyűjthesse.
Note
Az SSL 2-es verziójának protokollja nem támogatja az ügyféltanúsítványokat.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)kiadott kivételeket: .