SslStream.AuthenticateAsServer Метод

Определение

Пространство имен:

System.Net.Security

Сборка:

System.Net.Security.dll

Вызывается серверами для проверки подлинности сервера и, при необходимости, клиента в соединении клиент-сервер.

Перегрузки

AuthenticateAsServer(SslServerAuthenticationOptions)	Вызывается серверами для проверки подлинности сервера и, при необходимости, клиента в соединении клиент-сервер с использованием заданного сертификата.
AuthenticateAsServer(X509Certificate)	Вызывается серверами для проверки подлинности сервера и, при необходимости, клиента в соединении клиент-сервер с использованием заданного сертификата.
AuthenticateAsServer(X509Certificate, Boolean, Boolean)	Вызывается серверами для проверки подлинности сервера и (при необходимости) клиента в подключении между клиентом и сервером с использованием указанных сертификатов, требований и протокола безопасности системы по умолчанию.
AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)	Вызывается серверами для проверки подлинности сервера и при необходимости клиента в подключении между клиентом и сервером с использованием указанных сертификатов, требований и протокола безопасности.

AuthenticateAsServer(SslServerAuthenticationOptions)

Исходный код:

SslStream.cs

Вызывается серверами для проверки подлинности сервера и, при необходимости, клиента в соединении клиент-сервер с использованием заданного сертификата.

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)

Параметры

sslServerAuthenticationOptions

SslServerAuthenticationOptions

Контейнер свойств для SSL-подключения.

Исключения

ArgumentNullException

serverCertificate имеет значение null.

AuthenticationException

Произошел сбой проверки подлинности, и этот объект остался в неработоспособном состоянии.

InvalidOperationException

Проверка подлинности уже выполнена.

-или-

Попытка проверки подлинности клиента с помощью этого параметра SslStream уже выполнена ранее.

-или-

Проверка подлинности уже выполняется.

ObjectDisposedException

Объект закрыт.

PlatformNotSupportedException

Метод AuthenticateAsServer не поддерживается в Windows 95, Windows 98 и Windows Millennium.

Комментарии

Начиная с версии .NET Framework 4.7 этот метод выполняет проверку подлинности с помощью None, что позволяет операционной системе выбрать наилучший протокол для использования и блокирования протоколов, которые не являются безопасными. В .NET Framework 4.6 (и .NET Framework 4.5 с последними обновлениями безопасности) допустимы версии протокола TLS/SSL 1.0, 1.1 и 1.2 (если только вы не отключите надежное шифрование в реестре Windows). Список отзыва сертификатов не проверяется во время проверки подлинности. Клиенту не требуется предоставлять сертификат для проверки подлинности.

Этот метод блокируется до завершения операции. Чтобы предотвратить блокировку до завершения операции, используйте одну из BeginAuthenticateAsServer перегрузок метода.

Если проверка подлинности завершается сбоем AuthenticationException, вы получите , и она SslStream больше не будет использоваться. Этот объект следует закрыть и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.

AuthenticateAsServer(X509Certificate)

Исходный код:

SslStream.cs

Вызывается серверами для проверки подлинности сервера и, при необходимости, клиента в соединении клиент-сервер с использованием заданного сертификата.

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)

Параметры

serverCertificate

X509Certificate

Сертификат используется для проверки подлинности сервера.

Исключения

ArgumentNullException

serverCertificate имеет значение null.

AuthenticationException

Произошел сбой проверки подлинности, и этот объект остался в неработоспособном состоянии.

InvalidOperationException

Проверка подлинности уже выполнена.

-или-

Попытка проверки подлинности клиента с помощью этого параметра SslStream уже выполнена ранее.

-или-

Проверка подлинности уже выполняется.

ObjectDisposedException

Объект закрыт.

PlatformNotSupportedException

Метод AuthenticateAsServer не поддерживается в Windows 95, Windows 98 и Windows Millennium.

Комментарии

Начиная с версии .NET Framework 4.7 этот метод выполняет проверку подлинности с помощью None, что позволяет операционной системе выбрать наилучший протокол для использования и блокирования протоколов, которые не являются безопасными. В .NET Framework 4.6 (и .NET Framework 4.5 с последними обновлениями безопасности) допустимы версии протокола TLS/SSL 1.0, 1.1 и 1.2 (если только вы не отключите надежное шифрование в реестре Windows). Список отзыва сертификатов не проверяется во время проверки подлинности. Клиенту не требуется предоставлять сертификат для проверки подлинности.

Этот метод блокируется до завершения операции. Чтобы предотвратить блокировку до завершения операции, используйте одну из BeginAuthenticateAsServer перегрузок метода.

