struktur HTTP_SERVER_AUTHENTICATION_INFO (http.h)

  • Artikel

Struktur HTTP_SERVER_AUTHENTICATION_INFO digunakan untuk mengaktifkan autentikasi sisi server pada grup URL atau sesi server. Struktur ini juga digunakan untuk mengkueri skema autentikasi yang ada yang diaktifkan untuk grup URL atau sesi server.

Struktur ini harus digunakan saat mengatur atau mengkueri HttpServerAuthenticationProperty pada grup URL, atau sesi server.

Sintaks

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;

Anggota

Flags

Struktur HTTP_PROPERTY_FLAGS yang menentukan apakah properti ada.

AuthSchemes

Skema autentikasi yang didukung. Ini bisa berupa satu atau beberapa hal berikut:

Skema Autentikasi Makna
HTTP_AUTH_ENABLE_BASIC
 Autentikasi dasar diaktifkan.
HTTP_AUTH_ENABLE_DIGEST
 Autentikasi hash diaktifkan.
HTTP_AUTH_ENABLE_NTLM
 Autentikasi NTLM diaktifkan.
HTTP_AUTH_ENABLE_NEGOTIATE
 Autentikasi negosiasi diaktifkan.
HTTP_AUTH_ENABLE_KERBEROS
 Autentikasi Kerberos diaktifkan.
HTTP_AUTH_ENABLE_ALL
 Semua jenis autentikasi diaktifkan.

ReceiveMutualAuth

Nilai Boolean yang menunjukkan, jika True, bahwa aplikasi klien menerima kredensial server untuk autentikasi bersama dengan permintaan yang diautentikasi. Jika False, aplikasi klien tidak menerima kredensial.

Ketahuilah bahwa opsi ini diatur untuk semua permintaan yang dilayani oleh antrean permintaan terkait.

ReceiveContextHandle

Nilai Boolean yang menunjukkan, jika True, bahwa konteks klien yang diselesaikan diserialisasikan dan diteruskan ke aplikasi dengan permintaan. Jika False, aplikasi tidak menerima konteks. Handel ini dapat digunakan untuk mengkueri atribut konteks.

DisableNTLMCredentialCaching

Nilai Boolean yang menunjukkan, jika True, bahwa kredensial NTLM tidak di-cache. Jika False, perilaku default dipertahankan.

Secara default, HTTP menyimpan konteks klien untuk koneksi Keep Alive (KA) untuk skema NTLM jika permintaan tidak berasal dari proksi.

ExFlags

Bendera autentikasi opsional. Dapat berupa satu atau beberapa nilai yang mungkin berikut ini:

Nilai Makna
HTTP_AUTH_EX_FLAG_ENABLE_KERBEROS_CREDENTIAL_CACHING
 Jika diatur, kredensial autentikasi Kerberos di-cache. Autentikasi Kerberos atau Negosiasi harus diaktifkan oleh AuthSchemes.
HTTP_AUTH_EX_FLAG_CAPTURE_CREDENTIAL
 Jika disetel, HTTP Server API mengambil kredensial penelepon dan menggunakannya untuk Kerberos atau Negosiasikan autentikasi. Autentikasi Kerberos atau Negosiasi harus diaktifkan oleh AuthSchemes.

DigestParams

Struktur HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS yang menyediakan domain dan ranah untuk tantangan hash.

BasicParams

Struktur HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS yang menyediakan ranah untuk tantangan dasar.

Keterangan

Struktur HTTP_SERVER_AUTHENTICATION_INFO disertakan dalam permintaan HTTP jika autentikasi telah dikonfigurasi pada grup URL terkait. Header autentikasi HTTP asli yang diterima dari klien selalu disertakan dalam permintaan HTTP, terlepas dari status autentikasi.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header http.h

Lihat juga

Struktur HTTP Server API Versi 2.0

HTTP_AUTH_ENABLE

HTTP_SERVER_PROPERTY

HttpQueryUrlGroupProperty

HttpSetUrlGroupProperty