![Pablo Neira Ayuso](/assets/img/avatar_default.png)
There are good reasons to supports helpers in user-space instead: * Rapid connection tracking helper development, as developing code in user-space is usually faster. * Reliability: A buggy helper does not crash the kernel. Moreover, we can monitor the helper process and restart it in case of problems. * Security: Avoid complex string matching and mangling in kernel-space running in privileged mode. Going further, we can even think about running user-space helpers as a non-root process. * Extensibility: It allows the development of very specific helpers (most likely non-standard proprietary protocols) that are very likely not to be accepted for mainline inclusion in the form of kernel-space connection tracking helpers. This patch adds the infrastructure to allow the implementation of user-space conntrack helpers by means of the new nfnetlink subsystem `nfnetlink_cthelper' and the existing queueing infrastructure (nfnetlink_queue). I had to add the new hook NF_IP6_PRI_CONNTRACK_HELPER to register ipv[4|6]_helper which results from splitting ipv[4|6]_confirm into two pieces. This change is required not to break NAT sequence adjustment and conntrack confirmation for traffic that is enqueued to our user-space conntrack helpers. Basic operation, in a few steps: 1) Register user-space helper by means of `nfct': nfct helper add ftp inet tcp [ It must be a valid existing helper supported by conntrack-tools ] 2) Add rules to enable the FTP user-space helper which is used to track traffic going to TCP port 21. For locally generated packets: iptables -I OUTPUT -t raw -p tcp --dport 21 -j CT --helper ftp For non-locally generated packets: iptables -I PREROUTING -t raw -p tcp --dport 21 -j CT --helper ftp 3) Run the test conntrackd in helper mode (see example files under doc/helper/conntrackd.conf conntrackd 4) Generate FTP traffic going, if everything is OK, then conntrackd should create expectations (you can check that with `conntrack': conntrack -E expect [NEW] 301 proto=6 src=192.168.1.136 dst=130.89.148.12 sport=0 dport=54037 mask-src=255.255.255.255 mask-dst=255.255.255.255 sport=0 dport=65535 master-src=192.168.1.136 master-dst=130.89.148.12 sport=57127 dport=21 class=0 helper=ftp [DESTROY] 301 proto=6 src=192.168.1.136 dst=130.89.148.12 sport=0 dport=54037 mask-src=255.255.255.255 mask-dst=255.255.255.255 sport=0 dport=65535 master-src=192.168.1.136 master-dst=130.89.148.12 sport=57127 dport=21 class=0 helper=ftp This confirms that our test helper is receiving packets including the conntrack information, and adding expectations in kernel-space. The user-space helper can also store its private tracking information in the conntrack structure in the kernel via the CTA_HELP_INFO. The kernel will consider this a binary blob whose layout is unknown. This information will be included in the information that is transfered to user-space via glue code that integrates nfnetlink_queue and ctnetlink. Signed-off-by: Pablo Neira Ayuso <pablo@netfilter.org>
79 lines
1.9 KiB
Makefile
79 lines
1.9 KiB
Makefile
header-y += ipset/
|
|
|
|
header-y += nf_conntrack_common.h
|
|
header-y += nf_conntrack_ftp.h
|
|
header-y += nf_conntrack_sctp.h
|
|
header-y += nf_conntrack_tcp.h
|
|
header-y += nf_conntrack_tuple_common.h
|
|
header-y += nf_nat.h
|
|
header-y += nfnetlink.h
|
|
header-y += nfnetlink_acct.h
|
|
header-y += nfnetlink_compat.h
|
|
header-y += nfnetlink_conntrack.h
|
|
header-y += nfnetlink_cthelper.h
|
|
header-y += nfnetlink_cttimeout.h
|
|
header-y += nfnetlink_log.h
|
|
header-y += nfnetlink_queue.h
|
|
header-y += x_tables.h
|
|
header-y += xt_AUDIT.h
|
|
header-y += xt_CHECKSUM.h
|
|
header-y += xt_CLASSIFY.h
|
|
header-y += xt_CONNMARK.h
|
|
header-y += xt_CONNSECMARK.h
|
|
header-y += xt_CT.h
|
|
header-y += xt_DSCP.h
|
|
header-y += xt_IDLETIMER.h
|
|
header-y += xt_LED.h
|
|
header-y += xt_LOG.h
|
|
header-y += xt_MARK.h
|
|
header-y += xt_nfacct.h
|
|
header-y += xt_NFLOG.h
|
|
header-y += xt_NFQUEUE.h
|
|
header-y += xt_RATEEST.h
|
|
header-y += xt_SECMARK.h
|
|
header-y += xt_TCPMSS.h
|
|
header-y += xt_TCPOPTSTRIP.h
|
|
header-y += xt_TEE.h
|
|
header-y += xt_TPROXY.h
|
|
header-y += xt_addrtype.h
|
|
header-y += xt_cluster.h
|
|
header-y += xt_comment.h
|
|
header-y += xt_connbytes.h
|
|
header-y += xt_connlimit.h
|
|
header-y += xt_connmark.h
|
|
header-y += xt_conntrack.h
|
|
header-y += xt_cpu.h
|
|
header-y += xt_dccp.h
|
|
header-y += xt_devgroup.h
|
|
header-y += xt_dscp.h
|
|
header-y += xt_ecn.h
|
|
header-y += xt_esp.h
|
|
header-y += xt_hashlimit.h
|
|
header-y += xt_helper.h
|
|
header-y += xt_iprange.h
|
|
header-y += xt_ipvs.h
|
|
header-y += xt_length.h
|
|
header-y += xt_limit.h
|
|
header-y += xt_mac.h
|
|
header-y += xt_mark.h
|
|
header-y += xt_multiport.h
|
|
header-y += xt_osf.h
|
|
header-y += xt_owner.h
|
|
header-y += xt_physdev.h
|
|
header-y += xt_pkttype.h
|
|
header-y += xt_policy.h
|
|
header-y += xt_quota.h
|
|
header-y += xt_rateest.h
|
|
header-y += xt_realm.h
|
|
header-y += xt_recent.h
|
|
header-y += xt_set.h
|
|
header-y += xt_sctp.h
|
|
header-y += xt_socket.h
|
|
header-y += xt_state.h
|
|
header-y += xt_statistic.h
|
|
header-y += xt_string.h
|
|
header-y += xt_tcpmss.h
|
|
header-y += xt_tcpudp.h
|
|
header-y += xt_time.h
|
|
header-y += xt_u32.h
|