Если проверка подлинности завершается сбоем AuthenticationException, вы получите , и она SslStream больше не будет использоваться. Этот объект следует закрыть и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.

AuthenticateAsServer(X509Certificate, Boolean, Boolean)

Исходный код:

SslStream.cs

Вызывается серверами для проверки подлинности сервера и (при необходимости) клиента в подключении между клиентом и сервером с использованием указанных сертификатов, требований и протокола безопасности системы по умолчанию.

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)

Параметры

serverCertificate

X509Certificate

Сертификат X509, который используется для проверки подлинности сервера.

clientCertificateRequired

Boolean

Значение Boolean, которое указывает, получает ли клиент запрос на сертификат для проверки подлинности. Обратите внимание, что это — только запрос. Если сертификат не предоставляется, сервер продолжает принимать запрос на подключение.

checkCertificateRevocation

Boolean

Значение Boolean, которое указывает, проверяется ли список отзыва сертификатов при проверке подлинности.

Исключения

ArgumentNullException

serverCertificate имеет значение null.

AuthenticationException

Произошел сбой проверки подлинности, и этот объект остался в неработоспособном состоянии.

InvalidOperationException

Проверка подлинности уже выполнена.

-или-

Попытка проверки подлинности клиента с помощью этого параметра SslStream уже выполнена ранее.

-или-

Проверка подлинности уже выполняется.

ObjectDisposedException

Объект закрыт.

PlatformNotSupportedException

Метод AuthenticateAsServer не поддерживается в Windows 95, Windows 98 и Windows Millennium.

Комментарии

Начиная с версии .NET Framework 4.7 этот метод выполняет проверку подлинности с помощью None, что позволяет операционной системе выбрать наилучший протокол для использования и блокирования протоколов, которые не являются безопасными. В .NET Framework 4.6 (и .NET Framework 4.5 с последними обновлениями безопасности) допустимы версии протокола TLS/SSL 1.0, 1.1 и 1.2 (если только вы не отключите надежное шифрование в реестре Windows).

Этот метод блокируется до завершения операции. Чтобы предотвратить блокировку до завершения операции, используйте одну из BeginAuthenticateAsServer перегрузок метода.

Если проверка подлинности завершается сбоем AuthenticationException, вы получите , и она SslStream больше не будет использоваться. Этот объект следует закрыть и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.

AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean)

Исходный код:

SslStream.cs

Вызывается серверами для проверки подлинности сервера и при необходимости клиента в подключении между клиентом и сервером с использованием указанных сертификатов, требований и протокола безопасности.

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)

Параметры

serverCertificate

X509Certificate

Сертификат X509, который используется для проверки подлинности сервера.

clientCertificateRequired

Boolean

Значение Boolean, которое указывает, получает ли клиент запрос на сертификат для проверки подлинности. Обратите внимание, что это — только запрос. Если сертификат не предоставляется, сервер продолжает принимать запрос на подключение.

enabledSslProtocols

SslProtocols

Значение SslProtocols, которое представляет протоколы, используемые для проверки подлинности.

checkCertificateRevocation

Boolean

Значение Boolean, которое указывает, проверяется ли список отзыва сертификатов при проверке подлинности.

Исключения

ArgumentNullException

serverCertificate имеет значение null.

ArgumentException

enabledSslProtocols не является допустимым значением SslProtocols.

AuthenticationException

Произошел сбой проверки подлинности, и этот объект остался в неработоспособном состоянии.

InvalidOperationException

Проверка подлинности уже выполнена.

-или-

Попытка проверки подлинности клиента с помощью этого параметра SslStream уже выполнена ранее.

-или-

Проверка подлинности уже выполняется.

ObjectDisposedException

Объект закрыт.

PlatformNotSupportedException

Метод AuthenticateAsServer не поддерживается в Windows 95, Windows 98 и Windows Millennium.

Комментарии

Начиная с версии .NET Framework 4.7 этот метод выполняет проверку подлинности с помощью None, что позволяет операционной системе выбрать наилучший протокол для использования и блокирования протоколов, которые не являются безопасными. В .NET Framework 4.6 (и .NET Framework 4.5 с последними обновлениями безопасности) допустимы версии протокола TLS/SSL 1.0, 1.1 и 1.2 (если только вы не отключите надежное шифрование в реестре Windows).

Этот метод блокируется до завершения операции. Чтобы предотвратить блокировку до завершения операции, используйте одну из BeginAuthenticateAsServer перегрузок метода.

Если проверка подлинности завершается сбоем AuthenticationException, вы получите , и она SslStream больше не будет использоваться. Этот объект следует закрыть и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.