SslStream.AuthenticateAsServer Metoda

Definicja

Przestrzeń nazw:

System.Net.Security

Zestaw:

System.Net.Security.dll

Zestaw:

System.dll

Zestaw:

netstandard.dll

Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera.

Przeciążenia

AuthenticateAsServer(SslServerAuthenticationOptions)	Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera przy użyciu określonego certyfikatu.
AuthenticateAsServer(X509Certificate)	Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera przy użyciu określonego certyfikatu.
AuthenticateAsServer(X509Certificate, Boolean, Boolean)	Wywoływane przez serwery w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer przy użyciu określonych certyfikatów i wymagań oraz przy użyciu domyślnego protokołu zabezpieczeń systemu.
AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)	Wywoływane przez serwery w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer przy użyciu określonych certyfikatów, wymagań i protokołu zabezpieczeń.

AuthenticateAsServer(SslServerAuthenticationOptions)

Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera przy użyciu określonego certyfikatu.

public:
 void AuthenticateAsServer(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions);

public void AuthenticateAsServer (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions);

member this.AuthenticateAsServer : System.Net.Security.SslServerAuthenticationOptions -> unit

Public Sub AuthenticateAsServer (sslServerAuthenticationOptions As SslServerAuthenticationOptions)

Parametry

sslServerAuthenticationOptions

SslServerAuthenticationOptions

Torba właściwości dla połączenia SSL.

Wyjątki

ArgumentNullException

serverCertificate to null.

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiło ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie zostało już zrobione.

-lub- Uwierzytelnianie klienta przy użyciu tej SslStream metody zostało wcześniej wypróbowane.

-lub- Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

PlatformNotSupportedException

Metoda nie jest obsługiwana AuthenticateAsServer w Windows 95, Windows 98 lub Windows Millennium.

Uwagi

Począwszy od .NET Framework 4,7, ta metoda jest uwierzytelniana przy użyciu None , co umożliwia systemowi operacyjnemu wybranie najlepszego używanego protokołu i blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4,6 (i .NET Framework 4,5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń) dozwolone protokoły TLS/SSL to 1,2, 1,1 i 1,0 (chyba że zostanie wyłączone silne Kryptografia, edytując rejestr systemu Windows). Lista odwołania certyfikatów nie jest sprawdzana podczas uwierzytelniania. Klient nie jest wymagany do dostarczenia certyfikatu do uwierzytelniania.

Ta metoda blokuje działanie do momentu zakończenia operacji. Aby zapobiec blokowaniu do momentu zakończenia operacji, użyj jednego z BeginAuthenticateAsServer przeciążeń metody.

Jeśli uwierzytelnianie zakończy się niepowodzeniem, otrzymasz element AuthenticationException, a to SslStream nie jest już możliwe do użycia. Należy zamknąć ten obiekt i usunąć wszystkie odwołania do niego, aby można było je zebrać przez moduł odśmieceń pamięci.

AuthenticateAsServer(X509Certificate)

Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera przy użyciu określonego certyfikatu.

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate)

Parametry

serverCertificate

X509Certificate

Certyfikat używany do uwierzytelniania serwera.

Wyjątki

ArgumentNullException

serverCertificate to null.

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiono ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie już wystąpiło.

-lub- Wcześniej próbowano użyć uwierzytelniania SslStream klienta.

-lub- Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

PlatformNotSupportedException

Metoda nie jest obsługiwana AuthenticateAsServer w Windows 95, Windows 98 lub Windows Millennium.

Uwagi

Począwszy od .NET Framework 4,7, ta metoda jest uwierzytelniana przy użyciu None , co umożliwia systemowi operacyjnemu wybranie najlepszego używanego protokołu i blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4,6 (i .NET Framework 4,5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń) dozwolone protokoły TLS/SSL to 1,2, 1,1 i 1,0 (chyba że zostanie wyłączone silne Kryptografia, edytując rejestr systemu Windows). Lista odwołania certyfikatów nie jest sprawdzana podczas uwierzytelniania. Klient nie jest wymagany do dostarczenia certyfikatu na potrzeby uwierzytelniania.

