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


SslStream.AuthenticateAsServerAsync Метод

Определение

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

Перегрузки

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

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

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

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

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

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

AuthenticateAsServerAsync(X509Certificate)

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

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

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

AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, System::Security::Authentication::SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, System.Security.Authentication.SslProtocols enabledSslProtocols, bool checkCertificateRevocation);
abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * System.Security.Authentication.SslProtocols * bool -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, enabledSslProtocols As SslProtocols, checkCertificateRevocation As Boolean) As Task

Параметры

serverCertificate
X509Certificate

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

clientCertificateRequired
Boolean

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

enabledSslProtocols
SslProtocols

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

checkCertificateRevocation
Boolean

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

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

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

Исключения

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

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

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

-или-

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

-или-

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

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

Комментарии

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

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).

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

AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate, bool clientCertificateRequired, bool checkCertificateRevocation);
abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate * bool * bool -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate, clientCertificateRequired As Boolean, checkCertificateRevocation As Boolean) As Task

Параметры

serverCertificate
X509Certificate

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

clientCertificateRequired
Boolean

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

checkCertificateRevocation
Boolean

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

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

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

Исключения

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

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

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

-или-

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

-или-

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

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

Комментарии

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

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые AuthenticateAsServer(X509Certificate, Boolean, Boolean).

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

AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)

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

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

public:
 System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::Security::SslServerAuthenticationOptions ^ sslServerAuthenticationOptions, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken = default);
public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.SslServerAuthenticationOptions sslServerAuthenticationOptions, System.Threading.CancellationToken cancellationToken);
member this.AuthenticateAsServerAsync : System.Net.Security.SslServerAuthenticationOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As Task
Public Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, cancellationToken As CancellationToken) As Task

Параметры

sslServerAuthenticationOptions
SslServerAuthenticationOptions

Контейнер свойств для SSL-подключения.

cancellationToken
CancellationToken

Токен для отслеживания запросов отмены.

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

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

Исключения

ServerCertificateSelectionCallback, ServerCertificate или ServerCertificateContext имеет значение null, а LocalCertificateSelectionCallback не задан в конструкторе SslStream.

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

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

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

-или-

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

-или-

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

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

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые AuthenticateAsServer(SslServerAuthenticationOptions).

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

AuthenticateAsServerAsync(X509Certificate)

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Cryptography::X509Certificates::X509Certificate ^ serverCertificate);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Cryptography.X509Certificates.X509Certificate serverCertificate);
abstract member AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Cryptography.X509Certificates.X509Certificate -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (serverCertificate As X509Certificate) As Task

Параметры

serverCertificate
X509Certificate

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

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

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

Исключения

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

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

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

-или-

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

-или-

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

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

Метод AuthenticateAsServerAsync не поддерживается в 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).

Этот метод выполняет проверку подлинности с помощью Default. Список отзыва сертификатов не проверяется во время проверки подлинности. Клиенту не требуется предоставлять сертификат для проверки подлинности.

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые AuthenticateAsServer(X509Certificate).

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

AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)

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

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

public System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.Security.ServerOptionsSelectionCallback optionsCallback, object? state, System.Threading.CancellationToken cancellationToken = default);
member this.AuthenticateAsServerAsync : System.Net.Security.ServerOptionsSelectionCallback * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function AuthenticateAsServerAsync (optionsCallback As ServerOptionsSelectionCallback, state As Object, Optional cancellationToken As CancellationToken = Nothing) As Task

Параметры

optionsCallback
ServerOptionsSelectionCallback

Делегат обратного вызова.

state
Object

Объект состояния, который необходимо передать в optionsCallback при обратном вызове.

cancellationToken
CancellationToken

Токен для отслеживания запросов отмены.

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

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

Исключения

ServerCertificateSelectionCallback, ServerCertificate или ServerCertificateContext имеет значение null, а LocalCertificateSelectionCallback не задан в конструкторе SslStream.

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

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

-или-

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

-или-

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

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

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

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

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