struktur IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION (ndis.h)

Artikel
07/02/2025

[Fitur Offload Tugas IPsec tidak digunakan lagi dan tidak boleh digunakan.]

Struktur IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION menentukan asosiasi keamanan tunggal (SA).

Sintaksis

typedef struct _IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION {
  ULONG                           Flags;
  IPSEC_OFFLOAD_V2_OPERATION      Operation;
  IPSEC_OFFLOAD_V2_SPI_TYPE       Spi;
  IPSEC_OFFLOAD_V2_ALGORITHM_INFO AuthenticationAlgorithm;
  IPSEC_OFFLOAD_V2_ALGORITHM_INFO EncryptionAlgorithm;
  ULONG                           SequenceNumberHighOrder;
} IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION, *PIPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION;

Anggota

Flags

Sekumpulan bendera yang dapat dikombinasikan dengan operasi BITWISE OR. Jika tidak, atur anggota ini ke nol. Nilai berikut ini valid:

IPSEC_OFFLOAD_V2_ESN_SA

Menentukan ESN SA.

Operation

Operasi IPsec tempat SA akan digunakan. Si IPSEC_OFFLOAD_V2_OPERATION enumerasi menentukan operasi yang didukung.

Spi

Indeks parameter keamanan (SPI) 32 bit untuk SA.

AuthenticationAlgorithm

Algoritma integritas (autentikasi) untuk SA, diformat sebagai IPSEC_OFFLOAD_V2_ALGORITHM_INFO struktur.

EncryptionAlgorithm

Algoritma kerahasiaan (enkripsi/dekripsi) untuk SA, diformat sebagai struktur IPSEC_OFFLOAD_V2_ALGORITHM_INFO.

Note For AES-GCM, anggota EncryptionAlgorithm berisi informasi utama. AuthenticationAlgorithm anggota IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION, dan panjang kunci dan offset dalam IPSEC_OFFLOAD_V2_ALGORITHM_INFO, tidak boleh digunakan.

SequenceNumberHighOrder

Ekstensi urutan nomor pesanan tinggi. Ekstensi urutan nomor pesanan tinggi ini didefinisikan dalam RFC 4304. Anggota ini mewakili bagian urutan tinggi dari nomor urut yang tidak disertakan dalam header IPsec.

Komentar

Struktur IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION adalah elemen dalam array SecAssoc panjang variabel dalam struktur IPSEC_OFFLOAD_V2_ADD_SA. Jumlah SU dalam struktur IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION ditentukan dalam NumExtHdrs anggota IPSEC_OFFLOAD_V2_ADD_SA.

Elemen SecAssoc yang ditentukan untuk digunakan dalam memproses header autentikasi (AH) akan memiliki jenis operasi (anggota Operation) IPsecOffloadV2Ah dan akan memiliki algoritma autentikasi di anggota AuthenticationAlgorithm. SA tidak akan memiliki algoritma enkripsi di anggota EncryptionAlgorithm, jadi EncryptionAlgorithm akan berisi nol.

Elemen SecAssoc yang ditentukan untuk digunakan dalam memproses enkapsulating payload keamanan (ESP) akan memiliki jenis operasi (anggota Operasi) IPsecOffloadV2Esp dan dapat memiliki algoritma autentikasi, algoritma enkripsi, atau keduanya. Perhatikan bahwa untuk algoritma mode gabungan, hanya anggota EncryptionAlgorithm yang akan ditentukan.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Didukung di NDIS 6.1 dan yang lebih baru.
Header	ndis.h (termasuk Ndis.h)

Lihat juga

IPSEC_OFFLOAD_V2_ADD_SA

IPSEC_OFFLOAD_V2_ALGORITHM_INFO

IPSEC_OFFLOAD_V2_OPERATION

Bagikan melalui