SslStream.AuthenticateAsServerAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывается серверами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу в качестве асинхронной операции.
Перегрузки
| Имя | Описание |
|---|---|
| AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean) |
Вызывается серверами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу с использованием указанных сертификатов, требований и протокола безопасности в качестве асинхронной операции. |
| AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean) |
Вызывается серверами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу с использованием указанных сертификатов, требований и протокола безопасности в качестве асинхронной операции. |
| AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken) |
Вызывается серверами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу в качестве асинхронной операции. В процессе проверки подлинности используются сведения, возвращаемые |
| AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken) |
Выполняет проверку подлинности сервера и при необходимости клиента в подключении к клиентскому серверу в качестве асинхронной операции. В процессе проверки подлинности используются сведения, указанные в контейнере |
| AuthenticateAsServerAsync(X509Certificate) |
Вызывается серверами для проверки подлинности сервера и при необходимости клиента в подключении к клиентскому серверу с использованием указанного сертификата в качестве асинхронной операции. |
AuthenticateAsServerAsync(X509Certificate, Boolean, SslProtocols, Boolean)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- 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
X509Certificate, используемый для проверки подлинности сервера.
- 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.2, 1.1 и 1.0 (если только не отключить строгую криптографию, изменив реестр Windows).
Если проверка подлинности завершается ошибкой AuthenticationException, вы получите сообщение и больше SslStream не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы его можно было собрать сборщиком мусора.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых AuthenticateAsServer(X509Certificate, Boolean, SslProtocols, Boolean).
Применяется к
AuthenticateAsServerAsync(X509Certificate, Boolean, Boolean)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- 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
X509Certificate, используемый для проверки подлинности сервера.
- 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.2, 1.1 и 1.0 (если только не отключить строгую криптографию, изменив реестр Windows).
Если проверка подлинности завершается ошибкой AuthenticationException, вы получите сообщение и больше SslStream не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы его можно было собрать сборщиком мусора.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых AuthenticateAsServer(X509Certificate, Boolean, Boolean).
Применяется к
AuthenticateAsServerAsync(ServerOptionsSelectionCallback, Object, CancellationToken)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- 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 или ServerCertificateServerCertificateContext не nullLocalCertificateSelectionCallback задано в конструкторе SslStream .
Сбой проверки подлинности и оставил этот объект в неиспользуемом состоянии.
Проверка подлинности уже произошла.
–или–
Проверка подлинности клиента, используемая SslStream ранее.
–или–
Проверка подлинности уже выполняется.
Этот объект был закрыт.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Если проверка подлинности завершается ошибкой AuthenticationException, вы получите сообщение и больше SslStream не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы его можно было собрать сборщиком мусора.
Применяется к
AuthenticateAsServerAsync(SslServerAuthenticationOptions, CancellationToken)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
Выполняет проверку подлинности сервера и при необходимости клиента в подключении к клиентскому серверу в качестве асинхронной операции. В процессе проверки подлинности используются сведения, указанные в контейнере sslServerAuthenticationOptions свойств.
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 или ServerCertificateServerCertificateContext не nullLocalCertificateSelectionCallback задано в конструкторе SslStream .
sslServerAuthenticationOptions равно null.
Сбой проверки подлинности и оставил этот объект в неиспользуемом состоянии.
Проверка подлинности уже произошла.
–или–
Проверка подлинности клиента, используемая SslStream ранее.
–или–
Проверка подлинности уже выполняется.
Этот объект был закрыт.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Если проверка подлинности завершается ошибкой AuthenticationException, вы получите сообщение и больше SslStream не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы его можно было собрать сборщиком мусора.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых AuthenticateAsServer(SslServerAuthenticationOptions).
Применяется к
AuthenticateAsServerAsync(X509Certificate)
- Исходный код:
- SslStream.cs
- Исходный код:
- SslStream.cs
- Исходный код:
- 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 тысячелетия.
Комментарии
Начиная с .NET Framework 4.7 этот метод проходит проверку подлинности, Noneчто позволяет операционной системе выбирать лучший протокол для использования и блокировать протоколы, которые не защищены. В .NET Framework 4.6 (и .NET Framework 4.5 с установленными последними исправлениями безопасности) допустимые версии протоколов TLS/SSL : 1.2, 1.1 и 1.0 (если только не отключить строгую криптографию, изменив реестр Windows).
Этот метод выполняет проверку подлинности с помощью Default. Список отзыва сертификатов не проверяется во время проверки подлинности. Клиент не требует предоставления сертификата для проверки подлинности.
Если проверка подлинности завершается ошибкой AuthenticationException, вы получите сообщение и больше SslStream не используется. Необходимо закрыть этот объект и удалить все ссылки на него, чтобы его можно было собрать сборщиком мусора.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых AuthenticateAsServer(X509Certificate).
