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

サポートされている認証スキーム。 これには、次の 1 つ以上を指定できます。

認証方式 説明
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 スキームの Keep Alive (KA) 接続のクライアント コンテキストをキャッシュします。

ExFlags

オプションの認証フラグ。 使用できる値は、次の 1 つ以上です。

値 説明
HTTP_AUTH_EX_FLAG_ENABLE_KERBEROS_CREDENTIAL_CACHING
 設定すると、Kerberos 認証資格情報がキャッシュされます。 Kerberos 認証またはネゴシエート認証は 、AuthSchemes によって有効にする必要があります。
HTTP_AUTH_EX_FLAG_CAPTURE_CREDENTIAL
 設定されている場合、HTTP Server API は呼び出し元の資格情報をキャプチャし、Kerberos またはネゴシエート認証に使用します。 Kerberos 認証またはネゴシエート認証は 、AuthSchemes によって有効にする必要があります。

DigestParams

ダイジェスト チャレンジのドメインと領域を提供する HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS 構造体。

BasicParams

基本的な課題の領域を提供する HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS 構造体。

解説

関連付けられた URL グループで認証が構成されている場合は、http 要求に HTTP_SERVER_AUTHENTICATION_INFO 構造が含まれます。 クライアントから受信した元の HTTP 認証ヘッダーは、認証状態に関係なく、常に HTTP 要求に含まれます。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header http.h

関連項目

HTTP Server API バージョン 2.0 構造体

HTTP_AUTH_ENABLE

HTTP_SERVER_PROPERTY

HttpQueryUrlGroupProperty

HttpSetUrlGroupProperty