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

NegotiateStream.AuthenticateAsServerAsync Метод

  • Ссылка

Определение

Пространство имен:
System.Net.Security
Сборка:
System.Net.Security.dll
Сборка:
System.dll
Сборка:
netstandard.dll

Обрабатывает серверную сторону аутентификации для соединения клиент-сервер как асинхронная операция.

Перегрузки

AuthenticateAsServerAsync()

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

Вызывается серверами аутентификации клиента, и, при необходимости, сервера в соединении клиент-сервер как асинхронная операция. Процесс проверки подлинности использует заданную политику расширенной защиты.
AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)

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

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

AuthenticateAsServerAsync()

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync();
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync ();
abstract member AuthenticateAsServerAsync : unit -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : unit -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync () As Task

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

Task

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

Исключения

AuthenticationException

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

InvalidCredentialException

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

ObjectDisposedException

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

NotSupportedException

Системы Windows 95 и Windows 98 не поддерживаются.

Комментарии

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

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

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

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

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

AuthenticateAsServerAsync(ExtendedProtectionPolicy)

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy);
abstract member AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (policy As ExtendedProtectionPolicy) As Task

Параметры

policy
ExtendedProtectionPolicy

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

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

Task

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

Исключения

ArgumentException

Оба свойства CustomChannelBinding и CustomServiceNames в расширенной политике защиты, переданной параметром policy, имеют значение null.

AuthenticationException

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

InvalidCredentialException

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

ObjectDisposedException

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

PlatformNotSupportedException

Параметру policy было присвоено значение параметра Always на платформе, которая не поддерживает расширенную защиту.

NotSupportedException

Системы Windows 95 и Windows 98 не поддерживаются.

Комментарии

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

policy Если параметр имеет значение null, используется расширенная политика защиты, для которого задано PolicyEnforcement значение Never.

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

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

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

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

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

AuthenticateAsServerAsync(NetworkCredential, ProtectionLevel, TokenImpersonationLevel)

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As Task

Параметры

credential
NetworkCredential

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

requiredProtectionLevel
ProtectionLevel

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

requiredImpersonationLevel
TokenImpersonationLevel

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

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

Task

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

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

Параметр requiredImpersonationLevel должен иметь значение Identification, Impersonation или Delegation,

AuthenticationException

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

InvalidCredentialException

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

ObjectDisposedException

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

InvalidOperationException

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

-или-

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

NotSupportedException

Системы Windows 95 и Windows 98 не поддерживаются.

Комментарии

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

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

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

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

AuthenticateAsServerAsync(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel)

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

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

public:
 virtual System::Threading::Tasks::Task ^ AuthenticateAsServerAsync(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
public virtual System.Threading.Tasks.Task AuthenticateAsServerAsync (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel);
abstract member AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
override this.AuthenticateAsServerAsync : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel -> System.Threading.Tasks.Task
Public Overridable Function AuthenticateAsServerAsync (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel) As Task

Параметры

credential
NetworkCredential

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

policy
ExtendedProtectionPolicy

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

requiredProtectionLevel
ProtectionLevel

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

requiredImpersonationLevel
TokenImpersonationLevel

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

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

Task

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

Исключения

ArgumentException

Оба свойства CustomChannelBinding и CustomServiceNames в расширенной политике защиты, переданной параметром policy, имеют значение null.

ArgumentNullException

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

ArgumentOutOfRangeException

Параметр requiredImpersonationLevel должен иметь значение Identification, Impersonation или Delegation,

AuthenticationException

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

InvalidCredentialException

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

InvalidOperationException

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

-или-

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

ObjectDisposedException

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

PlatformNotSupportedException

Параметру policy было присвоено значение параметра Always на платформе, которая не поддерживает расширенную защиту.

NotSupportedException

Системы Windows 95 и Windows 98 не поддерживаются.

Комментарии

policy Если параметр имеет значение null, используется расширенная политика защиты, для которого задано PolicyEnforcement значение Never.

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

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

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

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

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