estructura IPSEC_SA_BUNDLE0 (ipsectypes.h)

Artículo
08/24/2023

La estructura IPSEC_SA_BUNDLE0 se usa para almacenar información sobre una agrupación de asociaciones de seguridad (SA) de IPsec. IPSEC_SA_BUNDLE1 está disponible.

Sintaxis

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;

Members

flags

Combinación de los valores siguientes.

Marca de agrupación de SA de IPsec	Significado
IPSEC_SA_BUNDLE_FLAG_ND_SECURE	La detección de negociación está habilitada en anillo seguro.
IPSEC_SA_BUNDLE_FLAG_ND_BOUNDARY	Detección de negociación en habilitada en la zona perimetral que no es de confianza.
IPSEC_SA_BUNDLE_FLAG_ND_PEER_NAT_BOUNDARY	El par está en anillo de zona perimetral que no es de confianza y una NAT está en el camino. Se usa con la detección de negociación.
IPSEC_SA_BUNDLE_FLAG_GUARANTEE_ENCRYPTION	Indica que se trata de una SA para las conexiones que requieren cifrado garantizado.
IPSEC_SA_BUNDLE_FLAG_NLB	Indica que se trata de una SA a un servidor NLB.
IPSEC_SA_BUNDLE_FLAG_NO_MACHINE_LUID_VERIFY	Indica que esta SA debe omitir la comprobación de LUID de la máquina.
IPSEC_SA_BUNDLE_FLAG_NO_IMPERSONATION_LUID_VERIFY	Indica que esta SA debe omitir la comprobación de LUID de suplantación.
IPSEC_SA_BUNDLE_FLAG_NO_EXPLICIT_CRED_MATCH	Indica que esta SA debe omitir la coincidencia explícita del identificador de credenciales.
IPSEC_SA_BUNDLE_FLAG_ALLOW_NULL_TARGET_NAME_MATCH	Permite que una SA formada con un nombre del mismo nivel lleve tráfico que no tenga un destino del mismo nivel asociado.
IPSEC_SA_BUNDLE_FLAG_CLEAR_DF_ON_TUNNEL	Borra el bit DontFragment en el encabezado IP externo de un paquete con túnel IPsec. Esta marca solo se aplica a las SAs en modo de túnel.
IPSEC_SA_BUNDLE_FLAG_ASSUME_UDP_CONTEXT_OUTBOUND	Los puertos de encapsulación predeterminados (4500 y 4000) se pueden usar al hacer coincidir esta SA con paquetes en conexiones salientes que no tienen un contexto IPsec-NAT-shim asociado.
IPSEC_SA_BUNDLE_FLAG_ND_PEER_BOUNDARY	Peer tiene habilitada la detección de negociación y se encuentra en una red perimetral.

lifetime

Duración de todas las SAs del lote según lo especificado por IPSEC_SA_LIFETIME0.

idleTimeoutSeconds

Tiempo de espera en segundos después del cual las SAs del lote estarán inactivas (debido a la inactividad del tráfico) y expirarán.

ndAllowClearTimeoutSeconds

Tiempo de espera en segundos, después del cual la SA de IPsec debe dejar de aceptar paquetes que entran en el valor claro.

Se usa para la detección de negociación.

ipsecId

Puntero a una estructura de IPSEC_ID0 que contiene información de identidad de IPsec opcional.

napContext

Información de credenciales del mismo nivel de Protección de acceso a redes (NAP).

qmSaId

Identificador de SA usado por IPsec al elegir la SA para expirar. En el caso de un par de SA de IPsec, el qmSaId debe ser el mismo entre los equipos iniciados y respondiendo y entre los conjuntos de SA entrantes y salientes. Para diferentes pares IPsec, el qmSaId debe ser diferente.

numSAs

Número de SAs en la agrupación. Los únicos valores posibles son 1 y 2. Use 2 solo al especificar SAs de AH + ESP.

saList

Matriz de SAs de IPsec en el lote. Para las SA de AH + ESP, use el índice [0] para ESP SA y el índice [1] para AH SA.

Consulte IPSEC_SA0 para obtener más información.

keyModuleState

Información específica del módulo de clave opcional según lo especificado por IPSEC_KEYMODULE_STATE0.

ipVersion

Versión de IP especificada por FWP_IP_VERSION.

peerV4PrivateAddress

Disponible cuando ipVersion está FWP_IP_VERSION_V4. Si el mismo nivel está detrás de un dispositivo de traducción de direcciones de red (NAT), este miembro almacena la dirección privada del mismo nivel.

mmSaId

Use este identificador para correlacionar esta SA de IPsec con la SA de IKE que la generó.

pfsGroup

Especifica si el modo rápido se habilitó el secreto de avance perfecto (PFS) para esta SA y, si es así, contiene el grupo de Diffie-Hellman que se usó para PFS.

Consulte IPSEC_PFS_GROUP para obtener más información.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	ipsectypes.h

Consulte también

FWP_IP_VERSION

IPSEC_KEYMODULE_STATE0

IPSEC_PFS_GROUP

IPSEC_SA0

IPSEC_SA_LIFETIME0

Estructuras de api de plataforma de filtrado de Windows

Share via