NDIS_IPSEC_PACKET_INFO

typedef struct _NDIS_IPSEC_PACKET_INFO { union { struct { NDIS_HANDLE OffloadHandle; NDIS_HANDLE NextOffloadHandle; } Transmit; struct { ULONG SA_DELETE_REQ:1; ULONG CRYPTO_DONE:1; ULONG NEXT_CRYPTO_DONE:1; ULONG CryptoStatus; } Receive; }; } NDIS_IPSEC_PACKET_INFO, *PNDIS_IPSEC_PACKET_INFO;

NDIS_IPSEC_PACKET_INFO 구조체는 미니포트로 TCP/IP 전송 계층으로부터 offloading IP 보안 태스트들에 사용된 정보를 지정한다. NDIS_IPSEC_PACKET_INFO 구조체는 패킷 디스크립터와 관련된 패킷당 정보(확장 대역외 데이터)의 부분이다.

멤버

OffloadHandle

그러한 payload가 전송(end-to-end) 연결 혹은 터널 연결을 위해 있는지에 관계없이 하나의 IP Security payload를 가지는 패킷을 위한 나가는(outbound) security association(SA)에 대한 핸들을 지정한다.

NextOffloadHandle

전송 IP Security payload와 터널 IP Security payload를 가지는 패킷을 위해, NextOffloadHandle은 터널 연결을 위해 나가는 security association (SA)에 대한 핸들을 지정한다. NextOffloadHandle은 만약 패킷이 터널과 전송 계층 IP Security payload들을 가진다면 지정된다.; 그렇지 않다면, NextOffloadHandle은 0으로 설정된다.

SA_DELETE_REQ

설정될 때, TCP/IP 전송 계층은 패킷이 수신되었던 inbound security association(SA)를 지우기 위해 다시 한번 지워진 inbound SA에 대응하는 outbound SA를 지우기 위해 OID_TCP_TASK_IPSEC_DELETE_SA를 한번 발생한다는 것을 가리킨다. 미니포트의 NIC은 응답하는 OID_TCP_TASK_DELETE_SA 요구를 수신하기 전에 이러한 SA들을 지울 필요가 없다.

CRYPTO_DONE

설정될 때, NIC은 수신 패킷에서 적어도 하나의 IP security payload에 IP Security 체킹을 행한다는 것을 가리킨다. 클리어되었을 때, NIC이 패킷에 대해 IP Security 체킹을 행하지 않는다는 것을 가리킨다.

NEXT_CRYPTO_DONE

설정될 때, NIC은 수신 패킷의 터널과 전송 계층 부분들에서 IP 보안 체킹을 행한다. CRYPTO_DONE은 또한 이러한 경우에 설정되야 한다. NEXT_CRYPTO_DONE은 단지 만약 패킷은 터널과 전송 계층 IP 보안 payload들을 가진다면, 설정된다. ; 그렇지 않으면, NEXT_CRYPTO_DONE은 으로 설정된다.

CryptoStatus

다음 값들의 하나로서 수신 패키시에서 NIC에 의해 행해진 IP 보안 체킹의 결과를 지정한다.

CRYPTO_SUCCESS

패킷은 만약 필요하다면, 해독되고, 패킷 내에 AH checksum과 ESP 체크섬은 유효화된다.

CRYPTO_GENERIC_ERROR

패킷은 지정되지 않는 이유로 IP 보안 체크를 실패한다.

CRYPTO_TRANSPORT_AH_AUTH_FAILED

패킷의 전송 계층 부분을 위한 AH 체크섬은 유효하지 않다.

CRYPTO_TRANSPORT_ESP_AUTH_FAILED

패킷의 전송 계층 부분을 위해 ESP 체크섬은 유효하지 않다.

CRYPTO_TUNNEL_AH_AUTH_FAILED

패킷의 터널 부분을 위한 AH 체크섬은 유효하지 않다.

CRYPTO_TUNNEL_ESP_AUTH_FAILED

패킷의 터널 부분을 위한 ESP 체크섬이 유효하지 않다.

