/* packet-proxy.c * Routines for PROXY(v2) dissection * Copyright 2015, Alexis La Goutte (See AUTHORS) * * Wireshark - Network traffic analyzer * By Gerald Combs * Copyright 1998 Gerald Combs * * SPDX-License-Identifier: GPL-2.0-or-later */ /* * https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt */ #include #include #include void proto_reg_handoff_proxy(void); void proto_register_proxy(void); static int proto_proxy = -1; static int hf_proxy_version = -1; /* V2 */ static int hf_proxy2_magic = -1; static int hf_proxy2_ver = -1; static int hf_proxy2_cmd = -1; static int hf_proxy2_addr_family = -1; static int hf_proxy2_protocol = -1; static int hf_proxy2_addr_family_protocol = -1; static int hf_proxy2_len = -1; static int hf_proxy2_src_addr_ipv4 = -1; static int hf_proxy2_dst_addr_ipv4 = -1; static int hf_proxy2_src_addr_ipv6 = -1; static int hf_proxy2_dst_addr_ipv6 = -1; static int hf_proxy2_src_port = -1; static int hf_proxy2_dst_port = -1; static int hf_proxy2_src_addr_unix = -1; static int hf_proxy2_dst_addr_unix = -1; static int hf_proxy2_unknown = -1; static int hf_proxy2_tlv = -1; static int hf_proxy2_tlv_type = -1; static int hf_proxy2_tlv_length = -1; static int hf_proxy2_tlv_value = -1; static int hf_proxy2_tlv_ssl_client = -1; static int hf_proxy2_tlv_ssl_verify = -1; static int hf_proxy2_tlv_ssl_version = -1; static int hf_proxy2_tlv_ssl_cn = -1; static int hf_proxy2_tlv_ssl_cipher = -1; static int hf_proxy2_tlv_ssl_sig_alg = -1; static int hf_proxy2_tlv_ssl_key_alg = -1; static expert_field ei_proxy_header_length_too_small = EI_INIT; static gint ett_proxy2 = -1; static gint ett_proxy2_fampro = -1; static gint ett_proxy2_tlv = -1; static const guint8 proxy_v2_magic[] = { 0x0d, 0x0a, 0x0d, 0x0a, 0x00, 0x0d, 0x0a, 0x51, 0x55, 0x49, 0x54, 0x0a }; static const value_string proxy2_family_protocol_vals[] = { { 0x00, "UNSPEC" }, { 0x11, "TCP over IPv4" }, { 0x12, "UDP over IPv4" }, { 0x21, "TCP over IPv6" }, { 0x22, "UDP over IPv6" }, { 0x31, "UNIX stream" }, { 0x32, "UNIX datagram" }, { 0, NULL } }; static const value_string proxy2_family_vals[] = { { 0x1, "IPv4" }, { 0x2, "IPv6" }, { 0x3, "UNIX" }, { 0, NULL } }; #define PP2_TYPE_ALPN 0x01 #define PP2_TYPE_AUTHORITY 0x02 #define PP2_TYPE_CRC32C 0x03 #define PP2_TYPE_NOOP 0x04 #define PP2_TYPE_SSL 0x20 #define PP2_SUBTYPE_SSL_VERSION 0x21 #define PP2_SUBTYPE_SSL_CN 0x22 #define PP2_SUBTYPE_SSL_CIPHER 0x23 #define PP2_SUBTYPE_SSL_SIG_ALG 0x24 #define PP2_SUBTYPE_SSL_KEY_ALG 0x25 #define PP2_TYPE_NETNS 0x30 static const value_string proxy2_tlv_vals[] = { { 0x00, "UNSPEC" }, { PP2_TYPE_ALPN, "ALPN" }, { PP2_TYPE_AUTHORITY, "AUTHORITY" }, { PP2_TYPE_CRC32C, "CRC32C" }, { PP2_TYPE_NOOP, "NOOP" }, { PP2_TYPE_SSL, "SSL" }, { PP2_SUBTYPE_SSL_VERSION, "SSL VERSION" }, { PP2_SUBTYPE_SSL_CN, "SSL CN" }, { PP2_SUBTYPE_SSL_CIPHER, "SSL CIPHER" }, { PP2_SUBTYPE_SSL_SIG_ALG, "SSL SIG ALG" }, { PP2_SUBTYPE_SSL_KEY_ALG, "SSL KEY ALG" }, { PP2_TYPE_NETNS, "NETNS" }, { 0, NULL } }; static int dissect_proxy_v2_tlv(tvbuff_t *tvb, packet_info *pinfo, proto_tree *proxy_tree, int offset) { while ( tvb_reported_length_remaining(tvb, offset) > 0) { guint32 type, length; proto_item *ti_tlv; proto_tree *tlv_tree; ti_tlv = proto_tree_add_item(proxy_tree, hf_proxy2_tlv, tvb, offset, 3, ENC_NA); tlv_tree = proto_item_add_subtree(ti_tlv, ett_proxy2_tlv); proto_tree_add_item_ret_uint(tlv_tree, hf_proxy2_tlv_type, tvb, offset, 1, ENC_NA, &type); offset += 1; proto_tree_add_item_ret_uint(tlv_tree, hf_proxy2_tlv_length, tvb, offset, 2, ENC_BIG_ENDIAN, &length); offset += 2; proto_item_append_text(ti_tlv, ": (t=%u,l=%d) %s", type, length, val_to_str(type, proxy2_tlv_vals ,"Unknown type") ); proto_item_set_len(ti_tlv, 1 + 2 + length); proto_tree_add_item(tlv_tree, hf_proxy2_tlv_value, tvb, offset, length, ENC_NA); switch (type) { case PP2_TYPE_SSL: /* SSL */ proto_tree_add_item(tlv_tree, hf_proxy2_tlv_ssl_client, tvb, offset, 1, ENC_NA); offset += 1; proto_tree_add_item(tlv_tree, hf_proxy2_tlv_ssl_verify, tvb, offset, 4, ENC_NA); offset += 4; offset = dissect_proxy_v2_tlv(tvb, pinfo, tlv_tree, offset); break; case PP2_SUBTYPE_SSL_VERSION: /* SSL Version */ proto_tree_add_item(tlv_tree, hf_proxy2_tlv_ssl_version, tvb, offset, length, ENC_ASCII|ENC_NA); proto_item_append_text(ti_tlv, ": %s", tvb_get_string_enc(wmem_packet_scope(), tvb, offset, length, ENC_ASCII)); offset += length; break; case PP2_SUBTYPE_SSL_CN: /* SSL CommonName */ proto_tree_add_item(tlv_tree, hf_proxy2_tlv_ssl_cn, tvb, offset, length, ENC_ASCII|ENC_NA); proto_item_append_text(ti_tlv, ": %s", tvb_get_string_enc(wmem_packet_scope(), tvb, offset, length, ENC_ASCII)); offset += length; break; case PP2_SUBTYPE_SSL_CIPHER: /* SSL Cipher */ proto_tree_add_item(tlv_tree, hf_proxy2_tlv_ssl_cipher, tvb, offset, length, ENC_ASCII|ENC_NA); offset += length; break; case PP2_SUBTYPE_SSL_SIG_ALG: /* SSL Signature Algorithm */ proto_tree_add_item(tlv_tree, hf_proxy2_tlv_ssl_sig_alg, tvb, offset, length, ENC_ASCII|ENC_NA); offset += length; break; case PP2_SUBTYPE_SSL_KEY_ALG: /* SSL Key Algorithm */ proto_tree_add_item(tlv_tree, hf_proxy2_tlv_ssl_key_alg, tvb, offset, length, ENC_ASCII|ENC_NA); offset += length; break; default: offset += length; break; } } return offset; } static int dissect_proxy_v2(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, void *data _U_) { proto_item *ti , *ti_ver; proto_tree *proxy_tree, *fampro_tree; guint offset = 0, next_offset; guint32 header_len, fam_pro; col_set_str(pinfo->cinfo, COL_PROTOCOL, "PROXYv2"); ti = proto_tree_add_item(tree, proto_proxy, tvb, 0, -1, ENC_NA); proxy_tree = proto_item_add_subtree(ti, ett_proxy2); proto_tree_add_item(proxy_tree, hf_proxy2_magic, tvb, offset, 12, ENC_NA); offset += 12; proto_tree_add_item(proxy_tree, hf_proxy2_ver, tvb, offset, 1, ENC_NA); proto_tree_add_item(proxy_tree, hf_proxy2_cmd, tvb, offset, 1, ENC_NA); ti_ver = proto_tree_add_uint(proxy_tree, hf_proxy_version, tvb, offset, 1, 2); PROTO_ITEM_SET_GENERATED(ti_ver); offset += 1; ti = proto_tree_add_item_ret_uint(proxy_tree, hf_proxy2_addr_family_protocol, tvb, offset, 1, ENC_NA, &fam_pro); fampro_tree = proto_item_add_subtree(ti, ett_proxy2_fampro); proto_tree_add_item(fampro_tree, hf_proxy2_addr_family, tvb, offset, 1, ENC_NA); proto_tree_add_item(fampro_tree, hf_proxy2_protocol, tvb, offset, 1, ENC_NA); offset += 1; proto_tree_add_item_ret_uint(proxy_tree, hf_proxy2_len, tvb, offset, 2, ENC_BIG_ENDIAN, &header_len); offset += 2; next_offset = offset + header_len; switch (fam_pro){ case 0x11: /* TCP over IPv4 */ case 0x12: /* UDP over IPv4 */ proto_tree_add_item(proxy_tree, hf_proxy2_src_addr_ipv4, tvb, offset, 4, ENC_NA); offset += 4; proto_tree_add_item(proxy_tree, hf_proxy2_dst_addr_ipv4, tvb, offset, 4, ENC_NA); offset += 4; proto_tree_add_item(proxy_tree, hf_proxy2_src_port, tvb, offset, 2, ENC_BIG_ENDIAN); offset += 2; proto_tree_add_item(proxy_tree, hf_proxy2_dst_port, tvb, offset, 2, ENC_BIG_ENDIAN); offset += 2; break; case 0x21: /* TCP over IPv6 */ case 0x22: /* UDP over IPv6 */ proto_tree_add_item(proxy_tree, hf_proxy2_src_addr_ipv6, tvb, offset, 16, ENC_NA); offset += 16; proto_tree_add_item(proxy_tree, hf_proxy2_dst_addr_ipv6, tvb, offset, 16, ENC_NA); offset += 16; proto_tree_add_item(proxy_tree, hf_proxy2_src_port, tvb, offset, 2, ENC_BIG_ENDIAN); offset += 2; proto_tree_add_item(proxy_tree, hf_proxy2_dst_port, tvb, offset, 2, ENC_BIG_ENDIAN); offset += 2; break; case 0x31: /* UNIX stream */ case 0x32: /* UNIX datagram */ proto_tree_add_item(proxy_tree, hf_proxy2_src_addr_unix, tvb, offset, 108, ENC_NA); offset += 108; proto_tree_add_item(proxy_tree, hf_proxy2_dst_addr_unix, tvb, offset, 108, ENC_NA); offset += 108; break; default: proto_tree_add_item(proxy_tree, hf_proxy2_unknown, tvb, offset, header_len, ENC_NA); offset += header_len; break; } if (offset > next_offset) { proto_tree_add_expert(proxy_tree, pinfo, &ei_proxy_header_length_too_small, tvb, offset, -1); return offset; } if (offset < header_len) { /* TLV */ offset = dissect_proxy_v2_tlv(tvb, pinfo, proxy_tree, offset); } return offset; } static gboolean dissect_proxy_heur(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, void *data) { if (tvb_reported_length(tvb) >= 16 && tvb_captured_length(tvb) >= sizeof(proxy_v2_magic) && tvb_memeql(tvb, 0, proxy_v2_magic, sizeof(proxy_v2_magic)) == 0) { // TODO maybe check for "(hdr.v2.ver_cmd & 0xF0) == 0x20" as done in "9. Sample code" from // https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt? dissect_proxy_v2(tvb, pinfo, tree, data); return TRUE; } return FALSE; } void proto_register_proxy(void) { expert_module_t *expert_proxy; static hf_register_info hf[] = { { &hf_proxy_version, { "Version", "proxy.version", FT_UINT8, BASE_DEC, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_magic, { "Magic", "proxy.v2.magic", FT_BYTES, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_ver, { "Version", "proxy.v2.version", FT_UINT8, BASE_DEC, NULL, 0xF0, NULL, HFILL } }, { &hf_proxy2_cmd, { "Command", "proxy.v2.cmd", FT_UINT8, BASE_DEC, NULL, 0x0F, NULL, HFILL } }, { &hf_proxy2_addr_family_protocol, { "Address Family Protocol", "proxy.v2.addr_family_protocol", FT_UINT8, BASE_HEX, VALS(proxy2_family_protocol_vals), 0x00, NULL, HFILL } }, { &hf_proxy2_addr_family, { "Address Family", "proxy.v2.addr_family", FT_UINT8, BASE_HEX, VALS(proxy2_family_vals), 0xF0, NULL, HFILL } }, { &hf_proxy2_protocol, { "Protocol", "proxy.v2.protocol", FT_UINT8, BASE_HEX, NULL, 0x0F, NULL, HFILL } }, { &hf_proxy2_len, { "Length", "proxy.v2.length", FT_UINT16, BASE_DEC, NULL, 0x00, "Size of addresses and additional properties", HFILL } }, { &hf_proxy2_src_addr_ipv4, { "Source Address (IPv4)", "proxy.v2.src_addr_ipv4", FT_IPv4, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_dst_addr_ipv4, { "Destination Address (IPv4)", "proxy.v2.dst_addr_ipv4", FT_IPv4, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_src_addr_ipv6, { "Source Address (IPv6)", "proxy.v2.src_addr_ipv6", FT_IPv6, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_dst_addr_ipv6, { "Destination Address (IPv6)", "proxy.v2.dst_addr_ipv6", FT_IPv6, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_src_port, { "Source Port", "proxy.v2.src_port", FT_UINT16, BASE_DEC, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_dst_port, { "Destination Port", "proxy.v2.dst_port", FT_UINT16, BASE_DEC, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_src_addr_unix, { "Source Address (UNIX)", "proxy.v2.src_addr_unix", FT_BYTES, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_dst_addr_unix, { "Destination Address (UNIX)", "proxy.v2.dst_addr_unix", FT_BYTES, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_unknown, { "Unknown data", "proxy.v2.unknown", FT_BYTES, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_tlv, { "TLV", "proxy.v2.tlv", FT_NONE, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_tlv_type, { "Type", "proxy.v2.tlv.type", FT_UINT8, BASE_HEX, VALS(proxy2_tlv_vals), 0x0, NULL, HFILL } }, { &hf_proxy2_tlv_length, { "Length", "proxy.v2.tlv.length", FT_UINT16, BASE_DEC, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_tlv_value, { "Value", "proxy.v2.tlv.value", FT_BYTES, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_tlv_ssl_client, { "Client", "proxy.v2.tlv.ssl.client", FT_UINT8, BASE_HEX, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_tlv_ssl_verify, { "Verify", "proxy.v2.tlv.ssl.verify", FT_UINT32, BASE_HEX, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_tlv_ssl_version, { "Version", "proxy.v2.tlv.ssl.version", FT_STRING, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_tlv_ssl_cn, { "CN", "proxy.v2.tlv.ssl.cn", FT_STRING, BASE_NONE, NULL, 0x0, "CommonName", HFILL } }, { &hf_proxy2_tlv_ssl_cipher, { "Cipher", "proxy.v2.tlv.ssl.cipher", FT_STRING, BASE_NONE, NULL, 0x0, NULL, HFILL } }, { &hf_proxy2_tlv_ssl_sig_alg, { "SIG ALG", "proxy.v2.tlv.ssl.sig_alg", FT_STRING, BASE_NONE, NULL, 0x0, "Signature Algorithm", HFILL } }, { &hf_proxy2_tlv_ssl_key_alg, { "Key ALG", "proxy.v2.tlv.ssl.keu_alg", FT_STRING, BASE_NONE, NULL, 0x0, "Key Algorithm", HFILL } }, }; static gint *ett[] = { &ett_proxy2, &ett_proxy2_fampro, &ett_proxy2_tlv, }; static ei_register_info ei[] = { { &ei_proxy_header_length_too_small, { "proxy.header.length_too_small", PI_MALFORMED, PI_WARN, "Header length is too small", EXPFILL } } }; proto_proxy = proto_register_protocol("PROXY Protocol", "PROXY", "proxy"); proto_register_field_array(proto_proxy, hf, array_length(hf)); proto_register_subtree_array(ett, array_length(ett)); expert_proxy = expert_register_protocol(proto_proxy); expert_register_field_array(expert_proxy, ei, array_length(ei)); } void proto_reg_handoff_proxy(void) { heur_dissector_add("tcp", dissect_proxy_heur, "proxy", "proxy_tcp", proto_proxy, HEURISTIC_ENABLE); heur_dissector_add("udp", dissect_proxy_heur, "proxy", "proxy_udp", proto_proxy, HEURISTIC_ENABLE); } /* * Editor modelines - https://www.wireshark.org/tools/modelines.html * * Local variables: * c-basic-offset: 4 * tab-width: 8 * indent-tabs-mode: nil * End: * * vi: set shiftwidth=4 tabstop=8 expandtab: * :indentSize=4:tabSize=8:noTabs=true: */