cookbook 'firewall', '= 0.6.0'
firewall
(96) Versions
0.6.0
-
-
6.3.7
-
6.3.6
-
6.3.5
-
6.3.4
-
6.3.3
-
6.3.2
-
6.3.1
-
6.3.0
-
6.2.18
-
6.2.17
-
6.2.16
-
6.2.15
-
6.2.14
-
6.2.13
-
6.2.12
-
6.2.11
-
6.2.10
-
6.2.9
-
6.2.8
-
6.2.7
-
6.2.6
-
6.2.5
-
6.2.4
-
6.2.3
-
6.2.2
-
6.2.1
-
6.2.0
-
6.1.0
-
6.0.2
-
6.0.1
-
6.0.0
-
5.1.0
-
5.0.0
-
4.0.3
-
4.0.2
-
4.0.1
-
4.0.0
-
3.0.2
-
3.0.1
-
3.0.0
-
2.7.1
-
2.7.0
-
2.6.5
-
2.6.4
-
2.6.3
-
2.6.2
-
2.6.1
-
2.6.0
-
2.5.4
-
2.5.3
-
2.5.2
-
2.5.1
-
2.5.0
-
2.4.0
-
2.3.1
-
2.3.0
-
2.2.0
-
2.1.0
-
2.0.5
-
2.0.4
-
2.0.3
-
2.0.2
-
2.0.1
-
2.0.0
-
1.6.2
-
1.6.1
-
1.6.0
-
1.5.2
-
1.5.1
-
1.5.0
-
1.4.0
-
1.3.0
-
1.2.0
-
1.1.2
-
1.1.1
-
1.1.0
-
1.0.2
-
1.0.1
-
1.0.0
-
0.11.8
-
0.11.6
-
0.11.4
-
0.11.2
-
0.11.0
-
0.10.2
-
0.10.0
-
0.9.2
-
0.9.0
-
0.8.2
-
0.8.0
-
0.6.0
-
0.5.7
-
0.5.6
-
0.5.5
-
0.5.2
-
0.5.0
Follow114
- 6.3.7
- 6.3.6
- 6.3.5
- 6.3.4
- 6.3.3
- 6.3.2
- 6.3.1
- 6.3.0
- 6.2.18
- 6.2.17
- 6.2.16
- 6.2.15
- 6.2.14
- 6.2.13
- 6.2.12
- 6.2.11
- 6.2.10
- 6.2.9
- 6.2.8
- 6.2.7
- 6.2.6
- 6.2.5
- 6.2.4
- 6.2.3
- 6.2.2
- 6.2.1
- 6.2.0
- 6.1.0
- 6.0.2
- 6.0.1
- 6.0.0
- 5.1.0
- 5.0.0
- 4.0.3
- 4.0.2
- 4.0.1
- 4.0.0
- 3.0.2
- 3.0.1
- 3.0.0
- 2.7.1
- 2.7.0
- 2.6.5
- 2.6.4
- 2.6.3
- 2.6.2
- 2.6.1
- 2.6.0
- 2.5.4
- 2.5.3
- 2.5.2
- 2.5.1
- 2.5.0
- 2.4.0
- 2.3.1
- 2.3.0
- 2.2.0
- 2.1.0
- 2.0.5
- 2.0.4
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 1.6.2
- 1.6.1
- 1.6.0
- 1.5.2
- 1.5.1
- 1.5.0
- 1.4.0
- 1.3.0
- 1.2.0
- 1.1.2
- 1.1.1
- 1.1.0
- 1.0.2
- 1.0.1
- 1.0.0
- 0.11.8
- 0.11.6
- 0.11.4
- 0.11.2
- 0.11.0
- 0.10.2
- 0.10.0
- 0.9.2
- 0.9.0
- 0.8.2
- 0.8.0
- 0.6.0
- 0.5.7
- 0.5.6
- 0.5.5
- 0.5.2
- 0.5.0
Provides a set of primitives for managing firewalls and associated rules.
cookbook 'firewall', '= 0.6.0', :supermarket
knife supermarket install firewall
knife supermarket download firewall
Description
Provides a set of primitives for managing firewalls and associated rules.
PLEASE NOTE - The resource/providers in this cookbook are under heavy development.
An attempt is being made to keep the resource simple/stupid by starting with less
sophisticated firewall implementations first and refactor/vet the resource definition
with each successive provider.
Requirements
Platform
- Ubuntu
Tested on:
- Ubuntu 10.04
- Ubuntu 11.04
Resources/Providers
firewall
Actions
- :enable: enable the firewall. this will make any rules that have been defined 'active'.
- :disable: disable the firewall. drop any rules and put the node in an unprotected state.
- :reset: reset the firewall. drop any rules and puts the node in the default state. Does not enable or disable the firewall.
- :logging: set the logging level for the firewall. Requires the 'level' attribute parameter. Default if unset if 'low'.
Attribute Parameters
- name: name attribute. arbitrary name to uniquely identify this resource
- level: used by the
loggingaction, options are 'on', 'off', 'low', 'medium', 'high' and 'full'.
Providers
-
Chef::Provider::Firewall::Ufw- platform default: Ubuntu
Examples
# enable platform default firewall
firewall "ufw" do
action :enable
end
# increase logging past default of 'low'
firewall "debug firewalls" do
level 'high'
action :logging
end
firewall_rule
Actions
- :allow: the rule should allow incoming traffic.
- :deny: the rule should deny incoming traffic.
- :logging: the rule should reject incoming traffic.
- :reject: the rule should reject incoming traffic.
Attribute Parameters
- name: name attribute. arbitrary name to uniquely identify this firewall rule
- protocol: valid values are: :udp, :tcp. default is all protocols
- port: incoming port number (ie. 22 to allow inbound SSH)
- source: ip address or subnet to filter on incoming traffic. default is
0.0.0.0/0(ie Anywhere) - destination: ip address or subnet to filter on outgoing traffic.
- dest_port: outgoing port number.
- position: position to insert rule at. if not provided rule is inserted at the end of the rule list.
- direction: direction of the rule. 'in' or 'out' are supported, 'in' is default.
- interface: interface to apply rule (ie. 'eth0').
- logging: may be added to enable logging for a particular rule. 'log' and 'log-all' are supported options. In the ufw provider, 'log' logs new connections while 'log-all' logs all packets.
Providers
-
Chef::Provider::FirewallRule::Ufw- platform default: Ubuntu
Examples
# open standard ssh port, enable firewall
firewall_rule "ssh" do
port 22
action :allow
notifies :enable, "firewall[ufw]"
end
# open standard http port to tcp traffic only; insert as first rule
firewall_rule "http" do
port 80
protocol 'tcp'
position 1
action :allow
end
# restrict port 13579 to 10.0.111.0/24 on eth0
firewall_rule "myapplication" do
port 13579
source '10.0.111.0/24'
direction 'in'
interface 'eth0'
action :allow
end
firewall "ufw" do
action :nothing
end
Changes/Roadmap
Future
- [COOK-688] create iptables providers for all resources
- [COOK-689] create windows firewall providers for all resources
- [COOK-690] create firewall_chain resource
- [COOK-693] create pf firewall providers for all resources
0.6
- [COOK-725] Firewall cookbook firewall_rule LWRP needs to support logging attribute.
- Firewall cookbook firewall LWRP needs to support :logging
0.5.7
- [COOK-696] Firewall cookbook firewall_rule LWRP needs to support interface
- [COOK-697] Firewall cookbook firewall_rule LWRP needs to support the direction for the rules
0.5.6
- [COOK-695] Firewall cookbook firewall_rule LWRP needs to support destination port
0.5.5
- [COOK-709] fixed :nothing action for the 'firewall_rule' resource.
0.5.4
- [COOK-694] added :reject action to the 'firewall_rule' resource.
0.5.3
- [COOK-698] added :reset action to the 'firewall' resource.
0.5.2
- add missing 'requires' statements. fixes 'NameError: uninitialized constant' error.
thanks to Ernad Husremović for the fix.
0.5.0
- [COOK-686] create firewall and firewall_rule resources
- [COOK-687] create UFW providers for all resources
License and Author
Author:: Seth Chisamore (schisamo@opscode.com)
Copyright:: Copyright (c) 2011 Opscode, Inc.
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
This cookbook has no specified dependencies.
