SslStream.AuthenticateAsClient Метод

  • Ссылка

Определение

Пространство имен:
System.Net.Security
Сборка:
System.Net.Security.dll
Сборка:
System.dll
Сборка:
netstandard.dll

Проверяет подлинность клиентской стороны соединения клиент-сервер.

Перегрузки

AuthenticateAsClient(SslClientAuthenticationOptions)

Вызывается клиентами для проверки подлинности сервера и, при необходимости, клиента в подключении "клиент-сервер".
AuthenticateAsClient(String)

Вызывается клиентами для проверки подлинности сервера и, при необходимости, клиента в подключении "клиент-сервер".
AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Вызывается клиентами для проверки подлинности сервера и, при необходимости, клиента в подключении "клиент-сервер". Процесс проверки подлинности использует указанную коллекцию сертификатов и протокол SSL системы по умолчанию.
AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Вызывается клиентами для проверки подлинности сервера и, при необходимости, клиента в подключении "клиент-сервер". Процесс проверки подлинности использует заданную коллекцию сертификатов и протокол SSL.

AuthenticateAsClient(SslClientAuthenticationOptions)

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

public:
 void AuthenticateAsClient(System::Net::Security::SslClientAuthenticationOptions ^ sslClientAuthenticationOptions);
public void AuthenticateAsClient (System.Net.Security.SslClientAuthenticationOptions sslClientAuthenticationOptions);
member this.AuthenticateAsClient : System.Net.Security.SslClientAuthenticationOptions -> unit
Public Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)

Параметры

sslClientAuthenticationOptions
SslClientAuthenticationOptions

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

Исключения

ArgumentNullException

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

AuthenticationException

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

InvalidOperationException

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

-или-

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

-или-

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

ObjectDisposedException

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

Комментарии

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

При успешной проверке подлинности необходимо проверить IsEncrypted и IsSigned свойства, чтобы определить, какие службы безопасности используются в SslStream. IsMutuallyAuthenticated Проверьте свойство, чтобы определить, произошла ли взаимная проверка подлинности.

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

Применяется к

AuthenticateAsClient(String)

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

public:
 virtual void AuthenticateAsClient(System::String ^ targetHost);
public virtual void AuthenticateAsClient (string targetHost);
abstract member AuthenticateAsClient : string -> unit
override this.AuthenticateAsClient : string -> unit
Public Overridable Sub AuthenticateAsClient (targetHost As String)

Параметры

targetHost
String

Имя сервера, который совместно использует SslStream.

Исключения

ArgumentNullException

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

AuthenticationException

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

InvalidOperationException

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

-или- Попытка проверки подлинности сервера с использованием SslStream уже выполнена.

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

ObjectDisposedException

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

Комментарии

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

При успешной проверке подлинности необходимо проверить IsEncrypted и IsSigned свойства, чтобы определить, какие службы безопасности используются в SslStream. IsMutuallyAuthenticated Проверьте свойство, чтобы определить, произошла ли взаимная проверка подлинности.

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

Применяется к

AuthenticateAsClient(String, X509CertificateCollection, Boolean)

Вызывается клиентами для проверки подлинности сервера и, при необходимости, клиента в подключении "клиент-сервер". Процесс проверки подлинности использует указанную коллекцию сертификатов и протокол SSL системы по умолчанию.

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 -> unit
Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)

Параметры

targetHost
String

Имя сервера, который будет совместно использовать SslStream.

clientCertificates
X509CertificateCollection

Объект X509CertificateCollection, который содержит сертификаты клиента.

checkCertificateRevocation
Boolean

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

Комментарии

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

При успешной проверке подлинности необходимо проверить IsEncrypted и IsSigned свойства, чтобы определить, какие службы безопасности используются в SslStream. IsMutuallyAuthenticated Проверьте свойство, чтобы определить, произошла ли взаимная проверка подлинности.

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

Примечание

Сертификаты клиента не поддерживаются в протоколе SSL версии 2.

Применяется к

AuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean)

Вызывается клиентами для проверки подлинности сервера и, при необходимости, клиента в подключении "клиент-сервер". Процесс проверки подлинности использует заданную коллекцию сертификатов и протокол 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 -> unit
Public Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)

Параметры

targetHost
String

Имя сервера, который будет совместно использовать SslStream.

clientCertificates
X509CertificateCollection

Объект X509CertificateCollection, который содержит сертификаты клиента.

enabledSslProtocols
SslProtocols

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

checkCertificateRevocation
Boolean

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

Комментарии

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

При успешной проверке подлинности необходимо проверить IsEncrypted и IsSigned свойства, чтобы определить, какие службы безопасности используются .SslStream Проверьте свойство, IsMutuallyAuthenticated чтобы определить, произошла ли взаимная проверка подлинности.

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

Примечание

Сертификаты клиента не поддерживаются в протоколе SSL версии 2.

Применяется к