SslStream.BeginAuthenticateAsServer Метод

Ссылка

Определение

Пространство имен:: System.Net.Security

Сборка:: System.Net.Security.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Начинает асинхронную операцию для проверки подлинности серверной стороны соединения клиент-сервер.

Перегрузки

BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)	Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер.
BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)	Вызывается серверами для запуска асинхронной операции проверки подлинности сервера и (при необходимости) клиента с использованием указанных сертификатов, требований и протокола безопасности системы по умолчанию.
BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)	Вызывается серверами для запуска асинхронной операции проверки подлинности сервера и (при необходимости) клиента с использованием указанных сертификатов, требований и протокола безопасности.

Перегрузки этого метода не блокируются во время проверки подлинности. Чтобы выполнить блокировку во время ожидания завершения проверки подлинности, используйте один из AuthenticateAsServer методов.

BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)

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

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

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

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

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback? asyncCallback, object? asyncState);

public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, AsyncCallback asyncCallback, object asyncState);

abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Параметры

serverCertificate: X509Certificate

Сертификат X509, который используется для проверки подлинности сервера.

asyncCallback: AsyncCallback

Делегат AsyncCallback , который ссылается на метод, вызываемый после выполнения проверки подлинности.

asyncState: Object

Пользовательский объект, содержащий сведения об операции. Этот объект передается делегату asyncCallback после завершения операции.

Возвращаемое значение

IAsyncResult

Объект IAsyncResult, указывающий состояние асинхронной операции.

Исключения

ArgumentNullException

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

AuthenticationException

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

InvalidOperationException

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

-или-

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

-или-

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

ObjectDisposedException

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

PlatformNotSupportedException

Метод BeginAuthenticateAsServer не поддерживается в Windows 95, Windows 98 и Windows Millennium.

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

Асинхронную операцию проверки подлинности необходимо завершить путем вызова EndAuthenticateAsClient метода . Как правило, метод вызывается делегатом asyncCallback .

Этот метод не блокируется во время завершения операции. Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsClient перегрузок метода.

Подробные сведения об использовании асинхронной модели программирования см. в разделе Асинхронный вызов синхронных методов.

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

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

BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)

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

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

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

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

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);

public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);

abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Параметры

serverCertificate: X509Certificate

Сертификат X509, который используется для проверки подлинности сервера.

clientCertificateRequired: Boolean

Значение Boolean, которое указывает, получает ли клиент запрос на сертификат для проверки подлинности. Обратите внимание, что это — только запрос. Если сертификат не предоставляется, сервер продолжает принимать запрос на подключение.

checkCertificateRevocation: Boolean

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

asyncCallback: AsyncCallback

Делегат AsyncCallback, который ссылается на метод, вызываемый после выполнения проверки подлинности.

asyncState: Object

Возвращаемое значение

IAsyncResult

Объект IAsyncResult, представляющий состояние асинхронной операции.

Исключения

ArgumentNullException

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

AuthenticationException

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

InvalidOperationException

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

-или-

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

-или-

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

ObjectDisposedException

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

PlatformNotSupportedException

Метод BeginAuthenticateAsServer не поддерживается в Windows 95, Windows 98 и Windows Millennium.

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

BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)

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

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

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

public:
 virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);

public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback? asyncCallback, object? asyncState);

public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation, AsyncCallback asyncCallback, object asyncState);

abstract member BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool * AsyncCallback * obj -> IAsyncResult

Public Overridable Function BeginAuthenticateAsServer (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult

Параметры

serverCertificate: X509Certificate

Сертификат X509, который используется для проверки подлинности сервера.

clientCertificateRequired: Boolean

enabledSslProtocols: SslProtocols

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

checkCertificateRevocation: Boolean

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

asyncCallback: AsyncCallback

Делегат AsyncCallback, который ссылается на метод, вызываемый после выполнения проверки подлинности.

asyncState: Object

Возвращаемое значение

IAsyncResult

Объект IAsyncResult, представляющий состояние асинхронной операции.

Исключения

ArgumentNullException

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

ArgumentException

enabledSslProtocols не является допустимым значением SslProtocols.

AuthenticationException

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

InvalidOperationException

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

-или-

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

-или-

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

ObjectDisposedException

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

PlatformNotSupportedException

Метод BeginAuthenticateAsServer не поддерживается в Windows 95, Windows 98 и Windows Millennium.

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

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

SslStream.BeginAuthenticateAsServer Метод

Определение

Перегрузки

Комментарии

BeginAuthenticateAsServer(X509Certificate, AsyncCallback, Object)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

BeginAuthenticateAsServer(X509Certificate, Boolean, Boolean, AsyncCallback, Object)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

BeginAuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean, AsyncCallback, Object)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

Дополнительные ресурсы