estrutura HTTP_SERVER_AUTHENTICATION_INFO (http.h)

A estrutura HTTP_SERVER_AUTHENTICATION_INFO é usada para habilitar a autenticação do lado do servidor em um grupo de URLs ou sessão de servidor. Essa estrutura também é usada para consultar os esquemas de autenticação existentes habilitados para um grupo de URLs ou sessão de servidor.

Essa estrutura deve ser usada ao definir ou consultar o HttpServerAuthenticationProperty em um grupo de URLs ou sessão de servidor.

Sintaxe

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;

Membros

Flags

A estrutura HTTP_PROPERTY_FLAGS que especifica se a propriedade está presente.

AuthSchemes

Os esquemas de autenticação com suporte. Isso pode ser um ou mais dos seguintes:

Esquema de Autenticação	Significado
HTTP_AUTH_ENABLE_BASIC	A autenticação básica está habilitada.
HTTP_AUTH_ENABLE_DIGEST	A autenticação digest está habilitada.
HTTP_AUTH_ENABLE_NTLM	A autenticação NTLM está habilitada.
HTTP_AUTH_ENABLE_NEGOTIATE	A autenticação Negotiate está habilitada.
HTTP_AUTH_ENABLE_KERBEROS	A autenticação Kerberos está habilitada.
HTTP_AUTH_ENABLE_ALL	Todos os tipos de autenticação estão habilitados.

ReceiveMutualAuth

Um valor booliano que indica, se True, que o aplicativo cliente recebe as credenciais do servidor para autenticação mútua com a solicitação autenticada. Se False, o aplicativo cliente não receberá as credenciais.

Lembre-se de que essa opção está definida para todas as solicitações atendidas pela fila de solicitações associada.

ReceiveContextHandle

Um valor booliano que indica, se True, que o contexto do cliente finalizado é serializado e passado para o aplicativo com a solicitação. Se False, o aplicativo não receberá o contexto. Esse identificador pode ser usado para consultar atributos de contexto.

DisableNTLMCredentialCaching

Um valor booliano que indica, se True, que as credenciais NTLM não são armazenadas em cache. Se False, o comportamento padrão será preservado.

Por padrão, HTTP armazenará em cache o contexto do cliente para conexões KA (Keep Alive) para o esquema NTLM se a solicitação não tiver se originado de um proxy.

ExFlags

Sinalizadores de autenticação opcionais. Pode ser um ou mais dos seguintes valores possíveis:

Valor	Significado
HTTP_AUTH_EX_FLAG_ENABLE_KERBEROS_CREDENTIAL_CACHING	Se definido, as credenciais de autenticação Kerberos serão armazenadas em cache. A autenticação Kerberos ou Negotiate deve ser habilitada pelo AuthSchemes.
HTTP_AUTH_EX_FLAG_CAPTURE_CREDENTIAL	Se definida, a API do Servidor HTTP capturará as credenciais do chamador e as usará para autenticação Kerberos ou Negotiate. A autenticação Kerberos ou Negotiate deve ser habilitada pelo AuthSchemes.

DigestParams

A estrutura HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS que fornece o domínio e o realm para o desafio de resumo.

BasicParams

A estrutura HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS que fornece o realm para o desafio básico.

Comentários

A estrutura HTTP_SERVER_AUTHENTICATION_INFO será incluída na solicitação HTTP se a autenticação tiver sido configurada no grupo de URL associado. O cabeçalho de autenticação HTTP original recebido do cliente é sempre incluído na solicitação HTTP, independentemente do status de autenticação.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	http.h

Confira também

Estruturas da API do Servidor HTTP versão 2.0

HTTP_AUTH_ENABLE

HTTP_SERVER_PROPERTY

HttpQueryUrlGroupProperty

HttpSetUrlGroupProperty