IPSEC_SA_BUNDLE0 結構 (ipsectypes.h)

發行項
08/24/2023

IPSEC_SA_BUNDLE0結構可用來儲存 SA) 套件組合 (IPsec 安全性關聯的相關資訊。 IPSEC_SA_BUNDLE1 可供使用。

語法

typedef struct IPSEC_SA_BUNDLE0_ {
  UINT32                 flags;
  IPSEC_SA_LIFETIME0     lifetime;
  UINT32                 idleTimeoutSeconds;
  UINT32                 ndAllowClearTimeoutSeconds;
  IPSEC_ID0              *ipsecId;
  UINT32                 napContext;
  UINT32                 qmSaId;
  UINT32                 numSAs;
  IPSEC_SA0              *saList;
  IPSEC_KEYMODULE_STATE0 *keyModuleState;
  FWP_IP_VERSION         ipVersion;
  union {
    UINT32 peerV4PrivateAddress;
  };
  UINT64                 mmSaId;
  IPSEC_PFS_GROUP        pfsGroup;
} IPSEC_SA_BUNDLE0;

成員

flags

下列值的組合。

IPsec SA 套件組合旗標	意義
IPSEC_SA_BUNDLE_FLAG_ND_SECURE	交涉探索會在安全通道中啟用。
IPSEC_SA_BUNDLE_FLAG_ND_BOUNDARY	在未受信任的周邊區域中啟用的交涉探索。
IPSEC_SA_BUNDLE_FLAG_ND_PEER_NAT_BOUNDARY	對等位於不受信任的周邊區域環形中，而 NAT 則以這種方式。與交涉探索搭配使用。
IPSEC_SA_BUNDLE_FLAG_GUARANTEE_ENCRYPTION	表示這是需要保證加密之連線的 SA。
IPSEC_SA_BUNDLE_FLAG_NLB	表示這是 NLB 伺服器的 SA。
IPSEC_SA_BUNDLE_FLAG_NO_MACHINE_LUID_VERIFY	表示此 SA 應該略過機器 LUID 驗證。
IPSEC_SA_BUNDLE_FLAG_NO_IMPERSONATION_LUID_VERIFY	表示此 SA 應該略過模擬 LUID 驗證。
IPSEC_SA_BUNDLE_FLAG_NO_EXPLICIT_CRED_MATCH	表示此 SA 應該略過明確的認證控制碼比對。
IPSEC_SA_BUNDLE_FLAG_ALLOW_Null_TARGET_NAME_MATCH	允許以對等名稱構成的 SA，以攜帶沒有相關聯對等目標的流量。
IPSEC_SA_BUNDLE_FLAG_CLEAR_DF_ON_TUNNEL	清除 IPsec 通道封包外部 IP 標頭上的 DontFragment 位。此旗標僅適用于通道模式 CA。
IPSEC_SA_BUNDLE_FLAG_ASSUME_UDP_CONTEXT_OUTBOUND	當將此 SA 與沒有相關聯 IPsec-NAT-shim 內容的輸出連線上的封包比對時，可以使用預設封裝埠 (4500 和 4000) 。
IPSEC_SA_BUNDLE_FLAG_ND_PEER_BOUNDARY	對等已啟用交涉探索，且位於周邊網路上。

lifetime

套件組合中所有 SA 的存留期，如 IPSEC_SA_LIFETIME0所指定。

idleTimeoutSeconds

套件組合中的 SA 會在幾秒後閒置 (，因為流量閒置) 和到期。

ndAllowClearTimeoutSeconds

以秒為單位的逾時，之後 IPsec SA 應該停止接受傳入清除的封包。

用於交涉探索。

ipsecId

包含選擇性 IPsec 身分識別資訊的 IPSEC_ID0 結構的指標。

napContext

網路存取保護 (NAP) 對等認證資訊。

qmSaId

選擇要到期的 SA 時，IPsec 所使用的 SA 識別碼。針對 IPsec SA 配對， qmSaId 在起始和回應機器之間，以及跨輸入和輸出 SA 套件組合必須相同。針對不同的 IPsec 配對， qmSaId 必須不同。

numSAs

套件組合中的 SA 數目。唯一可能的值為 1 和 2。只有在指定 AH + ESP SA 時，才使用 2。

saList

套件組合中的 IPsec SA 陣列。針對 AH + ESP SA，請使用 ESP SA 的索引 [0]，並針對 AH SA 使用索引 [1]。

如需詳細資訊，請參閱IPSEC_SA0 。

keyModuleState

選擇性索引鍵模組特定資訊，如 IPSEC_KEYMODULE_STATE0所指定。

ipVersion

FWP_IP_VERSION 所指定的IP 版本。

peerV4PrivateAddress

當 ipVersionFWP_IP_VERSION_V4時可用。如果對等位於網路位址轉譯後方， (NAT) 裝置，則此成員會儲存對等的私人位址。

mmSaId

使用此識別碼，將此 IPsec SA 與產生的 IKE SA 相互關聯。

pfsGroup

指定是否為此 SA 啟用快速模式完美轉寄密碼 (PFS) ，如果是的話，則包含用於 PFS 的 Diffie-Hellman 群組。

如需詳細資訊，請參閱IPSEC_PFS_GROUP 。

需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	ipsectypes.h

另請參閱

FWP_IP_VERSION

IPSEC_KEYMODULE_STATE0

共用方式為

IPSEC_SA_BUNDLE0 結構 (ipsectypes.h)

語法

成員

需求

另請參閱

意見反應

其他資源