Passive OS fingerprint netfilter extension.
Subsystems (3)
PATCH 1/1 Passive OS fingerprint netfilter extension.
Hi.
Passive OS fingerprinting netfilter module allows to passively detect remote OS and perform various netfilter actions based on that knowledge. This module compares some data (WS, MSS, options and it's order, ttl, df and others) from packets with SYN bit set with dynamically loaded OS fingerprints.
Fingerprint matching rules can be downloaded from OpenBSD source tree and loaded via netlink connector into the kernel via special util found in archive. It will also listen for events about matching packets.
Archive also contains library file (also attached), which was shipped with iptables extensions some time ago (at least when ipt_osf existed in patch-o-matic).
This release moves all rules initialization to be handled over the netlink and introduces lookup tables to speed-up RCU lookup a bit.
Fingerprints can be downloaded from
http://www.openbsd.org/cgi-bin/cvsweb/src/etc/pf.os
# modrpobe ipt_osf # ./ucon_osf -f ./pf.os ^C Daemon will listen for incoming match events -d switch removes fingerprints # iptables -I INPUT -j ACCEPT -p tcp -m osf --genre Linux --log 0 --ttl 2 --connector
To remove fingerprints:
# ./ucon_osf -f ./pf.os -d ^C Daemon will listen for incoming match events
You will find something like this in syslog:
ipt_osf: Windows [2000:SP3:Windows XP Pro SP1, 2000 SP3]:
11.22.33.55:4024 -> 11.22.33.44:139
Please consider for inclusion into the appropriate tree and review. Thank you.
P.S. Previous mail I sent did not appear in the mail lists likely because it thought this is a spam :)
include/linux/connector.h +2 -0
@@ -39,6 +39,8 @@#define CN_IDX_V86D 0x4#define CN_VAL_V86D_UVESAFB 0x1#define CN_IDX_BB 0x5/* BlackBoard, from the TSP GPL sampling framework */ +#define CN_IDX_OSF 0x6/* Passive OS fingerprint iptables module */ +#define CN_VAL_OSF 0x6#define CN_NETLINK_USERS 6
include/linux/netfilter_ipv4/ipt_osf.h new file +118 -0
118 lines not on this page · raw message
net/ipv4/netfilter/Kconfig +10 -0
@@ -101,6 +101,16 @@ config IP_NF_MATCH_TTL To compile it as a module, choose M here. If unsure, say N. +config IP_NF_MATCH_OSF + tristate '"osf" match support' + depends on NETFILTER_ADVANCED + help + Passive OS fingerprint matching module. + You should download and install rule loading software from + http://www.ioremap.net/projects/osf + + To compile it as a module, choose M here. If unsure, say N. + # `filter', generic and specific targets config IP_NF_FILTER tristate "Packet filtering"
net/ipv4/netfilter/Makefile +1 -0
@@ -52,6 +52,7 @@ obj-$(CONFIG_IP_NF_MATCH_ADDRTYPE) += ipt_addrtype.o obj-$(CONFIG_IP_NF_MATCH_AH) += ipt_ah.o obj-$(CONFIG_IP_NF_MATCH_ECN) += ipt_ecn.o obj-$(CONFIG_IP_NF_MATCH_TTL) += ipt_ttl.o +obj-$(CONFIG_IP_NF_MATCH_OSF) += ipt_osf.o # targets obj-$(CONFIG_IP_NF_TARGET_CLUSTERIP) += ipt_CLUSTERIP.o
net/ipv4/netfilter/ipt_osf.c new file +474 -0
474 lines not on this page · raw message
Signature · 1 line
Evgeniy Polyakov
/*
* libipt_osf.c
*
* Copyright (c) 2003-2006 Evgeniy Polyakov <[email protected]> *
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* 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
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
/*
* iptables interface for OS fingerprint matching module. */
#include <stdio.h>
#include <netdb.h>
#include <string.h>
#include <stdlib.h>
#include <getopt.h>
#include <ctype.h>
#include <xtables.h>
typedef unsigned int __u32;
typedef unsigned short __u16;
typedef unsigned char __u8;
#include "ipt_osf.h"
static void osf_help(void)
{
printf("OS fingerprint match options:\n"
"--genre [!] string Match a OS genre by passive fingerprinting.\n"
"--ttl Use some TTL check extensions to determine OS:\n"
" 0 true ip and fingerprint TTL comparison. Works for LAN.\n"
" 1 check if ip TTL is less than fingerprint one. Works for global addresses.\n"
" 2 do not compare TTL at all. Allows to detect NMAP, but can produce false results.\n"
"--log level Log determined genres into dmesg even if they do not match desired one:\n"
" 0 log all matched or unknown signatures.\n"
" 1 log only first one.\n"
" 2 log all known matched signatures.\n"
"--connector Log through kernel connector [2.6.14+].\n\n"
);
}
static const struct option osf_opts[] = {
{ .name = "genre", .has_arg = 1, .flag = 0, .val = '1' },
{ .name = "ttl", .has_arg = 1, .flag = 0, .val = '2' },
{ .name = "log", .has_arg = 1, .flag = 0, .val = '3' },
{ .name = "connector", .has_arg = 0, .flag = 0, .val = '5' },
{ .name = NULL }
};static void osf_init(struct xt_entry_match *m)
{
}
static void osf_parse_string(const unsigned char *s, struct ipt_osf_info *info)
{
if (strlen(s) < MAXGENRELEN)
strcpy(info->genre, s);
else
exit_error(PARAMETER_PROBLEM, "Genre string too long `%s' [%d], max=%d",
s, strlen(s), MAXGENRELEN);
}static int osf_parse(int c, char **argv, int invert, unsigned int *flags,
const void *entry,
struct xt_entry_match **match)
{
struct ipt_osf_info *info = (struct ipt_osf_info *)(*match)->data;
switch(c)
{
case '1': /* --genre */
if (*flags & IPT_OSF_GENRE)
exit_error(PARAMETER_PROBLEM, "Can't specify multiple genre parameter");
check_inverse(optarg, &invert, &optind, 0);
osf_parse_string(argv[optind-1], info);
if (invert)
info->flags |= IPT_OSF_INVERT;
info->len=strlen((char *)info->genre);
*flags |= IPT_OSF_GENRE;
break;
case '2': /* --ttl */
if (*flags & IPT_OSF_TTL)
exit_error(PARAMETER_PROBLEM, "Can't specify multiple ttl parameter");
*flags |= IPT_OSF_TTL;
info->flags |= IPT_OSF_TTL;
info->ttl = atoi(argv[optind-1]);
break;
case '3': /* --log */
if (*flags & IPT_OSF_LOG)
exit_error(PARAMETER_PROBLEM, "Can't specify multiple log parameter");
*flags |= IPT_OSF_LOG;
info->loglevel = atoi(argv[optind-1]);
info->flags |= IPT_OSF_LOG;
break;
case '5': /* --connector */
if (*flags & IPT_OSF_CONNECTOR)
exit_error(PARAMETER_PROBLEM, "Can't specify multiple connector parameter");
*flags |= IPT_OSF_CONNECTOR;
info->flags |= IPT_OSF_CONNECTOR;
break;
default:
return 0;
}
return 1;
}static void osf_final_check(unsigned int flags)
{
if (!flags)
exit_error(PARAMETER_PROBLEM, "OS fingerprint match: You must specify `--genre'");
}static void osf_print(const void *ip, const struct xt_entry_match *match, int numeric)
{
const struct ipt_osf_info *info = (const struct ipt_osf_info*) match->data;
printf("OS fingerprint match %s%s ", (info->flags & IPT_OSF_INVERT) ? "!" : "", info->genre);
}static void osf_save(const void *ip, const struct xt_entry_match *match)
{
const struct ipt_osf_info *info = (const struct ipt_osf_info*) match->data;
printf("--genre %s%s ", (info->flags & IPT_OSF_INVERT) ? "! ": "", info->genre);
}static struct xtables_match osf_match = {
.name = "osf",
.version = XTABLES_VERSION,
.size = XT_ALIGN(sizeof(struct ipt_osf_info)),
.userspacesize = XT_ALIGN(sizeof(struct ipt_osf_info)),
.help = &osf_help,
.init = &osf_init,
.parse = &osf_parse,
.print = &osf_print,
.final_check = &osf_final_check,
.save = &osf_save,
.extra_opts = osf_opts
};void _init(void)
{
xtables_register_match(&osf_match);
}