Using pf on OS X Mountain Lion15 May 2013
I’ve written before about adding an extra layer of network security to your Macintosh by leveraging the BSD-level
ipfw firewall, in addition to the standard GUI firewall and additional third-party firewalls (like Little Snitch). In OS X Lion and OS X Mountain Lion, though,
ipfw was deprecated in favor of
pf, the powerful packet filter that I believe originated on OpenBSD. (OS X’s version of
pf is ported from FreeBSD.) In this article, I’m going to show you how to use
pf on OS X.
Note that this is just one way of leveraging
pf, not necessarily the only way of doing it. I tested (and am currently using) this configuration on OS X Mountain Lion 10.8.3.
There are X basic pieces involved in getting
pf up and running on OS X Mountain Lion:
pfconfiguration files in place.
Creating a launchd item for
Let’s look at each of these pieces in a bit more detail. We’ll start with the configuration files.
Putting Configuration Files in Place
OS X Mountain Lion comes with a barebones
/etc/pf.conf preinstalled. This barebones configuration file references a single anchor, found in
/etc/pf.anchors/com.apple. This anchor, however, does not contain any actual
pf rules; instead, it appears to be nothing more than a placeholder.
Since there is a configuration file already in place, you have two options ahead of you:
You can overwrite the existing configuration file. The drawback of this approach is that a) Apple has been known to change this file during system updates, undoing your changes; and b) it could break future OS X functionality.
You can bypass the existing configuration file. This is the approach I took, partly due to the reasons listed above and partly because I found that
pfctl(the program used to manage
pf) wouldn’t activate the filter rules when the existing configuration file was used. (It complained about improper order of lines in the existing configuration file.)
Note that some tools (like IceFloor) take the first approach and modify the existing configuration file.
I’ll assume you’re going to use option #2. What you’ll need, then, are (at a minimum) two configuration files:
pfconfiguration file you want it to parse on startup
At least one anchor file that contains the various options and rules you want to pass to
pfwhen it starts
Since we’re bypassing the existing configuration file, all you really need is an extremely simple configuration file that points to your anchor and loads it, like this:
The other file you need has the actual options and rules that will be passed to
pf when it starts. You can get fancy here and use a separate file to define macros and tables, or you can bundle the macros and tables in with the rules. Whatever approach you take, be sure that you have the commands in this file in the right order: options, normalization, queueing, translation, and filtering. Failure to put things in the right order will cause
pf not to enable and will leave your system without this additional layer of network protection.
A very simple set of rules in an anchor might look something like this:
Naturally, you’d want to customize these rules to fit your environment. At the end of this article I provide some additional resources that might help with this task.
Once you have the configuration file in place and at least one anchor defined with rules (in the right order!), then you’re ready to move ahead with creating the launchd item for
pf so that it starts automatically.
However, there is one additional thing you might want to do first—test your rules to be sure everything is correct. Use this command in a terminal window while running as an administrative user:
sudo pfctl -v -n -f <em><path to configuration file></em>
If this command reports errors, go back and fix them before proceeding.
Creating the launchd Item for pf
Creating the launchd item simply involves creating a properly-formatted XML file and placing it in
/Library/LaunchDaemons. It must be owned by root, otherwise it won’t be processed at all. If you aren’t clear on how to make sure it’s owned by root, go do a bit of reading on
Here’s a launchd item you might use for
A few notes about this launchd item:
You’ll want to change the last
<string>item under the ProgramArguments key to properly reflect the path and filename of the custom configuration file you created earlier. In my case, I’m storing both the configuration file and the anchor in the
As I stated earlier, you must ensure this file is owned by root once you put it into
/Library/LaunchDaemons. It won’t work otherwise.
If you have additional parameters you want/need to pass to
pfctl, add them as separate lines in the ProgramArguments array. Each individual argument on the command line must be a separate item in the array.
Once this file is in place with the right ownership, you can either use
launchctl to load it or restart your computer. The robust
pf firewall should now be running on your OS X Mountain Lion system. Enjoy!
Some Additional Resources
Finally, it’s important to note that I found a few different web sites helpful during my experimentations with
pf on OS X. This write-up was written with Lion in mind, but applies equally well to Mountain Lion, and this site–while clearly focused on OpenBSD and FreeBSD—was nevertheless quite helpful as well.
It should go without saying, but I’ll say it nevertheless: courteous comments are welcome! Feel free to add your thoughts, ideas, questions, or corrections below.Tags: BSD · CLI · Macintosh · Security · UNIX Previous Post: Joint OpenStack Denver and Infracoders Denver Meetup Next Post: Examining Open vSwitch Traffic Patterns