SslStream.AuthenticateAsClient Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Проверяет подлинность клиентской стороны соединения клиент-сервер.
Перегрузки
| 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 -> unitPublic Sub AuthenticateAsClient (sslClientAuthenticationOptions As SslClientAuthenticationOptions)Параметры
- sslClientAuthenticationOptions
- SslClientAuthenticationOptions
Контейнер свойств для SSL-подключения.
Исключения
targetHost имеет значение null.
Произошел сбой проверки подлинности, и этот объект остался в неработоспособном состоянии.
Проверка подлинности уже выполнена.
-или-
Попытка проверки подлинности сервера с использованием SslStream уже выполнена.
-или-
Проверка подлинности уже выполняется.
Объект закрыт.
Комментарии
Начиная с версии .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 -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String)Параметры
Исключения
targetHost имеет значение null.
Произошел сбой проверки подлинности, и этот объект остался в неработоспособном состоянии.
Проверка подлинности уже выполнена.
-или-
Попытка проверки подлинности сервера с использованием SslStream уже выполнена.
-или-
Проверка подлинности уже выполняется.
Объект закрыт.
Комментарии
Начиная с версии .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 -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean)Параметры
- 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 -> unitPublic Overridable Sub AuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean)Параметры
- 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.
