SslStream.AuthenticateAsServer Metoda

Definicja

Przestrzeń nazw:

System.Net.Security

Zestaw:

System.Net.Security.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 uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera 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 uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera przy użyciu określonych certyfikatów, wymagań i protokołu zabezpieczeń.

AuthenticateAsServer(SslServerAuthenticationOptions)

Źródło:

SslStream.cs

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 systemach Windows 95, Windows 98 lub Windows Millennium.

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 wersji .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łączono silną kryptografię przez edytowanie rejestru 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)

Źródło:

SslStream.cs

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 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 systemach Windows 95, Windows 98 lub Windows Millennium.

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 wersji .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łączono silną kryptografię przez edytowanie rejestru 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, Boolean, Boolean)

Źródło:

SslStream.cs

Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera 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

Boolean Wartość 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 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 systemach Windows 95, Windows 98 lub Windows Millennium.

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 wersji .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łączono silną kryptografię przez edytowanie rejestru 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, 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, Boolean, SslProtocols, Boolean)

Źródło:

SslStream.cs

Wywoływane przez serwery w celu uwierzytelnienia serwera i opcjonalnie klienta w połączeniu klienta-serwera 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

Boolean Wartość 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 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 systemach Windows 95, Windows 98 lub Windows Millennium.

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 wersji .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łączono silną kryptografię przez edytowanie rejestru 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, 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.