HTTP_SERVER_AUTHENTICATION_INFO 구조체(http.h)

  • 아티클

HTTP_SERVER_AUTHENTICATION_INFO 구조는 URL 그룹 또는 서버 세션에서 서버 쪽 인증을 사용하도록 설정하는 데 사용됩니다. 이 구조는 URL 그룹 또는 서버 세션에 사용하도록 설정된 기존 인증 체계를 쿼리하는 데도 사용됩니다.

이 구조체는 URL 그룹 또는 서버 세션에서 HttpServerAuthenticationProperty 를 설정하거나 쿼리할 때 사용해야 합니다.

구문

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;

멤버

Flags

속성이 있는지를 지정하는 HTTP_PROPERTY_FLAGS 구조체입니다.

AuthSchemes

지원되는 인증 체계입니다. 다음 중 하나 이상이 될 수 있습니다.

인증 스키마 의미
HTTP_AUTH_ENABLE_BASIC
 기본 인증을 사용할 수 있습니다.
HTTP_AUTH_ENABLE_DIGEST
 다이제스트 인증이 사용됩니다.
HTTP_AUTH_ENABLE_NTLM
 NTLM 인증이 사용됩니다.
HTTP_AUTH_ENABLE_NEGOTIATE
 협상 인증을 사용할 수 있습니다.
HTTP_AUTH_ENABLE_KERBEROS
 Kerberos 인증이 사용됩니다.
HTTP_AUTH_ENABLE_ALL
 모든 유형의 인증을 사용할 수 있습니다.

ReceiveMutualAuth

True이면 클라이언트 애플리케이션이 인증된 요청을 사용하여 상호 인증을 위한 서버 자격 증명을 수신한다는 것을 나타내는 부울 값입니다. False이면 클라이언트 애플리케이션이 자격 증명을 받지 않습니다.

이 옵션은 연결된 요청 큐에서 제공하는 모든 요청에 대해 설정됩니다.

ReceiveContextHandle

True이면 종료된 클라이언트 컨텍스트가 직렬화되어 요청과 함께 애플리케이션에 전달됨을 나타내는 부울 값입니다. False이면 애플리케이션이 컨텍스트를 수신하지 않습니다. 이 핸들은 컨텍스트 특성을 쿼리하는 데 사용할 수 있습니다.

DisableNTLMCredentialCaching

True이면 NTLM 자격 증명이 캐시되지 않음을 나타내는 부울 값입니다. False이면 기본 동작이 유지됩니다.

기본적으로 HTTP는 요청이 프록시에서 시작되지 않은 경우 NTLM 스키마에 대한 KA(Keep Alive) 연결에 대한 클라이언트 컨텍스트를 캐시합니다.

ExFlags

선택적 인증 플래그입니다. 다음 가능한 값 중 하나 이상일 수 있습니다.

값 의미
HTTP_AUTH_EX_FLAG_ENABLE_KERBEROS_CREDENTIAL_CACHING
 설정된 경우 Kerberos 인증 자격 증명이 캐시됩니다. AuthSchemes에서 Kerberos 또는 Negotiate 인증을 사용하도록 설정해야 합니다.
HTTP_AUTH_EX_FLAG_CAPTURE_CREDENTIAL
 설정된 경우 HTTP Server API는 호출자의 자격 증명을 캡처하고 Kerberos 또는 협상 인증에 사용합니다. AuthSchemes에서 Kerberos 또는 Negotiate 인증을 사용하도록 설정해야 합니다.

DigestParams

다이제스트 챌린지에 대한 도메인과 영역을 제공하는 HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS 구조입니다.

BasicParams

기본 과제에 대한 영역을 제공하는 HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS 구조입니다.

설명

연결된 URL 그룹에 인증이 구성된 경우 HTTP_SERVER_AUTHENTICATION_INFO 구조가 HTTP 요청에 포함됩니다. 클라이언트에서 받은 원래 HTTP 인증 헤더는 인증 상태 관계없이 항상 HTTP 요청에 포함됩니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 http.h

참고 항목

HTTP Server API 버전 2.0 구조체

HTTP_AUTH_ENABLE

HTTP_SERVER_PROPERTY

HttpQueryUrlGroupProperty

HttpSetUrlGroupProperty