NegotiateStream.AuthenticateAsClientAsync Метод

Ссылка

Определение

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

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

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

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

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

Перегрузки

AuthenticateAsClientAsync()	Вызывается клиентами аутентификации клиента, и, при необходимости, сервера в соединении клиент-сервер как асинхронная операция.
AuthenticateAsClientAsync(NetworkCredential, String)	Вызывается клиентами аутентификации клиента, и, при необходимости, сервера в соединении клиент-сервер как асинхронная операция. Процесс проверки подлинности использует заданные учетные данные клиента.
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)	Вызывается клиентами аутентификации клиента, и, при необходимости, сервера в соединении клиент-сервер как асинхронная операция. Процесс проверки подлинности использует заданные учетные данные клиента и привязку канала.
AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)	Вызывается клиентами аутентификации клиента, и, при необходимости, сервера в соединении клиент-сервер как асинхронная операция. Процесс проверки подлинности использует заданные учетные данные сервера и параметры проверки подлинности.
AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)	Вызывается клиентами аутентификации клиента, и, при необходимости, сервера в соединении клиент-сервер как асинхронная операция. Процесс проверки подлинности использует заданные учетные данные, параметры проверки подлинности и привязку канала.

AuthenticateAsClientAsync()

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

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync();

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync ();

abstract member AuthenticateAsClientAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : unit -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync () As Task

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

Task

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

Исключения

AuthenticationException

Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.

InvalidCredentialException

Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.

ObjectDisposedException

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

InvalidOperationException

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

-или-

Этот поток уже использовался ранее при попытке проверки подлинности со стороны сервера. Этот поток нельзя использовать для повторной проверки подлинности со стороны клиента.

При проверке подлинности используется клиент .DefaultCredentials Имя субъекта-службы (SPN) для сервера не указано. Уровень олицетворения — Identification, уровень безопасности — EncryptAndSign, и запрашивается взаимная проверка подлинности. Класс NegotiateStream создаст имя субъекта-службы, используемое для взаимной проверки подлинности.

После успешной проверки подлинности необходимо проверка IsEncrypted свойства и IsSigned , чтобы определить, какие службы безопасности используются NegotiateStream. Проверьте свойство , IsMutuallyAuthenticated чтобы определить, произошла ли взаимная проверка подлинности.

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

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

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

AuthenticateAsClientAsync(NetworkCredential, String)

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

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

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, string targetName);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String) As Task

Параметры

credential: NetworkCredential

Учетные данные NetworkCredential, используемые для установления идентификации клиента.

targetName: String

Имя участника-службы (SPN), уникально определяющее сервер, подлинность которого проверяется.

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

Task

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

Исключения

AuthenticationException

Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.

InvalidCredentialException

Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.

ObjectDisposedException

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

InvalidOperationException

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

-или-

ArgumentNullException

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

Уровень олицетворения — Identification, уровень безопасности — EncryptAndSign, и запрашивается взаимная проверка подлинности. Класс NegotiateStream создаст имя субъекта-службы, используемое для взаимной проверки подлинности.

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

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)

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

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String) As Task

Параметры

credential: NetworkCredential

Учетные данные NetworkCredential, используемые для установления идентификации клиента.

binding: ChannelBinding

Объект ChannelBinding, который используется для расширенной защиты.

targetName: String

Имя участника-службы (SPN), уникально определяющее сервер, подлинность которого проверяется.

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

Task

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

Исключения

ArgumentNullException

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

-или-

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

AuthenticationException

Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.

InvalidCredentialException

Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.

InvalidOperationException

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

-или-

ObjectDisposedException

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

Объект , используемый ChannelBinding для расширенной защиты, который передается этому методу в параметре binding , будет получен приложением из TransportContext свойства в связанном SslStreamобъекте .

См. также раздел

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

AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

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

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As Task

Параметры

credential: NetworkCredential

Учетные данные NetworkCredential, используемые для установления идентификации клиента.

targetName: String

Имя участника-службы (SPN), уникально определяющее сервер, подлинность которого проверяется.

requiredProtectionLevel: ProtectionLevel

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

allowedImpersonationLevel: TokenImpersonationLevel

Одно из значений перечисления TokenImpersonationLevel, указывающее, как сервер может использовать учетные записи клиента для доступа к ресурсам.

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

Task

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

Исключения

ArgumentOutOfRangeException

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

ArgumentNullException

Параметр targetName имеет значение null.

AuthenticationException

Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.

InvalidCredentialException

Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.

ObjectDisposedException

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

InvalidOperationException

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

-или-

Используйте параметр для requiredProtectionLevel запроса служб безопасности данных, передаваемых с помощью потока, прошедшего проверку подлинности. Например, чтобы данные были зашифрованы и подписаны, укажите EncryptAndSign значение . Успешная проверка подлинности не гарантирует предоставление запрошенного ProtectionLevel . Необходимо проверка IsEncrypted свойства и IsSigned , чтобы определить, какие службы безопасности используются NegotiateStream.

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

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

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)

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

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsClientAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ChannelBinding ^ binding, System::String ^ targetName, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel allowedImpersonationLevel);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding? binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

public virtual System.Threading.Tasks.Task AuthenticateAsClientAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ChannelBinding binding, string targetName, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel allowedImpersonationLevel);

abstract member AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsClientAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ChannelBinding * string * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task

Public Overridable Function AuthenticateAsClientAsync (credential As NetworkCredential, binding As ChannelBinding, targetName As String, requiredProtectionLevel As ProtectionLevel, allowedImpersonationLevel As TokenImpersonationLevel) As Task

Параметры

credential: NetworkCredential

Учетные данные NetworkCredential, используемые для установления идентификации клиента.

binding: ChannelBinding

Объект ChannelBinding, который используется для расширенной защиты.

targetName: String

Имя участника-службы (SPN), уникально определяющее сервер, подлинность которого проверяется.

requiredProtectionLevel: ProtectionLevel

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

allowedImpersonationLevel: TokenImpersonationLevel

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

Task

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

Исключения

ArgumentNullException

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

-или-

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

ArgumentOutOfRangeException

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

AuthenticationException

Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.

InvalidCredentialException

Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.

InvalidOperationException

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

-или-

ObjectDisposedException

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

Объект , используемый ChannelBinding для расширенной защиты, передаваемый этому методу в параметре binding , будет извлекаться приложением из TransportContext свойства в связанном SslStreamобъекте .

См. также раздел

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

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

NegotiateStream.AuthenticateAsClientAsync Метод

Определение

Перегрузки

AuthenticateAsClientAsync()

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

Исключения

Комментарии

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

AuthenticateAsClientAsync(NetworkCredential, String)

Параметры

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

Исключения

Комментарии

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

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String)

Параметры

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

Исключения

Комментарии

См. также раздел

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

AuthenticateAsClientAsync(NetworkCredential, String, ProtectionLevel, TokenImpersonationLevel)

Параметры

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

Исключения

Комментарии

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

AuthenticateAsClientAsync(NetworkCredential, ChannelBinding, String, ProtectionLevel, TokenImpersonationLevel)

Параметры

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

Исключения

Комментарии

См. также раздел

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

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