SslStream.AuthenticateAsClient Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Uwierzytelnianie po stronie klienta połączenia klient-serwer.
Przeciążenia
| AuthenticateAsClient(SslClientAuthenticationOptions) |
Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer. |
| AuthenticateAsClient(String) |
Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer. |
| AuthenticateAsClient(String, X509CertificateCollection, Boolean) |
Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer. Proces uwierzytelniania używa określonej kolekcji certyfikatów i domyślnego protokołu SSL systemu. |
| AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean) |
Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer. W procesie uwierzytelniania jest używana określona kolekcja certyfikatów i protokół SSL. |
AuthenticateAsClient(SslClientAuthenticationOptions)
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer.
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)Parametry
- sslClientAuthenticationOptions
- SslClientAuthenticationOptions
Torba właściwości dla połączenia SSL.
Wyjątki
targetHost to null.
Uwierzytelnianie nie powiodło się i pozostawiono ten obiekt w stanie bezużytecznym.
Uwierzytelnianie już wystąpiło.
-lub-
Wcześniej próbowano użyć uwierzytelniania SslStream serwera.
-lub-
Uwierzytelnianie jest już w toku.
Ten obiekt został zamknięty.
Uwagi
Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń), dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączysz silną kryptografię przez edytowanie rejestru systemu Windows). W uwierzytelnianiu nie są używane żadne certyfikaty klienta. Lista odwołania certyfikatów nie jest sprawdzana podczas uwierzytelniania. Wartość określona dla targetHost musi być zgodna z nazwą certyfikatu serwera.
Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę SslStream. Sprawdź właściwość , IsMutuallyAuthenticated aby określić, czy wystąpiło wzajemne uwierzytelnianie.
Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony komunikat AuthenticationException, który SslStream nie jest już możliwy do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było go zebrać przez moduł odśmiecający pamięci.
Dotyczy
AuthenticateAsClient(String)
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer.
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)Parametry
Wyjątki
targetHost to null.
Uwierzytelnianie nie powiodło się i pozostawiono ten obiekt w stanie bezużytecznym.
Uwierzytelnianie już wystąpiło.
-lub-
Wcześniej próbowano użyć uwierzytelniania SslStream serwera.
-lub-
Uwierzytelnianie jest już w toku.
Ten obiekt został zamknięty.
Uwagi
Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń), dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączysz silną kryptografię przez edytowanie rejestru systemu Windows). W uwierzytelnianiu nie są używane żadne certyfikaty klienta. Lista odwołania certyfikatów nie jest sprawdzana podczas uwierzytelniania. Wartość określona dla targetHost musi być zgodna z nazwą certyfikatu serwera.
Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę SslStream. Sprawdź właściwość , IsMutuallyAuthenticated aby określić, czy wystąpiło wzajemne uwierzytelnianie.
Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony komunikat AuthenticationException, który SslStream nie jest już możliwy do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było go zebrać przez moduł odśmiecający pamięci.
Dotyczy
AuthenticateAsClient(String, X509CertificateCollection, Boolean)
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer. Proces uwierzytelniania używa określonej kolekcji certyfikatów i domyślnego protokołu SSL systemu.
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)Parametry
- clientCertificates
- X509CertificateCollection
Element X509CertificateCollection zawierający certyfikaty klienta.
- checkCertificateRevocation
- Boolean
Boolean Wartość określająca, czy lista odwołania certyfikatów jest sprawdzana podczas uwierzytelniania.
Uwagi
Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń), dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączysz silną kryptografię przez edytowanie rejestru systemu Windows).
Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę SslStream. Sprawdź właściwość , IsMutuallyAuthenticated aby określić, czy wystąpiło wzajemne uwierzytelnianie.
Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony komunikat AuthenticationException, który SslStream nie jest już możliwy do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było go zebrać przez moduł odśmiecający pamięci.
Uwaga
Certyfikaty klienta nie są obsługiwane w protokole SSL w wersji 2.
Dotyczy
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
- Źródło:
- SslStream.cs
Wywoływane przez klientów w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer. W procesie uwierzytelniania jest używana określona kolekcja certyfikatów i protokół 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)Parametry
- clientCertificates
- X509CertificateCollection
Element X509CertificateCollection zawierający certyfikaty klienta.
- enabledSslProtocols
- SslProtocols
SslProtocols Wartość reprezentująca protokoły używane do uwierzytelniania.
- checkCertificateRevocation
- Boolean
Boolean Wartość określająca, czy lista odwołania certyfikatów jest sprawdzana podczas uwierzytelniania.
Uwagi
Począwszy od .NET Framework 4.7, ta metoda uwierzytelnia się przy użyciu metody None, która umożliwia systemowi operacyjnemu wybór najlepszego protokołu do użycia oraz blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4.6 (i .NET Framework 4.5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń), dozwolone wersje protokołów TLS/SSL to 1.2, 1.1 i 1.0 (chyba że wyłączysz silną kryptografię przez edytowanie rejestru systemu Windows).
Po pomyślnym uwierzytelnieniu należy sprawdzić IsEncrypted właściwości i IsSigned , aby określić, które usługi zabezpieczeń są używane przez usługę SslStream. Sprawdź właściwość , IsMutuallyAuthenticated aby określić, czy wystąpiło wzajemne uwierzytelnianie.
Jeśli uwierzytelnianie zakończy się niepowodzeniem, zostanie wyświetlony komunikat AuthenticationException, który SslStream nie jest już możliwy do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było go zebrać przez moduł odśmiecający pamięci.
Uwaga
Certyfikaty klienta nie są obsługiwane w protokole SSL w wersji 2.
Dotyczy
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla