Skip to content

Latest commit

 

History

History
114 lines (80 loc) · 4.84 KB

README.md

File metadata and controls

114 lines (80 loc) · 4.84 KB

kismet Cookbook

Cookbook Version Build Status OpenCollective OpenCollective License

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!

https://opencollective.com/sous-chefs#backers

Sponsors

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

https://opencollective.com/sous-chefs/sponsor/0/website https://opencollective.com/sous-chefs/sponsor/1/website https://opencollective.com/sous-chefs/sponsor/2/website https://opencollective.com/sous-chefs/sponsor/3/website https://opencollective.com/sous-chefs/sponsor/4/website https://opencollective.com/sous-chefs/sponsor/5/website https://opencollective.com/sous-chefs/sponsor/6/website https://opencollective.com/sous-chefs/sponsor/7/website https://opencollective.com/sous-chefs/sponsor/8/website https://opencollective.com/sous-chefs/sponsor/9/website