NegotiateStream.BeginAuthenticateAsServer Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Начинает асинхронную операцию для проверки подлинности серверной стороны соединения клиент-сервер.
Перегрузки
BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object) |
Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер. Процесс проверки подлинности использует заданные учетные данные сервера, параметры проверки подлинности и политику расширенной защиты. Этот метод не блокируется. |
BeginAuthenticateAsServer(AsyncCallback, Object) |
Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер. Этот метод не блокируется. |
BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object) |
Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер. Процесс проверки подлинности использует заданную политику расширенной защиты. Этот метод не блокируется. |
BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object) |
Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер. Процесс проверки подлинности использует заданные учетные данные сервера и параметры проверки подлинности. Этот метод не блокируется. |
Комментарии
Перегрузки этого метода не блокируются во время проверки подлинности. Чтобы выполнить блокировку во время ожидания завершения проверки подлинности AuthenticateAsServer , используйте метод .
BeginAuthenticateAsServer(NetworkCredential, ExtendedProtectionPolicy, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)
- Исходный код:
- NegotiateStream.cs
- Исходный код:
- NegotiateStream.cs
- Исходный код:
- NegotiateStream.cs
Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер. Процесс проверки подлинности использует заданные учетные данные сервера, параметры проверки подлинности и политику расширенной защиты. Этот метод не блокируется.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Net.NetworkCredential credential, System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (credential As NetworkCredential, policy As ExtendedProtectionPolicy, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Параметры
- credential
- NetworkCredential
Учетные данные NetworkCredential, используемые для установления идентификации клиента.
- policy
- ExtendedProtectionPolicy
Объект ExtendedProtectionPolicy, который используется для расширенной защиты.
- requiredProtectionLevel
- ProtectionLevel
Одно из значений перечисления ProtectionLevel, указывающее службы безопасности для потока.
- requiredImpersonationLevel
- TokenImpersonationLevel
Одно из значений перечисления TokenImpersonationLevel, указывающее, как сервер может использовать учетные записи клиента для доступа к ресурсам.
- asyncCallback
- AsyncCallback
Делегат AsyncCallback , который ссылается на метод, вызываемый после выполнения проверки подлинности.
- asyncState
- Object
Пользовательский объект, содержащий сведения об операции записи. Этот объект передается делегату asyncCallback
после завершения операции.
Возвращаемое значение
Объект IAsyncResult, указывающий состояние асинхронной операции.
Исключения
Оба свойства CustomChannelBinding и CustomServiceNames в расширенной политике защиты, переданной параметром policy
, имеют значение null
.
credential
имеет значение null
.
Параметр requiredImpersonationLevel
должен иметь значение Identification, Impersonation или Delegation,
Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.
Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.
Проверка подлинности уже выполнена.
-или-
Этот поток уже использовался ранее при попытке проверки подлинности со стороны клиента. Этот поток нельзя использовать для повторной проверки подлинности со стороны сервера.
Объект закрыт.
Параметру policy
было присвоено значение параметра Always на платформе, которая не поддерживает расширенную защиту.
Системы Windows 95 и Windows 98 не поддерживаются.
Комментарии
Используйте параметр для requiredProtectionLevel
запроса служб безопасности данных, передаваемых с помощью потока, прошедшего проверку подлинности. Например, чтобы данные были зашифрованы и подписаны, укажите EncryptAndSign значение . Успешная проверка подлинности не гарантирует, что запрошенный ProtectionLevel объект был предоставлен. Необходимо проверка IsEncrypted свойства и IsSigned , чтобы определить, какие службы безопасности используются NegotiateStream.
policy
Если параметр имеет значение null
, используется расширенная политика защиты, для которого задано PolicyEnforcement значение Never.
Этот метод является асинхронным и не блокируется во время завершения операции. Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsServer перегрузок метода.
Асинхронную операцию проверки подлинности необходимо завершить путем вызова EndAuthenticateAsServer метода . Как правило, метод вызывается делегатом asyncCallback
. Подробные сведения об использовании асинхронной модели программирования см. в разделе Асинхронный вызов синхронных методов.
Если проверка подлинности завершается сбоем AuthenticationException , вы получите или InvalidCredentialException. В этом случае можно повторить проверку подлинности с другими учетными данными.
См. также раздел
Применяется к
BeginAuthenticateAsServer(AsyncCallback, Object)
- Исходный код:
- NegotiateStream.cs
- Исходный код:
- NegotiateStream.cs
- Исходный код:
- NegotiateStream.cs
Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер. Этот метод не блокируется.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Параметры
- asyncCallback
- AsyncCallback
Делегат AsyncCallback , который ссылается на метод, вызываемый после выполнения проверки подлинности.
- asyncState
- Object
Пользовательский объект, содержащий сведения о данной операции. Этот объект передается делегату asyncCallback
после завершения операции.
Возвращаемое значение
Объект IAsyncResult, указывающий состояние асинхронной операции.
Исключения
Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.
Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.
Объект закрыт.
Системы Windows 95 и Windows 98 не поддерживаются.
Комментарии
Для проверки подлинности используется сервер .DefaultCredentials Имя субъекта-службы (SPN) для сервера не указано. Уровень олицетворения — Identification, уровень безопасности — EncryptAndSign.
После успешной проверки подлинности необходимо проверка IsEncrypted свойства и IsSigned , чтобы определить, какие службы безопасности используются NegotiateStream. Проверьте свойство , IsMutuallyAuthenticated чтобы определить, произошла ли взаимная проверка подлинности.
Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsServer перегрузок метода.
Если проверка подлинности завершается сбоем AuthenticationException , вы получите или InvalidCredentialException. В этом случае можно повторить проверку подлинности с другими учетными данными.
Применяется к
BeginAuthenticateAsServer(ExtendedProtectionPolicy, AsyncCallback, Object)
- Исходный код:
- NegotiateStream.cs
- Исходный код:
- NegotiateStream.cs
- Исходный код:
- NegotiateStream.cs
Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер. Процесс проверки подлинности использует заданную политику расширенной защиты. Этот метод не блокируется.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Security::Authentication::ExtendedProtection::ExtendedProtectionPolicy ^ policy, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy? policy, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy policy, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (policy As ExtendedProtectionPolicy, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Параметры
- policy
- ExtendedProtectionPolicy
Объект ExtendedProtectionPolicy, который используется для расширенной защиты.
- asyncCallback
- AsyncCallback
Делегат AsyncCallback , который ссылается на метод, вызываемый после выполнения проверки подлинности.
- asyncState
- Object
Пользовательский объект, содержащий сведения об операции записи. Этот объект передается делегату asyncCallback
после завершения операции.
Возвращаемое значение
Объект IAsyncResult, указывающий состояние асинхронной операции.
Исключения
Оба свойства CustomChannelBinding и CustomServiceNames в расширенной политике защиты, переданной параметром policy
, имеют значение null
.
Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.
Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.
Объект закрыт.
Параметру policy
было присвоено значение параметра Always на платформе, которая не поддерживает расширенную защиту.
Системы Windows 95 и Windows 98 не поддерживаются.
Комментарии
Для проверки подлинности используется сервер .DefaultCredentials Имя субъекта-службы (SPN) для сервера не указано. Уровень олицетворения — Identification, уровень безопасности — EncryptAndSign.
policy
Если параметр имеет значение null
, используется расширенная политика защиты, для которого задано PolicyEnforcement значение Never.
После успешной проверки подлинности необходимо проверка IsEncrypted свойства и IsSigned , чтобы определить, какие службы безопасности используются NegotiateStream. Проверьте свойство , IsMutuallyAuthenticated чтобы определить, произошла ли взаимная проверка подлинности.
Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsServer перегрузок метода.
Если проверка подлинности завершается сбоем AuthenticationException , вы получите или InvalidCredentialException. В этом случае можно повторить проверку подлинности с другими учетными данными.
См. также раздел
Применяется к
BeginAuthenticateAsServer(NetworkCredential, ProtectionLevel, TokenImpersonationLevel, AsyncCallback, Object)
- Исходный код:
- NegotiateStream.cs
- Исходный код:
- NegotiateStream.cs
- Исходный код:
- NegotiateStream.cs
Вызывается серверами для начала асинхронной операции проверки подлинности клиента, и, при необходимости, сервера в соединении клиент-сервер. Процесс проверки подлинности использует заданные учетные данные сервера и параметры проверки подлинности. Этот метод не блокируется.
public:
virtual IAsyncResult ^ BeginAuthenticateAsServer(System::Net::NetworkCredential ^ credential, System::Net::Security::ProtectionLevel requiredProtectionLevel, System::Security::Principal::TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback ^ asyncCallback, System::Object ^ asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback? asyncCallback, object? asyncState);
public virtual IAsyncResult BeginAuthenticateAsServer (System.Net.NetworkCredential credential, System.Net.Security.ProtectionLevel requiredProtectionLevel, System.Security.Principal.TokenImpersonationLevel requiredImpersonationLevel, AsyncCallback asyncCallback, object asyncState);
abstract member BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult
override this.BeginAuthenticateAsServer : System.Net.NetworkCredential * System.Net.Security.ProtectionLevel * System.Security.Principal.TokenImpersonationLevel * AsyncCallback * obj -> IAsyncResult
Public Overridable Function BeginAuthenticateAsServer (credential As NetworkCredential, requiredProtectionLevel As ProtectionLevel, requiredImpersonationLevel As TokenImpersonationLevel, asyncCallback As AsyncCallback, asyncState As Object) As IAsyncResult
Параметры
- credential
- NetworkCredential
Учетные данные NetworkCredential, используемые для установления идентификации клиента.
- requiredProtectionLevel
- ProtectionLevel
Одно из значений перечисления ProtectionLevel, указывающее службы безопасности для потока.
- requiredImpersonationLevel
- TokenImpersonationLevel
Одно из значений перечисления TokenImpersonationLevel, указывающее, как сервер может использовать учетные записи клиента для доступа к ресурсам.
- asyncCallback
- AsyncCallback
Делегат AsyncCallback , который ссылается на метод, вызываемый после выполнения проверки подлинности.
- asyncState
- Object
Пользовательский объект, содержащий сведения о данной операции. Этот объект передается делегату asyncCallback
после завершения операции.
Возвращаемое значение
Объект IAsyncResult, указывающий состояние асинхронной операции.
Исключения
credential
имеет значение null
.
Параметр requiredImpersonationLevel
должен иметь значение Identification, Impersonation или Delegation,
Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.
Сбой проверки подлинности. Этот объект можно использовать для повторной проверки подлинности.
Объект закрыт.
Проверка подлинности уже выполнена.
-или-
Этот поток уже использовался ранее при попытке проверки подлинности со стороны клиента. Этот поток нельзя использовать для повторной проверки подлинности со стороны сервера.
Системы Windows 95 и Windows 98 не поддерживаются.
Комментарии
Используйте параметр для requiredProtectionLevel
запроса служб безопасности данных, передаваемых с помощью потока, прошедшего проверку подлинности. Например, чтобы данные были зашифрованы и подписаны, укажите EncryptAndSign значение . Успешная проверка подлинности не гарантирует, что запрошенный ProtectionLevel объект был предоставлен. Необходимо проверка IsEncrypted свойства и IsSigned , чтобы определить, какие службы безопасности используются NegotiateStream.
Этот метод является асинхронным и не блокируется во время завершения операции. Чтобы заблокировать до завершения операции, используйте одну из AuthenticateAsServer перегрузок метода.
Асинхронную операцию проверки подлинности необходимо завершить путем вызова EndAuthenticateAsServer метода . Как правило, метод вызывается делегатом asyncCallback
. Подробные сведения об использовании асинхронной модели программирования см. в разделе Асинхронный вызов синхронных методов.
Если проверка подлинности завершается сбоем AuthenticationException , вы получите или InvalidCredentialException. В этом случае можно повторить проверку подлинности с другими учетными данными.