cookbook 'kali', '= 0.3.0'
kali (11) Versions 0.3.0 Follow2
Installs/Configures Kali linux
cookbook 'kali', '= 0.3.0', :supermarket
knife supermarket install kali
knife supermarket download kali
kali Cookbook |
This cookbook installs and configures kali linux for debian OS.
It provides an easy way to manage your pentest environment with Chef!
Requirements
cookbooks
-
apt
- https://supermarket.getchef.com/cookbooks/apt -
ohai
- https://supermarket.getchef.com/cookbooks/ohai
platforms
The following platforms and versions are tested and supported using Opscode's test-kitchen.
- Debian 7.6
- Debian 8.1
Attributes
kali::default
<table>
<tr>
<th>Key</th>
<th>Type</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><tt>['kali']['distribution']</tt></td>
<td>String</td>
<td>Distribution to use for apt repository</td>
<td><tt>sana</tt></td>
</tr>
<tr>
<td><tt>['kali']['keyserver']</tt></td>
<td>String</td>
<td>GPG keys server</td>
<td><tt>pgp.mit.edu</tt></td>
</tr>
<tr>
<td><tt>['kali']['apt_timeout']</tt></td>
<td>Interger</td>
<td>Timeout for packages installation</td>
<td><tt>1800</tt></td>
</tr>
</table>
kali::rogue-ap
<table>
<tr>
<th>Key</th>
<th>Type</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><tt>['kali']['rogue-ap'][interface']</tt></td>
<td>String</td>
<td>Wireles interface</td>
<td><tt>wlan0</tt></td>
</tr>
<tr>
<td><tt>['kali']['rogue-ap']['out_interface']</tt></td>
<td>String</td>
<td>Output interface</td>
<td><tt>eth0</tt></td>
</tr>
<tr>
<td><tt>['kali']['rogue-ap']['script_path']</tt></td>
<td>String</td>
<td>Path for rogue-ap.sh script</td>
<td><tt>/root/rogue-ap.sh</tt></td>
</tr>
<tr>
<td><tt>['kali']['rogue-ap']['packages']</tt></td>
<td>Array</td>
<td>List of packages to install</td>
<td><tt>See attribute file</tt></td>
</tr>
<tr>
<td><tt>['kali']['rogue-ap']['dnsmasq']</tt></td>
<td>Hash</td>
<td>Hash of dnsmasq config</td>
<td><tt>See attribute file</tt></td>
</tr>
<tr>
<td><tt>['kali']['rogue-ap']['hostapd']</tt></td>
<td>Hash</td>
<td>Hash of hostapd config</td>
<td><tt>See attribute file</tt></td>
</tr>
</table>
Automatic Attribute
The kali::default
recipe will add an automatic attribute in your node named kali_release
.
This attribute contains the current Kali release of your machine, This value is gathered from /etc/issue
file.
Usage
kali::default
Just include kali
in your node's run_list
:
{ "name":"my_node", "run_list": [ "recipe[kali]" ] }
This will add kali linux repositories in apt sources and install the base of Kali linux system.
Additionally, you can include the following recipes as your need, these are based on kali linux metapackages:
- all
- All available packages in Kali linux
- forensic
- Forensic tools
- full
- Default Kali linux install
- gpu
- GPU-Powered tools
- pwtools
- Password Cracking tools
- rfid
- RFID tools
- sdr
- Software Defined Radio tools
- top10
- Top 10 Kali linux tools
- voip
- VoIP tools
- web
- Web assessment tools
- wireless
- Wireless tools
See the official documentation: http://tools.kali.org/kali-metapackages
kali::rogue-ap
Just include kali::rogue-ap
in your node's run_list
to setup a Rogue AP:
{ "name":"my_node", "run_list": [ "recipe[kali]", "recipe[kali::rogue-ap]" ] }
Contributing
- Fork the repository on Github
- Create a named feature branch (like
add_component_x
) - Write your change
- Write tests for your change (if applicable)
- Run the tests, ensuring they all pass
- Submit a Pull Request using Github
License and Authors
Authors: Sliim sliim@mailoo.org
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Dependent cookbooks
apt >= 0.0.0 |
ohai >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
kali CHANGELOG
This file is used to list changes made in each version of the kali cookbook.
0.3.0
- Add
kali_release
automatic attribute.
0.2.1
- New recipe
kali::rogue-ap
to setup a Rogue AP
0.2.0
- Support for Kali 2.0
- New attributes for apt repository
- Timeout attribute for packages installation
0.1.1
- Packages authentication with gpg signature
0.1.0
- Initial release of kali cookbook
Foodcritic Metric
0.3.0 passed this metric
0.3.0 passed this metric