RPC_HTTP_TRANSPORT_CREDENTIALS_A 結構 (rpcdce.h)

發行項
03/01/2024

RPC_HTTP_TRANSPORT_CREDENTIALS 結構會定義使用 RPC/HTTP 時要向 RPC Proxy 伺服器進行驗證的其他認證。

語法

typedef struct _RPC_HTTP_TRANSPORT_CREDENTIALS_A {
  SEC_WINNT_AUTH_IDENTITY_A *TransportCredentials;
  unsigned long             Flags;
  unsigned long             AuthenticationTarget;
  unsigned long             NumberOfAuthnSchemes;
  unsigned long             *AuthnSchemes;
  unsigned char             *ServerCertificateSubject;
} RPC_HTTP_TRANSPORT_CREDENTIALS_A, *PRPC_HTTP_TRANSPORT_CREDENTIALS_A;

成員

TransportCredentials

包含用戶使用者名稱、網域和密碼之SEC_WINNT_AUTH_IDENTITY 結構的指標。

Flags

可以與位 OR 運算子結合的一組旗標。

值	意義
RPC_C_HTTP_FLAG_USE_SSL	指示 RPC 使用 SSL 與 RPC Proxy 通訊。
RPC_C_HTTP_FLAG_USE_FIRST_AUTH_SCHEME	設定時，RPC 會選擇 AuthnSchemes 陣列中的第一個配置，並嘗試向 RPC Proxy 進行驗證。如果 RPC Proxy 不支援選取的驗證配置，則呼叫會失敗。未設定時，RPC 用戶端會查詢 RPC Proxy 以取得支援的驗證配置，然後選擇一個。

AuthenticationTarget

指定驗證目標。

應設定為下列其中一個或兩個值：

值	意義
RPC_C_HTTP_AUTHN_TARGET_SERVER	根據 RPC Proxy 進行驗證，這是從 HTTP 觀點來看的 HTTP 伺服器。這是最常見的值。
RPC_C_HTTP_AUTHN_TARGET_PROXY	對 HTTP Proxy 進行驗證。這個值並不常見。

NumberOfAuthnSchemes

AuthnScheme 陣列中的元素數目。

AuthnSchemes

ServerCertificateSubject

包含具有預期伺服器主體名稱的選擇性字串。主體名稱的格式與針對 RpcCertGeneratePrincipalName 產生的格式相同， (如需詳細資訊，請參閱主體名稱以取得) 。只有在使用 SSL 時，才會使用此成員。在這種情況下，系統會根據產生的主體名稱檢查伺服器證書。如果不符合，則會傳回錯誤。此成員可讓客戶端驗證 RPC Proxy。

備註

如果 TransportCredentials 成員為 NULL ，且驗證配置為 NTLM，則會使用目前登入用戶的認證。若要避免透過弱式 LM 哈希在網路上公開用戶認證，只有在下列其中一個或兩個條件都成立時，才會使用使用者登入認證：

呼叫端要求使用 SSL，並使用 ServerCertificateSubject 成員。此案例保證認證在傳輸和最終目的地受到保護，即使使用弱式哈希也一樣。
lncompatibilitylevel 機碼會設定為 2 或更新版本。這會導致 NTLM 安全性提供者只發出或響應強式 NT 哈希，而不是弱式 LM 哈希。此外，建議客戶使用層級 3 或更高版本，這會嘗試NTLMv2。

如果使用 RpcBindingSetAuthInfoEx 函式的 Unicode 版本，也必須提供 RPC_HTTP_TRANSPORT_CREDENTIALS 和 SEC_WINNT_AUTH_IDENTITY 結構的 Unicode 版本，而且 TransportCredentials 中的 Flags 成員必須設定為 SEC_WINNT_AUTH_IDENTITY_UNICODE。如果使用 RpcBindingSetAuthInfoEx 函式的 ANSI 版本，則必須提供RPC_HTTP_TRANSPORT_CREDENTIALS和SEC_WINNT_AUTH_IDENTITY結構的 ANSI 版本，且 TransportCredentials 中的 Flags 成員必須設定為 SEC_WINNT_AUTH_IDENTITY_ANSI。

規格需求

需求	值
最低支援的用戶端	具有 SP1 的 Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	rpcdce.h (包含 Rpc.h)