CRYPTO_INVALID_PACKET_LENGTH

수신 패킷의 길이가 유효하지 않다.

CRYPTO_INVALID_PROTOCOL

패킷이 수신된 security association(SA)에 지정된 IP 보안 프로토콜은 패킷내에서 발견된 IP 보안 프로토콜들과 일치하지 않는다. 예를 들어, 이러한 에러는 만약 패킷이 수신된 SA가 AH 프로토콜을 지정하지만 패킷이 ESP 헤더에 포함된다면 발생한다.

주석

TCP/IP 전송 계층이 미니포트의 NIC이 IP 보안 태스크들을 행할 보내기 패킷을 미니포트에 전달하기 전에, 패킷 디스크립터와 관련된 NDIS_IPSEC_PACKET_INFO 구조체내 IP 보안 정보를 업데이트한다. 특별하게, TCP/IP 전송 계층은 NDIS_IPSEC_PACKET_INFO 구조체내 OffloadHandle을 제공한다. OffloadHandle은 payload가 전송 계층(end-to-end) security association 혹은 터널 security association을 위해 있는지에 상관없이 단지 하나의 IP Security payload를 가지는 패킷을 위해 나가는 security association(SA)에 대한 핸들을 지정한다. NDIS_IPSEC_PACKET_INFO 구조체내에 제공된 OffloadHandle은 NIC에 outbound SA를 추가하기 위해 미니포트를 요구하기 위해 OID_TCP_TASK_IPSEC_ADD_SA를 설정할 때 TCP/IP 전송 계층에 의해 제공된 OffloadHandle인 같은 값을 가진다.

만약 전송 IP Security payload 와 터널 IP Security payload를 가지는 패킷이 있다면, NextOffloadHandle은 터널 연결을 위해 나가는 SA에게 핸들을 지정한다. NextOffloadHandle은 만약 패킷이 터널과 전송 계층 IP Security payloads들을 가진다면 지정된다. 그렇지 않으면, NextOffloadHandle은 0으로 설정된다.

하나 혹은 그 이상의 IP Security payloads를 가지는 수신 패킷을 인디케이트하기 전에, 미니포트는 패킷 디스크립터와 관련된 NDIS_IPSEC_PACKET_INFO를 업데이트한다:

• 만약 IP Security를 행하는 미니포트의 NIC이 적어도 패킷에서 하나의 IP security payload응 체크한다면, 미니포트는 CRYPTO_DONE 플래그를 설정하고 적당한 CryptoStatus 값을 지정함으로써 체크섬 유효화 테스트들의 결과를 인디케이트한다.
• 만약 미니포트의 NIC이 수신 패킷의 터널과 전송 계층 부분들에서 IP security 체킹을 행하면, 미니포트는 NEXT_CRYPTO_DONE 플래그를 설정한다. NEXT_CRYPTO_DONE 플래그는 만약 패킷이 터널 그리고 전송 계층 IP security payload들을 가진다면, 설정된다. 그렇지 않으면, NEXT_CRYPTO_DONE은 0으로 설정된다.
• 만약 미니포트의 NIC이 패킷에서 IP Security 체크들을 행하지 않으면, 미니포트는 CRYPTO_DONE 플래그 혹은 NEXT_CRYPTO_DONE 플래그를 설정하지 않고 CryptoStatus 값을 제공하지 않는다.

NDIS_IPSEC_PACKET_INFO 구조체에 대한 포인터를 얻기 위해, 드라이버들은 IpSecNdisTask의 InfoType로 NDIS_PER_PACKET_INFO_FROM_PACKET 매크로를 호출한다. 대안으로, 드라이버들은 주어진 패킷 디스크립터와 관련된 NDIS_PACKET_EXTENSION 구조체에 대한 포인터를 얻기 위해 NDIS_PACKET_EXTENSION_FROM_PACKET 매크로를 호출할 수 있다. 드라이버는 그리고나서 NDIS_IPSEC_PACKET_INFO 구조체를 가리키는 포인터를 얻기 위해 IpSecNdisTask배열 인덱스를 사용할 수 있다.