estructura HTTP_SERVER_AUTHENTICATION_INFO (http.h)

La estructura de HTTP_SERVER_AUTHENTICATION_INFO se usa para habilitar la autenticación del lado servidor en un grupo de direcciones URL o una sesión de servidor. Esta estructura también se usa para consultar los esquemas de autenticación existentes habilitados para un grupo de direcciones URL o una sesión de servidor.

Esta estructura debe usarse al establecer o consultar HttpServerAuthenticationProperty en un grupo de direcciones URL o en una sesión de servidor.

Sintaxis

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;

Members

Flags

Estructura HTTP_PROPERTY_FLAGS que especifica si la propiedad está presente.

AuthSchemes

Esquemas de autenticación admitidos. Puede ser uno o varios de los siguientes:

Esquema de autenticación	Significado
HTTP_AUTH_ENABLE_BASIC	La autenticación básica está habilitada.
HTTP_AUTH_ENABLE_DIGEST	La autenticación implícita está habilitada.
HTTP_AUTH_ENABLE_NTLM	La autenticación NTLM está habilitada.
HTTP_AUTH_ENABLE_NEGOTIATE	La autenticación negotiate está habilitada.
HTTP_AUTH_ENABLE_KERBEROS	La autenticación Kerberos está habilitada.
HTTP_AUTH_ENABLE_ALL	Todos los tipos de autenticación están habilitados.

ReceiveMutualAuth

Valor booleano que indica, si es True, que la aplicación cliente recibe las credenciales del servidor para la autenticación mutua con la solicitud autenticada. Si es False, la aplicación cliente no recibe las credenciales.

Tenga en cuenta que esta opción está establecida para todas las solicitudes que atiende la cola de solicitudes asociadas.

ReceiveContextHandle

Valor booleano que indica, si es True, que el contexto de cliente finalizado se serializa y se pasa a la aplicación con la solicitud. Si es False, la aplicación no recibe el contexto. Este identificador se puede usar para consultar atributos de contexto.

DisableNTLMCredentialCaching

Valor booleano que indica, si es True, que las credenciales NTLM no se almacenan en caché. Si es False, se conserva el comportamiento predeterminado.

De forma predeterminada, HTTP almacena en caché el contexto de cliente para las conexiones Keep Alive (KA) para el esquema NTLM si la solicitud no se originó en un proxy.

ExFlags

Marcas de autenticación opcionales. Puede ser uno o varios de los siguientes valores posibles:

Valor	Significado
HTTP_AUTH_EX_FLAG_ENABLE_KERBEROS_CREDENTIAL_CACHING	Si se establece, las credenciales de autenticación Kerberos se almacenan en caché. La autenticación Kerberos o Negotiate debe estar habilitada por AuthSchemes.
HTTP_AUTH_EX_FLAG_CAPTURE_CREDENTIAL	Si se establece, la API del servidor HTTP captura las credenciales del autor de la llamada y las usa para la autenticación Kerberos o Negotiate. La autenticación Kerberos o Negotiate debe estar habilitada por AuthSchemes.

DigestParams

Estructura HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS que proporciona el dominio y el dominio para el desafío de resumen.

BasicParams

Estructura HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS que proporciona el dominio del desafío básico.

Comentarios

La estructura HTTP_SERVER_AUTHENTICATION_INFO se incluye en la solicitud HTTP si la autenticación se ha configurado en el grupo de direcciones URL asociadas. El encabezado de autenticación HTTP original recibido del cliente siempre se incluye en la solicitud HTTP, independientemente del estado de autenticación.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	http.h

Consulte también

Estructuras de la API de servidor HTTP versión 2.0

HTTP_AUTH_ENABLE

HTTP_SERVER_PROPERTY

HttpQueryUrlGroupProperty

HttpSetUrlGroupProperty