The application may enable only some protocols. Disabling a protocol means: *) don't register/use the protocol dissector code (if any) *) disable classification by-port for such a protocol *) disable string matchings for domains/certificates involving this protocol *) disable subprotocol registration (if any) This feature can be tested with `ndpiReader -B list_of_protocols_to_disable`. Custom protocols are always enabled. Technically speaking, this commit doesn't introduce any API/ABI incompatibility. However, calling `ndpi_set_protocol_detection_bitmask2()` is now mandatory, just after having called `ndpi_init_detection_module()`. Most of the diffs (and all the diffs in `/src/lib/protocols/`) are due to the removing of some function parameters. Fix the low level macro `NDPI_LOG`. This issue hasn't been detected sooner simply because almost all the code uses only the helpers `NDPI_LOG_*`
121 lines
4.0 KiB
C
121 lines
4.0 KiB
C
/*
|
|
* websocket.c
|
|
*
|
|
* Copyright (C) 2018 by Leonn Paiva <leonn.paiva@gmail.com>
|
|
*
|
|
* This file is part of nDPI, an open source deep packet inspection
|
|
* library based on the OpenDPI and PACE technology by ipoque GmbH
|
|
*
|
|
* nDPI is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Lesser General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* nDPI 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 Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
* along with nDPI. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#include "ndpi_protocol_ids.h"
|
|
|
|
#define NDPI_CURRENT_PROTO NDPI_PROTOCOL_WEBSOCKET
|
|
|
|
#include "ndpi_api.h"
|
|
|
|
enum websocket_opcode
|
|
{
|
|
/*
|
|
* CONTINUATION_FRAME is not relevant for the detection and leads to many false positives
|
|
CONTINUATION_FRAME = 0x00,
|
|
FIN_CONTINUATION_FRAME = 0x80,
|
|
*/
|
|
TEXT_FRAME = 0x01,
|
|
FIN_TEXT_FRAME = 0x81,
|
|
BINARY_FRAME = 0x02,
|
|
FIN_BINARY_FRAME = 0x82,
|
|
CONNECTION_CLOSE_FRAME = 0x08,
|
|
FIN_CONNECTION_CLOSE_FRAME = 0x88,
|
|
PING_FRAME = 0x09,
|
|
FIN_PING_FRAME = 0x89,
|
|
PONG_FRAME = 0x0A,
|
|
FIN_PONG_FRAME = 0x8A
|
|
};
|
|
|
|
static void set_websocket_detected(struct ndpi_detection_module_struct *ndpi_struct, struct ndpi_flow_struct *flow)
|
|
{
|
|
/* If no custom protocol has been detected */
|
|
if (flow->detected_protocol_stack[0] == NDPI_PROTOCOL_UNKNOWN)
|
|
{
|
|
ndpi_set_detected_protocol(ndpi_struct, flow, NDPI_PROTOCOL_WEBSOCKET, NDPI_PROTOCOL_UNKNOWN, NDPI_CONFIDENCE_DPI);
|
|
}
|
|
}
|
|
|
|
/*************************************************************************************************/
|
|
|
|
static void ndpi_check_websocket(struct ndpi_detection_module_struct *ndpi_struct, struct ndpi_flow_struct *flow)
|
|
{
|
|
struct ndpi_packet_struct *packet = &ndpi_struct->packet;
|
|
|
|
if (packet->payload_packet_len < sizeof(u_int16_t))
|
|
{
|
|
NDPI_EXCLUDE_PROTO(ndpi_struct, flow);
|
|
return;
|
|
}
|
|
|
|
u_int8_t websocket_payload_length = packet->payload[1] & 0x7F;
|
|
u_int8_t websocket_masked = packet->payload[1] & 0x80;
|
|
|
|
uint8_t hdr_size = (websocket_masked == 1) ? 6 : 2;
|
|
|
|
if (packet->payload_packet_len != hdr_size + websocket_payload_length)
|
|
{
|
|
NDPI_LOG_DBG(ndpi_struct, "Invalid WEBSOCKET payload");
|
|
NDPI_EXCLUDE_PROTO(ndpi_struct, flow);
|
|
return;
|
|
}
|
|
|
|
if (packet->payload[0] == TEXT_FRAME || packet->payload[0] == FIN_TEXT_FRAME ||
|
|
packet->payload[0] == BINARY_FRAME || packet->payload[0] == FIN_BINARY_FRAME ||
|
|
packet->payload[0] == CONNECTION_CLOSE_FRAME || packet->payload[0] == FIN_CONNECTION_CLOSE_FRAME ||
|
|
packet->payload[0] == PING_FRAME || packet->payload[0] == FIN_PING_FRAME ||
|
|
packet->payload[0] == PONG_FRAME || packet->payload[0] == FIN_PONG_FRAME) {
|
|
|
|
set_websocket_detected(ndpi_struct, flow);
|
|
|
|
} else {
|
|
NDPI_LOG_DBG(ndpi_struct, "Invalid WEBSOCKET payload");
|
|
NDPI_EXCLUDE_PROTO(ndpi_struct, flow);
|
|
return;
|
|
}
|
|
}
|
|
|
|
void ndpi_search_websocket(struct ndpi_detection_module_struct *ndpi_struct, struct ndpi_flow_struct *flow)
|
|
{
|
|
// Break after 6 packets.
|
|
if (flow->packet_counter > 10)
|
|
{
|
|
NDPI_EXCLUDE_PROTO(ndpi_struct, flow);
|
|
return;
|
|
}
|
|
|
|
NDPI_LOG_DBG(ndpi_struct, "search WEBSOCKET\n");
|
|
ndpi_check_websocket(ndpi_struct, flow);
|
|
|
|
return;
|
|
}
|
|
|
|
/* ********************************* */
|
|
|
|
void init_websocket_dissector(struct ndpi_detection_module_struct *ndpi_struct, u_int32_t *id)
|
|
{
|
|
ndpi_set_bitmask_protocol_detection("WEBSOCKET", ndpi_struct, *id, NDPI_PROTOCOL_WEBSOCKET,
|
|
ndpi_search_websocket, NDPI_SELECTION_BITMASK_PROTOCOL_V4_V6_TCP_WITH_PAYLOAD_WITHOUT_RETRANSMISSION,
|
|
SAVE_DETECTION_BITMASK_AS_UNKNOWN, ADD_TO_DETECTION_BITMASK);
|
|
|
|
*id += 1;
|
|
}
|