README.md

kismet Cookbook

This cookbook configures the kismet wardriving application on Ubuntu. Perfect for setting up a wardriving rig using Chef Solo.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

Platforms

• Centos 6 and 7
• Debian 8 and 9
• Ubuntu 16.04 and 18.04
• Amazon 1 and 2

Chef

• Chef 12.9+

Cookbooks

• none

Attributes

The attributes in this cookbook are used to drive the configuration dynamically. The following are used for the gpsd service.

• enable_gpsd - Install and use gpsd. Defaults to true
• start_daemon - Start the daemon. Defaults to true
• gpsd_options - Options to pass to the daemon. Defaults to an empty string
• devices - Path to device. This is only needed for serial devices. Defaults to an
• empty string
• usbauto - Auto discover USB devices. Defaults to true

The remaining attributes in the attributes/default.rb are directly from the kismet.conf file and are namespaced under node['kismet']['config']. Each attribute key corresponds to a configuratino option in the kismet.conf file.

Values can be an Integer, String or an Array. Integer and String values will be rendered like this:

key=value

Array values will get an entry for each element in the array. For example, a value of ['value', 'sale', 'option'] will be rendered like this:

key=value
key=sale
key=option

The Ruby literals "false" and "true" are not used for values of Kismet configuration options. They are string values instead.

In practical terms, these attributes:

default['kismet']['config']['version'] = "2009-newcore"
default['kismet']['config']['hidedata']     = "true"
default['kismet']['config']['enablespeech'] = "false"
default['kismet']['config']['alertbacklog']     = 50
default['kismet']['config']['ouifile'] = [
  '/etc/manuf',
  '/usr/share/wireshark/wireshark/manuf',
  '/usr/share/wireshark/manuf'
]

Will be rendered in /etc/kismet/kismet.conf:

version=2009-newcore
hidedata=true
enablespeech=false
alertbacklog=50
ouifile=/etc/manuf
ouifile=/usr/share/wireshark/wireshark/manuf
ouifile=/usr/share/wireshark/manuf

Usage

Modify attributes for the configuration as required in a role. Add recipe[kismet] to your node's run list.

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.