Поделиться через

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)

Исходный код:
SslStream.cs
Исходный код:
SslStream.cs
Исходный код:
SslStream.cs

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

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)

Исходный код:
SslStream.cs
Исходный код:
SslStream.cs
Исходный код:
SslStream.cs

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

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)

Исходный код:
SslStream.cs
Исходный код:
SslStream.cs
Исходный код:
SslStream.cs

Вызывается клиентами для проверки подлинности сервера и, при необходимости, клиента в подключении "клиент-сервер". Процесс проверки подлинности использует указанную коллекцию сертификатов и протокол 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)

Исходный код:
SslStream.cs
Исходный код:
SslStream.cs
Исходный код:
SslStream.cs

Вызывается клиентами для проверки подлинности сервера и, при необходимости, клиента в подключении "клиент-сервер". Процесс проверки подлинности использует заданную коллекцию сертификатов и протокол 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.

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