{"name":"snort","version":"2.0.0","description":"Installs Snort IDS packages","long_description":"snort Cookbook\n==============\n\n[![Cookbook Version](https://img.shields.io/cookbook/v/snort.svg)](https://supermarket.chef.io/cookbooks/snort)\n\nInstalls the SNORT IDS daemon. On Debian/Ubuntu systems, the packages\nfrom apt are used. On RHEL and Fedora systems, the packages are\nretrieved directly from the SNORT project site.\n\nRequirements\n------------\n#### Platforms\n\n* Ubuntu 10.04+\n* RHEL/CentOS, 7.0 and higher only.\n* Fedora 21+\n\nMay work on other platforms in the Debian and RHEL families with or\nwithout modification.\n\n#### Chef\n* Chef 12+\n\n#### Cookbooks\n* compat_resource to bring custom_resource functionality to chef-client < 12.5\n\nAttributes\n----------\n\nSee `attributes/default.rb` for default values.\n\n* `node['snort']['home_net']` - Address range to use for preseeding\n  `HOME_NET`.\n* `node['snort']['database']` - The database backend to use. Only\n  applicable on Debian/Ubuntu systems. Default none. MySQL and\n  PostgreSQL are usable. The default recipe will install the SNORT\n  package for the appropriate database backend. You'll need to make\n  sure that the database server is set up in some way such that SNORT\n  can connect to it. This cookbook does not yet support automatic\n  configuration.\n* `node['snort']['rpm']['daq_version']` - The full version string of\n  the daq package to install, e.g. \"`2.0.0-1.fc17`\".\n* `node['snort']['rpm']['daq_checksum']` - The SHA256 checksum of the\n  daq rpm.\n* `node['snort']['rpm']['version']` - The full version string of the\n  snort package to install, e.g., \"`2.9.4-1.f17`\".\n* `node['snort']['rpm']['checksum']` - The SHA256 checksum of the\n  snort rpm.\n\n\nRecipes\n-------\n\n####default.rb\nIncludes the _install.rb and _service.rb recipes\n\n####_install.rb\nInstalls the snort package from apt on Debian based systems, or RPMs downloaded from the snort.org site on RHEL based systems\n\n####_service.rb\nUsed the snort_service custom resource to start and enable the snort service\n\n\nResources\n---------\n\n###snort_service\n\n#### Properties\n- service_name: To override the platform based service_name used to start/enable the service pass a string here\n\n#### Examples\n```\nsnort_service 'snort' do\n  action :start\nend\n```\n\n```\nsnort_service 'snort' do\n  action [:start, :enable]\nend\n```\n\nUsage\n-----\n\nInclude `recipe[snort]` in a run list to have the system get SNORT\ninstalled and the service started. This performs a baseline installation and preseeds the\npackage. You should change the `node['snort']['home_net']` attribute\nto the appropriate network.\n\nWe recommend adding a `template` resource to the default recipe to\nmanage the `/etc/snort/snort.conf` file as a template. The default\nfile is good enough for now on Debian/Ubuntu.\n\nOn Ubuntu/Debian, the default rules package will be installed. You'll\nneed to download and install additional rules. Automatically updating\nrules with oinkmaster is not yet supported. See future plans.\n\nFuture Plans\n------------\n\nThe following features are planned for a future release of this\ncookbook. Contributions welcome.\n- Service management\n- Config management\n- Additional platforms\n\nReferences\n----------\n\n* [SNORT home page](http://www.snort.org)\n* [snort -h doesn't do what you think](http://blog.joelesler.net/2010/03/snort-h-doesnt-do-what-you-think-it-does.html)\n* [SNORT database output is dead](http://blog.snort.org/2012/07/database-output-is-dead-rip.html)\n\nLicense & Authors\n-----------------\n\n\n- Author: Joshua Timberman (<joshua@chef.io>)\n- Author: Tim Smith (<tsmith@chef.io>)\n- Copyright 2010-2015, Chef Software, Inc.\n\n```\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n","maintainer":"Joshua Timberman","maintainer_email":"cookbooks@housepub.org","license":"Apache 2.0","platforms":{"ubuntu":">= 0.0.0","debian":">= 0.0.0","redhat":">= 0.0.0","centos":">= 0.0.0","fedora":">= 0.0.0","scientific":">= 0.0.0","amazon":">= 0.0.0","oracle":">= 0.0.0"},"dependencies":{"compat_resource":">= 0.0.0"},"recommendations":{},"suggestions":{},"conflicting":{},"providing":{},"replacing":{},"attributes":{},"groupings":{},"recipes":{"snort::default":"Includes the _install recipe","snort::_install":"Installs snort packages based on platform"}}