arpbox

Enrich ARP data with device information from NetBox

Build arpbox

Either build from published source in crates.io.

$ cargo install arpbox --locked

Or download from github releases.

Usage

Configure

Create ~/.config/arpbox/config.toml.

v1 (Token authentication)

netbox_url = "https://netbox.example.com"
netbox_token = "your_api_token"

This uses the Token <token> authorization header.

v2 (Bearer/key authentication)

netbox_url = "https://netbox.example.com"
netbox_token = "your_api_token"
netbox_key = "your_key_id"

This uses the Bearer nbt_<key>.<token> authorization header.

Run

Look up a single MAC address:

$ arpbox 00:11:22:33:44:55

Or pipe arp-scan into arpbox:

$ arp-scan --localnet | arpbox

Lines with a NetBox match are enriched:

192.168.1.1	00:11:22:33:44:55	(netbox://device-name:asset-tag:interface)	Vendor Name

Lines without a match pass through unchanged.