diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 17:39:49 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 17:39:49 +0000 |
commit | a0aa2307322cd47bbf416810ac0292925e03be87 (patch) | |
tree | 37076262a026c4b48c8a0e84f44ff9187556ca35 /src/decode-esp.c | |
parent | Initial commit. (diff) | |
download | suricata-a0aa2307322cd47bbf416810ac0292925e03be87.tar.xz suricata-a0aa2307322cd47bbf416810ac0292925e03be87.zip |
Adding upstream version 1:7.0.3.upstream/1%7.0.3
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'src/decode-esp.c')
-rw-r--r-- | src/decode-esp.c | 207 |
1 files changed, 207 insertions, 0 deletions
diff --git a/src/decode-esp.c b/src/decode-esp.c new file mode 100644 index 0000000..1dd5b73 --- /dev/null +++ b/src/decode-esp.c @@ -0,0 +1,207 @@ +/* Copyright (C) 2020-2021 Open Information Security Foundation + * + * You can copy, redistribute or modify this Program under the terms of + * the GNU General Public License version 2 as published by the Free + * Software Foundation. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * version 2 along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +/** + * \ingroup decode + * + * @{ + */ + +/** + * \file + * + * Decode Encapsulating Security Payload (ESP) + */ + +#include "suricata-common.h" +#include "decode-esp.h" +#include "flow.h" + +#include "util-validate.h" + +static int DecodeESPPacket(ThreadVars *tv, Packet *p, const uint8_t *pkt, uint16_t len) +{ + DEBUG_VALIDATE_BUG_ON(pkt == NULL); + + if (unlikely(len < ESP_HEADER_LEN)) { + ENGINE_SET_INVALID_EVENT(p, ESP_PKT_TOO_SMALL); + return -1; + } + + p->esph = (ESPHdr *)pkt; + + p->payload = (uint8_t *)pkt + sizeof(ESPHdr); + p->payload_len = len - sizeof(ESPHdr); + + p->proto = IPPROTO_ESP; + + return 0; +} + +/** + * \brief Function to decode IPSEC-ESP packets + * \param tv thread vars + * \param dtv decoder thread vars + * \param p packet + * \param pkt raw packet data + * \param len length in bytes of pkt array + * \retval TM_ECODE_OK or TM_ECODE_FAILED on serious error + */ +int DecodeESP(ThreadVars *tv, DecodeThreadVars *dtv, Packet *p, const uint8_t *pkt, uint16_t len) +{ + DEBUG_VALIDATE_BUG_ON(pkt == NULL); + + StatsIncr(tv, dtv->counter_esp); + + if (!PacketIncreaseCheckLayers(p)) { + return TM_ECODE_FAILED; + } + if (unlikely(DecodeESPPacket(tv, p, pkt, len) < 0)) { + CLEAR_ESP_PACKET(p); + return TM_ECODE_FAILED; + } + + SCLogDebug("ESP spi: %" PRIu32 " sequence: %" PRIu32, ESP_GET_SPI(p), ESP_GET_SEQUENCE(p)); + + FlowSetupPacket(p); + + return TM_ECODE_OK; +} + +#ifdef UNITTESTS + +#include "util-unittest.h" + +/** \test Successful decoding */ +static int DecodeESPTest01(void) +{ + uint8_t raw_esp[] = { 0x00, 0x00, 0x00, 0x7b, 0x00, 0x00, 0x00, 0x08 }; + + Packet *p = PacketGetFromAlloc(); + FAIL_IF_NULL(p); + + ThreadVars tv; + DecodeThreadVars dtv; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&dtv, 0, sizeof(DecodeThreadVars)); + + int ret = DecodeESP(&tv, &dtv, p, raw_esp, sizeof(raw_esp)); + FAIL_IF(ret != TM_ECODE_OK); + + FAIL_IF(p->proto != IPPROTO_ESP); + FAIL_IF(p->payload_len != sizeof(raw_esp) - ESP_HEADER_LEN); + FAIL_IF(ESP_GET_SPI(p) != 0x7b); + FAIL_IF(ESP_GET_SEQUENCE(p) != 0x08); + + SCFree(p); + + PASS; +} + +/** \test Successful decoding, with payload data */ +static int DecodeESPTest02(void) +{ + uint8_t raw_esp[] = { 0x00, 0x00, 0x00, 0x7b, 0x00, 0x00, 0x00, 0x08, 0xFF, 0xFF }; + + Packet *p = PacketGetFromAlloc(); + FAIL_IF_NULL(p); + + ThreadVars tv; + DecodeThreadVars dtv; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&dtv, 0, sizeof(DecodeThreadVars)); + + int ret = DecodeESP(&tv, &dtv, p, raw_esp, sizeof(raw_esp)); + FAIL_IF(ret != TM_ECODE_OK); + + FAIL_IF(p->proto != IPPROTO_ESP); + FAIL_IF(p->payload_len != sizeof(raw_esp) - ESP_HEADER_LEN); + FAIL_IF(memcmp(p->payload, raw_esp + ESP_HEADER_LEN, p->payload_len) != 0); + FAIL_IF(ESP_GET_SPI(p) != 0x7b); + FAIL_IF(ESP_GET_SEQUENCE(p) != 0x08); + + SCFree(p); + + PASS; +} + +/** \test Failure decoding, not enough data */ +static int DecodeESPTest03(void) +{ + uint8_t raw_esp[] = { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }; + + Packet *p = PacketGetFromAlloc(); + FAIL_IF_NULL(p); + + ThreadVars tv; + DecodeThreadVars dtv; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&dtv, 0, sizeof(DecodeThreadVars)); + + int ret = DecodeESP(&tv, &dtv, p, raw_esp, sizeof(raw_esp)); + FAIL_IF(ret != TM_ECODE_FAILED); + + // expect ESP_PKT_TOO_SMALL + FAIL_IF_NOT(ENGINE_ISSET_EVENT(p, ESP_PKT_TOO_SMALL)); + + SCFree(p); + + PASS; +} + +/** \test Failure decoding, no data */ +static int DecodeESPTest04(void) +{ + uint8_t raw_esp[] = {}; + + Packet *p = PacketGetFromAlloc(); + FAIL_IF_NULL(p); + + ThreadVars tv; + DecodeThreadVars dtv; + + memset(&tv, 0, sizeof(ThreadVars)); + memset(&dtv, 0, sizeof(DecodeThreadVars)); + + int ret = DecodeESP(&tv, &dtv, p, raw_esp, sizeof(raw_esp)); + FAIL_IF(ret != TM_ECODE_FAILED); + + // expect ESP_PKT_TOO_SMALL + FAIL_IF_NOT(ENGINE_ISSET_EVENT(p, ESP_PKT_TOO_SMALL)); + + SCFree(p); + + PASS; +} +#endif /* UNITTESTS */ + +void DecodeESPRegisterTests(void) +{ +#ifdef UNITTESTS + UtRegisterTest("DecodeESPTest01", DecodeESPTest01); + UtRegisterTest("DecodeESPTest02", DecodeESPTest02); + UtRegisterTest("DecodeESPTest03", DecodeESPTest03); + UtRegisterTest("DecodeESPTest04", DecodeESPTest04); +#endif /* UNITTESTS */ +} + +/** + * @} + */ |