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


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

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

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 -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Параметры

targetHost
String

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

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

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

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 -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Параметры

targetHost
String

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

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

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

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 -> IAsyncResult
Public Overridable Function BeginAuthenticateAsClient (targetHost As String, clientCertificates As X509CertificateCollection, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Параметры

targetHost
String

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

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.

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