Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Teredo tunnel supports #13

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions src/Makefile.am
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@ decode-ethernet.c decode-ethernet.h \
decode-vlan.c decode-vlan.h \
decode-sll.c decode-sll.h \
decode-gre.c decode-gre.h \
decode-teredo.c decode-teredo.h \
decode-ppp.c decode-ppp.h \
decode-pppoe.c decode-pppoe.h \
decode-ipv4.c decode-ipv4.h \
Expand Down
102 changes: 102 additions & 0 deletions src/decode-teredo.c
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
/* Copyright (C) 2012 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
*
* \author Eric Leblond <eric@regit.org>
*
* Decode Teredo Tunneling protocol
*/

#include "suricata-common.h"
#include "decode.h"
#include "decode-ipv6.h"
#include "util-debug.h"

/**
* \brief Function to decode Teredo packets
*
* \retval 0 if packet is not a Teredo packet, 1 if it is
*/
int DecodeTeredo(ThreadVars *tv, DecodeThreadVars *dtv, Packet *p, uint8_t *pkt, uint16_t len, PacketQueue *pq)
{

unsigned char *start = p->payload;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why use p->payload, not "pkt"? The decode function normally operate on the buffer that is passed to it through the function parameters.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need to work on the content of the UDP packet: Toredo data are put inside UDP payload.

The Packet has already been successfully decoded as UDP and thus we can use p->payload.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can, but it is different than the normal flow of things. Maybe just pass p->payload and p->payload_len to this function and use the pkt, len parameters?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It seems consistent with other part of the decoding engine. Doing this.


/* Is this packet to short to contain an IPv6 packet ? */
if (UDP_GET_LEN(p) < UDP_HEADER_LEN + IPV6_HEADER_LEN)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why not use the "len" parameter passed to this function?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can for sure. Doing this.

return 0;

/* Teredo encapsulate IPv6 in UDP and can add some custom message
* part before the IPv6 packet. Here we iter on the messages to get
* on the IPv6 packet. */
while (start[0] == 0x0) {
switch (p->payload[1]) {
/* origin indication: compatible with tunnel */
case 0x0:
if (UDP_GET_LEN(p) >= 8 + UDP_HEADER_LEN + IPV6_HEADER_LEN)
start = p->payload + 8;
else
return 0;
break;
/* authentication: negotiation not real tunnel */
case 0x1:
return 0;
/* this case is not possible in Teredo: not that protocol */
default:
return 0;
}
}

if (IP_GET_RAW_VER(start) == 6) {
IPV6Hdr *thdr = (IPV6Hdr *)start;
/* This does looks like Teredo protocol, let's pray together */
if (UDP_GET_LEN(p) == UDP_HEADER_LEN + IPV6_HEADER_LEN +
IPV6_GET_RAW_PLEN(thdr) + (start - p->payload)) {
if (pq != NULL) {
/* spawn off tunnel packet */
Packet *tp = PacketPseudoPktSetup(p, start,
IPV4_GET_IPLEN(p) - (start - p->payload),
IPPROTO_IPV6);
if (tp != NULL) {
/* send that to the Tunnel decoder */
DecodeTunnel(tv, dtv, tp, GET_PKT_DATA(tp),
GET_PKT_LEN(tp), pq, IPPROTO_IPV6);

/* add the tp to the packet queue. */
PacketEnqueue(pq,tp);
}
return 1;
}
}
return 0;
}

return 0;
}

/**
* @}
*/
19 changes: 19 additions & 0 deletions src/decode-teredo.h
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
/* Copyright (C) 2012 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.
*/

int DecodeTeredo(ThreadVars *tv, DecodeThreadVars *dtv, Packet *p,
uint8_t *pkt, uint16_t len, PacketQueue *pq);
3 changes: 3 additions & 0 deletions src/decode-udp.c
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@
#include "suricata-common.h"
#include "decode.h"
#include "decode-udp.h"
#include "decode-teredo.h"
#include "decode-events.h"
#include "util-unittest.h"
#include "util-debug.h"
Expand Down Expand Up @@ -81,6 +82,8 @@ void DecodeUDP(ThreadVars *tv, DecodeThreadVars *dtv, Packet *p, uint8_t *pkt, u
SCLogDebug("UDP sp: %" PRIu32 " -> dp: %" PRIu32 " - HLEN: %" PRIu32 " LEN: %" PRIu32 "",
UDP_GET_SRC_PORT(p), UDP_GET_DST_PORT(p), UDP_HEADER_LEN, p->payload_len);

(void) DecodeTeredo(tv, dtv, p, pkt, len, pq);

/* Flow is an integral part of us */
FlowHandlePacket(tv, p);

Expand Down