structure HTTP_SERVER_AUTHENTICATION_INFO (http.h)

  • Article

La structure HTTP_SERVER_AUTHENTICATION_INFO est utilisée pour activer l’authentification côté serveur sur un groupe d’URL ou une session serveur. Cette structure est également utilisée pour interroger les schémas d’authentification existants activés pour un groupe d’URL ou une session serveur.

Cette structure doit être utilisée lors de la définition ou de l’interrogation de HttpServerAuthenticationProperty sur un groupe d’URL ou une session serveur.

Syntaxe

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;

Membres

Flags

La structure HTTP_PROPERTY_FLAGS qui spécifie si la propriété est présente.

AuthSchemes

Schémas d’authentification pris en charge. Il peut s’agir de l’un ou plusieurs des éléments suivants :

Schéma d'authentification Signification
HTTP_AUTH_ENABLE_BASIC
 L’authentification de base est activée.
HTTP_AUTH_ENABLE_DIGEST
 L’authentification Digest est activée.
HTTP_AUTH_ENABLE_NTLM
 L’authentification NTLM est activée.
HTTP_AUTH_ENABLE_NEGOTIATE
 Négocier l’authentification est activée.
HTTP_AUTH_ENABLE_KERBEROS
 L’authentification Kerberos est activée.
HTTP_AUTH_ENABLE_ALL
 Tous les types d’authentification sont activés.

ReceiveMutualAuth

Valeur booléenne qui indique, si true, que l’application cliente reçoit les informations d’identification du serveur pour l’authentification mutuelle avec la demande authentifiée. Si la valeur est False, l’application cliente ne reçoit pas les informations d’identification.

N’oubliez pas que cette option est définie pour toutes les requêtes traitées par la file d’attente de requêtes associée.

ReceiveContextHandle

Valeur booléenne qui indique, si true, que le contexte client finalisé est sérialisé et passé à l’application avec la demande. Si la valeur est False, l’application ne reçoit pas le contexte. Ce handle peut être utilisé pour interroger des attributs de contexte.

DisableNTLMCredentialCaching

Valeur booléenne qui indique, si true, que les informations d’identification NTLM ne sont pas mises en cache. Si la valeur est False, le comportement par défaut est conservé.

Par défaut, HTTP met en cache le contexte client pour les connexions Keep Alive (KA) pour le schéma NTLM si la demande ne provient pas d’un proxy.

ExFlags

Indicateurs d’authentification facultatifs. Il peut s’agir d’une ou plusieurs des valeurs possibles suivantes :

Valeur Signification
HTTP_AUTH_EX_FLAG_ENABLE_KERBEROS_CREDENTIAL_CACHING
 Si cette valeur est définie, les informations d’identification d’authentification Kerberos sont mises en cache. L’authentification Kerberos ou Négocier doit être activée par AuthSchemes.
HTTP_AUTH_EX_FLAG_CAPTURE_CREDENTIAL
 Si elle est définie, l’API serveur HTTP capture les informations d’identification de l’appelant et les utilise pour l’authentification Kerberos ou Negotiate. L’authentification Kerberos ou Négocier doit être activée par AuthSchemes.

DigestParams

La structure HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS qui fournit le domaine et le domaine pour la tâche de synthèse.

BasicParams

La structure HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS qui fournit le domaine pour le défi de base.

Notes

La structure HTTP_SERVER_AUTHENTICATION_INFO est incluse dans la requête HTTP si l’authentification a été configurée sur le groupe d’URL associé. L’en-tête d’authentification HTTP d’origine reçu du client est toujours inclus dans la requête HTTP, quelle que soit la status d’authentification.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête http.h

Voir aussi

Structures de l’API serveur HTTP version 2.0

HTTP_AUTH_ENABLE

HTTP_SERVER_PROPERTY

HttpQueryUrlGroupProperty

HttpSetUrlGroupProperty