SslStream.BeginAuthenticateAsClient Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Начинает операцию для проверки подлинности клиентской стороны соединения клиент-сервер.
Перегрузки
| Имя | Описание |
|---|---|
| BeginAuthenticateAsClient(String, AsyncCallback, Object) |
Вызывается клиентами для запуска асинхронной операции проверки подлинности сервера и, при необходимости, клиента. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object) |
Вызывается клиентами для запуска асинхронной операции проверки подлинности сервера и (при необходимости) клиента с использованием указанных сертификатов и протокола безопасности системы по умолчанию. |
| BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object) |
Вызывается клиентами для запуска асинхронной операции проверки подлинности сервера, и, при необходимости, клиента с использованием указанных сертификатов и протокола безопасности. |
Комментарии
Перегрузки этого метода не блокируются во время проверки подлинности. Чтобы заблокировать в ожидании завершения проверки подлинности, используйте один из AuthenticateAsClient методов.
BeginAuthenticateAsClient(String, AsyncCallback, Object)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
Вызывается клиентами для запуска асинхронной операции проверки подлинности сервера и, при необходимости, клиента.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultПараметры
- asyncCallback
- AsyncCallback
Делегат AsyncCallback, который ссылается на метод, вызываемый после выполнения проверки подлинности.
- asyncState
- Object
Пользовательский объект, содержащий сведения об операции. Этот объект передается делегату asyncCallback после завершения операции.
Возвращаемое значение
Объект IAsyncResult, представляющий состояние асинхронной операции.
Исключения
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 должно соответствовать имени в сертификате сервера.
Асинхронная операция проверки подлинности должна быть завершена путем вызова EndAuthenticateAsClient метода . Как правило, метод вызывается делегатом asyncCallback .
Этот метод не блокируется во время завершения операции. Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsClient перегрузок метода.
Подробные сведения об использовании асинхронной модели программирования см. в статье Вызов асинхронных методов.
Если вы получаете AuthenticationException, этот SslStream параметр больше не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.
Применяется к
BeginAuthenticateAsClient(String, X509CertificateCollection, Boolean, AsyncCallback, Object)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
Вызывается клиентами для запуска асинхронной операции проверки подлинности сервера и (при необходимости) клиента с использованием указанных сертификатов и протокола безопасности системы по умолчанию.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultПараметры
- clientCertificates
- X509CertificateCollection
Коллекция X509CertificateCollection, содержащая сертификаты клиента.
- checkCertificateRevocation
- Boolean
Значение Boolean, которое указывает, проверяется ли список отзыва сертификатов при проверке подлинности.
- asyncCallback
- AsyncCallback
Делегат AsyncCallback, который ссылается на метод, вызываемый после выполнения проверки подлинности.
- asyncState
- Object
Пользовательский объект, содержащий сведения об операции. Этот объект передается делегату asyncCallback после завершения операции.
Возвращаемое значение
Объект IAsyncResult, представляющий состояние асинхронной операции.
Исключения
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 должно соответствовать имени в сертификате сервера.
Асинхронная операция проверки подлинности должна быть завершена путем вызова EndAuthenticateAsClient метода . Как правило, метод вызывается делегатом asyncCallback .
Этот метод не блокируется во время завершения операции. Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsClient перегрузок метода.
Подробные сведения об использовании асинхронной модели программирования см. в статье Вызов асинхронных методов.
Если вы получаете AuthenticationException, этот SslStream параметр больше не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.
Примечание
Сертификаты клиента не поддерживаются в протоколе SSL версии 2.
Применяется к
BeginAuthenticateAsClient(String, X509CertificateCollection, SslProtocols, Boolean, AsyncCallback, Object)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
Вызывается клиентами для запуска асинхронной операции проверки подлинности сервера, и, при необходимости, клиента с использованием указанных сертификатов и протокола безопасности.
public:
virtual IAsyncResult ^ BeginAuthenticateAsClient(System::String ^ targetHost, System::Security::Cryptography::X509Certificates::X509CertificateCollection ^ clientCertificates, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection? clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);public virtual IAsyncResult BeginAuthenticateAsClient(string targetHost, System.Security.Cryptography.X509Certificates.X509CertificateCollection clientCertificates, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);abstract member BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsClient : string * System.Security.Cryptography.X509Certificates.X509CertificateCollection * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResultPublic Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResultПараметры
- clientCertificates
- X509CertificateCollection
Коллекция X509CertificateCollection, содержащая сертификаты клиента.
- enabledSslProtocols
- SslProtocols
Значение SslProtocols, которое представляет протоколы, используемые для проверки подлинности.
- checkCertificateRevocation
- Boolean
Значение Boolean, которое указывает, проверяется ли список отзыва сертификатов при проверке подлинности.
- asyncCallback
- AsyncCallback
Делегат AsyncCallback, который ссылается на метод, вызываемый после выполнения проверки подлинности.
- asyncState
- Object
Пользовательский объект, содержащий сведения об операции. Этот объект передается делегату asyncCallback после завершения операции.
Возвращаемое значение
Объект IAsyncResult, представляющий состояние асинхронной операции.
Исключения
targetHost имеет значение null.
enabledSslProtocols не является допустимым значением SslProtocols.
Произошел сбой проверки подлинности, и этот объект остался в неработоспособном состоянии.
Проверка подлинности уже выполнена.
-или-
Попытка проверки подлинности сервера с использованием SslStream уже выполнена.
-или-
Проверка подлинности уже выполняется.
Объект закрыт.
Комментарии
Начиная с версии .NET Framework 4.7 этот метод выполняет проверку подлинности с помощью None, что позволяет операционной системе выбрать наилучший протокол для использования и блокирования протоколов, которые не являются безопасными. В .NET Framework 4.6 (и .NET Framework 4.5 с последними обновлениями безопасности) допустимы версии протокола TLS/SSL 1.0, 1.1 и 1.2 (если только вы не отключите надежное шифрование в реестре Windows).
Значение, указанное для , targetHost должно соответствовать имени в сертификате сервера.
Асинхронная операция проверки подлинности должна быть завершена путем вызова EndAuthenticateAsClient метода . Как правило, метод вызывается делегатом asyncCallback .
Этот метод не блокируется во время завершения операции. Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsClient перегрузок метода.
Подробные сведения об использовании асинхронной модели программирования см. в статье Вызов асинхронных методов.
Если вы получаете AuthenticationException, этот SslStream параметр больше не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.
Примечание
Сертификаты клиента не поддерживаются в протоколе SSL версии 2.