Ta metoda blokuje działanie do momentu zakończenia operacji. Aby zapobiec blokowaniu do momentu zakończenia operacji, użyj jednego z BeginAuthenticateAsServer przeciążeń metody.

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.

AuthenticateAsServer(X509Certificate, Boolean, Boolean)

Wywoływane przez serwery w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer przy użyciu określonych certyfikatów i wymagań oraz przy użyciu domyślnego protokołu zabezpieczeń systemu.

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean)

Parametry

serverCertificate

X509Certificate

X509Certificate używany do uwierzytelniania serwera.

clientCertificateRequired

Boolean

Wartość Boolean określająca, czy klient jest proszony o certyfikat do uwierzytelniania. Należy pamiętać, że jest to tylko żądanie — jeśli nie podano certyfikatu, serwer nadal akceptuje żądanie połączenia.

checkCertificateRevocation

Boolean

Boolean Wartość określająca, czy lista odwołania certyfikatów jest sprawdzana podczas uwierzytelniania.

Wyjątki

ArgumentNullException

serverCertificate to null.

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiono ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie już wystąpiło.

-lub- Wcześniej próbowano użyć uwierzytelniania SslStream klienta.

-lub- Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

PlatformNotSupportedException

Metoda nie jest obsługiwana AuthenticateAsServer w Windows 95, Windows 98 lub Windows Millennium.

Uwagi

Począwszy od .NET Framework 4,7, ta metoda jest uwierzytelniana przy użyciu None , co umożliwia systemowi operacyjnemu wybranie najlepszego używanego protokołu i blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4,6 (i .NET Framework 4,5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń) dozwolone protokoły TLS/SSL to 1,2, 1,1 i 1,0 (chyba że zostanie wyłączone silne Kryptografia, edytując rejestr systemu Windows).

Ta metoda blokuje działanie do momentu zakończenia operacji. Aby zapobiec blokowaniu do momentu zakończenia operacji, użyj jednego z BeginAuthenticateAsServer przeciążeń metody.

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.

AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)

Wywoływane przez serwery w celu uwierzytelniania serwera i opcjonalnie klienta w połączeniu klient-serwer przy użyciu określonych certyfikatów, wymagań i protokołu zabezpieczeń.

public:
 virtual void AuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

public virtual void AuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);

abstract member AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit
override this.AuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> unit

Public Overridable Sub AuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

Parametry

serverCertificate

X509Certificate

X509Certificate używany do uwierzytelniania serwera.

clientCertificateRequired

Boolean

Wartość Boolean określająca, czy klient jest proszony o certyfikat do uwierzytelniania. Należy pamiętać, że jest to tylko żądanie — jeśli nie podano certyfikatu, serwer nadal akceptuje żądanie połączenia.

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.

Wyjątki

ArgumentNullException

serverCertificate to null.

ArgumentException

enabledSslProtocols jest nieprawidłową SslProtocols wartością.

AuthenticationException

Uwierzytelnianie nie powiodło się i pozostawiono ten obiekt w stanie bezużytecznym.

InvalidOperationException

Uwierzytelnianie już wystąpiło.

-lub- Wcześniej próbowano użyć uwierzytelniania SslStream klienta.

-lub- Uwierzytelnianie jest już w toku.

ObjectDisposedException

Ten obiekt został zamknięty.

PlatformNotSupportedException

Metoda nie jest obsługiwana AuthenticateAsServer w Windows 95, Windows 98 lub Windows Millennium.

Uwagi

Począwszy od .NET Framework 4,7, ta metoda jest uwierzytelniana przy użyciu None , co umożliwia systemowi operacyjnemu wybranie najlepszego używanego protokołu i blokowanie protokołów, które nie są bezpieczne. W .NET Framework 4,6 (i .NET Framework 4,5 z zainstalowanymi najnowszymi poprawkami zabezpieczeń) dozwolone protokoły TLS/SSL to 1,2, 1,1 i 1,0 (chyba że zostanie wyłączone silne Kryptografia, edytując rejestr systemu Windows).

Ta metoda blokuje działanie do momentu zakończenia operacji. Aby zapobiec blokowaniu do momentu zakończenia operacji, użyj jednego z BeginAuthenticateAsServer przeciążeń metody.

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.