Skip to content

Latest commit

 

History

History
51 lines (29 loc) · 1.37 KB

README.md

File metadata and controls

51 lines (29 loc) · 1.37 KB
Raw

snoopset - DHCP snooping for ipset

This is a DHCP snooping daemon written in perl. It inspects DHCP packages between DHCP clients and servers and updates client leases into a ipset as ip,mac tuples.

This can be used to prevent clients using of IP addresses not assigned via DHCP using ebtables or iptables rules. The housekeeping of the ipset is done by the kernel since the ipset entries have a timeout corresponding to the DHCP lease time.

Dependencies

  • Net::DHCP
  • Net::Pcap
  • ipset

Prerequisites

You need to initialize an ipset for snoopset:

ipset create dhcp4_snoop hash:ip,mac family inet hashsize 4096 maxelem 65536 timeout 14400 counters comment forceadd

You need to enable the following required features:

  • comment - will contain the client's hostname and classid
  • timeout - ipset's timeout feature is used for housekeeping - you might use your default DHCP maximum lease time

For the other optional features see also ipset(8).

Installation

Traditional

On Debian systems all dependencies are available as packages:

# apt install libnet-dhcp-perl libnet-pcap-perl ipset

Docker

There is a Dockerfile in the source repository to build the container image. A pre-build container image is available at docker hub.

Usage

ebtables

TBD