estructura HTTP_SERVER_AUTHENTICATION_INFO (http.h)

  • Artículo

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