SslStream.AuthenticateAsServerAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывается серверами аутентификации сервера, и, при необходимости, клиента в соединении клиент-сервер как асинхронная операция.
Перегрузки
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Вызывается серверами для проверки подлинности сервера и при необходимости клиента при подключении между клиентом и сервером с использованием указанных сертификатов, требований и протокола безопасности в рамках асинхронной операции. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Вызывается серверами для проверки подлинности сервера и при необходимости клиента при подключении между клиентом и сервером с использованием указанных сертификатов, требований и протокола безопасности в рамках асинхронной операции. |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Вызывается серверами аутентификации сервера, и, при необходимости, клиента в соединении клиент-сервер как асинхронная операция. В процессе проверки подлинности используются сведения, указанные в контейнере свойств |
| AuthenticateAsServerAsync(X509Certificate) |
Вызывается серверами для проверки подлинности сервера и, при необходимости, клиента в соединении клиент-сервер с использованием заданного сертификата как асинхронная операция. |
| AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken) |
Вызывается серверами аутентификации сервера, и, при необходимости, клиента в соединении клиент-сервер как асинхронная операция. Процесс аутентификации использует сведения, возвращаемые |
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.TaskPublic 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.TaskPublic 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.TaskPublic Function AuthenticateAsServerAsync (sslServerAuthenticationOptions As SslServerAuthenticationOptions, Optional cancellationToken As CancellationToken = Nothing) As TaskPublic 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.TaskPublic 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.TaskPublic 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 больше не будет использоваться. Этот объект следует закрыть и удалить все ссылки на него, чтобы сборщик мусора смог собрать его.
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по