struttura HTTP_SERVER_AUTHENTICATION_INFO (http.h)

Articolo
08/24/2023

La struttura HTTP_SERVER_AUTHENTICATION_INFO viene usata per abilitare l'autenticazione lato server in un gruppo di URL o in una sessione del server. Questa struttura viene usata anche per eseguire query negli schemi di autenticazione esistenti abilitati per un gruppo di URL o una sessione del server.

Questa struttura deve essere utilizzata quando si imposta o si esegue una query su HttpServerAuthenticationProperty in un gruppo di URL o in una sessione del server.

Sintassi

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

Struttura HTTP_PROPERTY_FLAGS che specifica se la proprietà è presente.

AuthSchemes

Schemi di autenticazione supportati. Può trattarsi di una o più delle opzioni seguenti:

Schema di autenticazione	Significato
HTTP_AUTH_ENABLE_BASIC	L'autenticazione di base è abilitata.
HTTP_AUTH_ENABLE_DIGEST	L'autenticazione del digest è abilitata.
HTTP_AUTH_ENABLE_NTLM	L'autenticazione NTLM è abilitata.
HTTP_AUTH_ENABLE_NEGOTIATE	L'autenticazione negoziata è abilitata.
HTTP_AUTH_ENABLE_KERBEROS	L'autenticazione Kerberos è abilitata.
HTTP_AUTH_ENABLE_ALL	Tutti i tipi di autenticazione sono abilitati.

ReceiveMutualAuth

Valore booleano che indica, se True, che l'applicazione client riceve le credenziali del server per l'autenticazione reciproca con la richiesta autenticata. Se False, l'applicazione client non riceve le credenziali.

Tenere presente che questa opzione è impostata per tutte le richieste gestite dalla coda di richieste associata.

ReceiveContextHandle

Valore booleano che indica, se True, che il contesto client finalizzato viene serializzato e passato all'applicazione con la richiesta. Se False, l'applicazione non riceve il contesto. Questo handle può essere usato per eseguire query sugli attributi del contesto.

DisableNTLMCredentialCaching

Valore booleano che indica, se True, che le credenziali NTLM non vengono memorizzate nella cache. Se False, il comportamento predefinito viene mantenuto.

Per impostazione predefinita, HTTP memorizza nella cache il contesto client per le connessioni Keep Alive (KA) per lo schema NTLM se la richiesta non ha avuto origine da un proxy.

ExFlags

Flag di autenticazione facoltativi. Può essere uno o più dei valori possibili seguenti:

Valore	Significato
HTTP_AUTH_EX_FLAG_ENABLE_KERBEROS_CREDENTIAL_CACHING	Se impostata, le credenziali di autenticazione Kerberos vengono memorizzate nella cache. L'autenticazione Kerberos o Negotiate deve essere abilitata da AuthSchemes.
HTTP_AUTH_EX_FLAG_CAPTURE_CREDENTIAL	Se impostata, l'API server HTTP acquisisce le credenziali del chiamante e le usa per l'autenticazione Kerberos o Negotiate. L'autenticazione Kerberos o Negotiate deve essere abilitata da AuthSchemes.

DigestParams

Struttura HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS che fornisce il dominio e l'area di autenticazione per la richiesta di digest.

BasicParams

Struttura HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS che fornisce l'area di autenticazione per la sfida di base.

Commenti

La struttura HTTP_SERVER_AUTHENTICATION_INFO è inclusa nella richiesta HTTP se l'autenticazione è stata configurata nel gruppo di URL associato. L'intestazione di autenticazione HTTP originale ricevuta dal client è sempre inclusa nella richiesta HTTP, indipendentemente dallo stato di autenticazione.