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

структура HTTP_SERVER_AUTHENTICATION_INFO (http.h)

  • Статья

Структура HTTP_SERVER_AUTHENTICATION_INFO используется для включения проверки подлинности на стороне сервера в группе URL-адресов или сеансе сервера. Эта структура также используется для запроса существующих схем проверки подлинности, включенных для группы URL-адресов или сеанса сервера.

Эту структуру необходимо использовать при задании или запросе httpServerAuthenticationProperty в группе URL-адресов или сеансе сервера.

Синтаксис

typedef struct _HTTP_SERVER_AUTHENTICATION_INFO {
  HTTP_PROPERTY_FLAGS                      Flags;
  ULONG                                    AuthSchemes;
  BOOLEAN                                  ReceiveMutualAuth;
  BOOLEAN                                  ReceiveContextHandle;
  BOOLEAN                                  DisableNTLMCredentialCaching;
  UCHAR                                    ExFlags;
  HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS DigestParams;
  HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS  BasicParams;
} HTTP_SERVER_AUTHENTICATION_INFO, *PHTTP_SERVER_AUTHENTICATION_INFO;

Члены

Flags

Структура HTTP_PROPERTY_FLAGS , указывающая, присутствует ли свойство.

AuthSchemes

Поддерживаемые схемы проверки подлинности. Это может быть один или несколько из следующих вариантов:

Схема проверки подлинности Значение
HTTP_AUTH_ENABLE_BASIC
 Включена обычная проверка подлинности.
HTTP_AUTH_ENABLE_DIGEST
 Дайджест-проверка подлинности включена.
HTTP_AUTH_ENABLE_NTLM
 Проверка подлинности NTLM включена.
HTTP_AUTH_ENABLE_NEGOTIATE
 Проверка подлинности с согласованием включена.
HTTP_AUTH_ENABLE_KERBEROS
 Проверка подлинности Kerberos включена.
HTTP_AUTH_ENABLE_ALL
 Включены все типы проверки подлинности.

ReceiveMutualAuth

Логическое значение, указывающее , если значение True, указывает, что клиентское приложение получает учетные данные сервера для взаимной проверки подлинности с помощью запроса, прошедшего проверку подлинности. Значение False означает, что клиентское приложение не получает учетные данные.

Имейте в виду, что этот параметр установлен для всех запросов, обслуживаемых связанной очередью запросов.

ReceiveContextHandle

Логическое значение, указывающее ( если значение True) указывает, что завершенный контекст клиента сериализуется и передается приложению с запросом. Если задано значение False, приложение не получает контекст. Этот дескриптор можно использовать для запроса атрибутов контекста.

DisableNTLMCredentialCaching

Логическое значение, указывающее , если значение True, указывает, что учетные данные NTLM не кэшируются. Если задано значение False, поведение по умолчанию сохраняется.

По умолчанию HTTP кэширует контекст клиента для подключений Keep Alive (KA) для схемы NTLM, если запрос не поступил от прокси-сервера.

ExFlags

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

Значение Значение
HTTP_AUTH_EX_FLAG_ENABLE_KERBEROS_CREDENTIAL_CACHING
 Если этот параметр задан, учетные данные проверки подлинности Kerberos кэшируются. Проверка подлинности Kerberos или Negotiate должна быть включена с помощью AuthSchemes.
HTTP_AUTH_EX_FLAG_CAPTURE_CREDENTIAL
 Если этот параметр задан, API HTTP-сервера записывает учетные данные вызывающего объекта и использует их для проверки подлинности Kerberos или Negotiate. Проверка подлинности Kerberos или Negotiate должна быть включена с помощью AuthSchemes.

DigestParams

Структура HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS , которая предоставляет домен и область для задачи дайджеста.

BasicParams

Структура HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS , которая предоставляет область для основной задачи.

Комментарии

Структура HTTP_SERVER_AUTHENTICATION_INFO включается в HTTP-запрос, если для связанной группы URL-адресов настроена проверка подлинности. Исходный заголовок проверки подлинности HTTP, полученный от клиента, всегда включается в HTTP-запрос, независимо от состояния проверки подлинности.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть http.h

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

Структуры API HTTP-сервера версии 2.0

HTTP_AUTH_ENABLE

HTTP_SERVER_PROPERTY

HttpQueryUrlGroupProperty

HttpSetUrlGroupProperty