<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Patrick</title>
    <description>The latest articles on DEV Community by Patrick (@postmanpat).</description>
    <link>https://dev.to/postmanpat</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4249511%2F9e148c5d-dbb1-4ffc-b976-4d0f3da1ad8b.jpeg</url>
      <title>DEV Community: Patrick</title>
      <link>https://dev.to/postmanpat</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/postmanpat"/>
    <language>en</language>
    <item>
      <title>A Default-Deny NAT Firewall on OpenBSD pf, Managed with Terraform</title>
      <dc:creator>Patrick</dc:creator>
      <pubDate>Fri, 20 Nov 2026 08:00:02 +0000</pubDate>
      <link>https://dev.to/postmanpat/a-default-deny-nat-firewall-on-openbsd-pf-managed-with-terraform-39ph</link>
      <guid>https://dev.to/postmanpat/a-default-deny-nat-firewall-on-openbsd-pf-managed-with-terraform-39ph</guid>
      <description>&lt;p&gt;pf is the best firewall I have worked with: one readable file, atomic reloads, NAT and queueing in the same language as the filter rules. What it lacks is an API. Every tool that wants to change a pf firewall ends up templating &lt;code&gt;pf.conf&lt;/code&gt;, copying it over SSH and hoping &lt;code&gt;pfctl -f&lt;/code&gt; likes it.&lt;/p&gt;

&lt;p&gt;I wrote &lt;a href="https://github.com/pderuiter/pfapid" rel="noopener noreferrer"&gt;pfapid&lt;/a&gt; to fix that: a small REST API for pf that runs on the firewall itself, with a &lt;a href="https://registry.terraform.io/providers/pderuiter/pf/latest" rel="noopener noreferrer"&gt;Terraform provider&lt;/a&gt; on top. This post builds a complete NAT firewall with it: a default-deny base, outbound NAT, a port forward to a DMZ web server, a blocklist and QoS on the uplink.&lt;/p&gt;

&lt;h2&gt;
  
  
  What pfapid manages, and what it doesn't
&lt;/h2&gt;

&lt;p&gt;pfapid splits the firewall into two owners:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Part&lt;/th&gt;
&lt;th&gt;Owned by&lt;/th&gt;
&lt;th&gt;Lives in&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Defaults, &lt;code&gt;block all&lt;/code&gt;, antispoof, management access&lt;/td&gt;
&lt;td&gt;You, by hand or config management&lt;/td&gt;
&lt;td&gt;&lt;code&gt;/etc/pf.conf&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Filter and NAT rules, per unit of work&lt;/td&gt;
&lt;td&gt;Terraform via pfapid&lt;/td&gt;
&lt;td&gt;Anchors &lt;code&gt;api/&amp;lt;name&amp;gt;&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Contents of tables such as &lt;code&gt;&amp;lt;blocklist&amp;gt;&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;Terraform via pfapid&lt;/td&gt;
&lt;td&gt;Tables declared in &lt;code&gt;pf.conf&lt;/code&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;HFSC queues and the rules that classify into them&lt;/td&gt;
&lt;td&gt;Terraform via pfapid&lt;/td&gt;
&lt;td&gt;The &lt;code&gt;api-qos&lt;/code&gt; anchor and a queue include&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;The base ruleset is the part you can't afford to get wrong, so the API can't touch it. Whatever Terraform does, the &lt;code&gt;block&lt;/code&gt; and management rules in &lt;code&gt;pf.conf&lt;/code&gt; come first.&lt;/p&gt;

&lt;h3&gt;
  
  
  Why not just template pf.conf?
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;terraform plan&lt;/code&gt; asks pf.&lt;/strong&gt; The provider sends the rules to the firewall, where pfapid runs &lt;code&gt;pfctl -n&lt;/code&gt; on them. A rule pf would refuse fails the plan, not the apply, and the plan shows the exact lines pf will load.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Commit-confirm.&lt;/strong&gt; Every change is loaded, then rolled back by the firewall itself unless the provider confirms it within &lt;code&gt;confirm_timeout&lt;/code&gt;. If an apply cuts off the path between Terraform and the firewall, the change undoes itself.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Drift detection.&lt;/strong&gt; Someone runs &lt;code&gt;pfctl&lt;/code&gt; by hand at 3 a.m.? The next plan warns, and the next apply puts the rules back.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Small blast radius.&lt;/strong&gt; pfapid runs privilege-separated: the HTTPS side runs as &lt;code&gt;_pfapid&lt;/code&gt; under &lt;code&gt;pledge("stdio inet")&lt;/code&gt;, and only a tiny root process runs &lt;code&gt;pfctl&lt;/code&gt;. Clients authenticate with mTLS and are scoped to anchors and tables. There is no raw pf.conf passthrough: rules are typed objects, rendered and checked before pf sees them.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  When to use it
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Use it&lt;/strong&gt; when firewall rules belong to the same change as the thing they protect: a new service, a Kubernetes cluster, a customer network. They get reviewed and planned together.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Skip it&lt;/strong&gt; for a firewall nobody changes, or one with a single admin who is happy with &lt;code&gt;vi /etc/pf.conf&lt;/code&gt;. A text file with good comments is hard to beat.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  The network
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;                 internet
                     |
               wan  vio0   203.0.113.2/24, 2001:db8:1::2/64   (egress)
          +----------------------+
 mgmt     |                      |  lan  vio1   10.0.10.1/24, 2001:db8:10::1/64
 vio3 ----+   OpenBSD + pfapid   +-------------  office clients, VoIP phones
 192.168. |                      |
 100.1/24 |                      |  dmz  vio2   10.0.20.1/24, 2001:db8:20::1/64
          +----------------------+-------------  web server 10.0.20.10, 2001:db8:20::10
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The rules use &lt;strong&gt;interface groups&lt;/strong&gt; (&lt;code&gt;wan&lt;/code&gt;, &lt;code&gt;lan&lt;/code&gt;, &lt;code&gt;dmz&lt;/code&gt;, &lt;code&gt;mgmt&lt;/code&gt;), never device names. When you replace a NIC or move a network to a VLAN, you add the new interface to the group and no rule changes:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# /etc/hostname.vio0 and friends: one "group" line each&lt;/span&gt;
&lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s1"&gt;'group wan'&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&amp;gt;&lt;/span&gt; /etc/hostname.vio0
ifconfig vio0 group wan
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;What we want:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;From&lt;/th&gt;
&lt;th&gt;To&lt;/th&gt;
&lt;th&gt;What&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;lan&lt;/td&gt;
&lt;td&gt;internet&lt;/td&gt;
&lt;td&gt;Everything, IPv4 behind NAT, IPv6 routed&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;dmz&lt;/td&gt;
&lt;td&gt;internet&lt;/td&gt;
&lt;td&gt;DNS, NTP and HTTPS only (updates)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;internet, lan&lt;/td&gt;
&lt;td&gt;web server&lt;/td&gt;
&lt;td&gt;TCP 80 and 443; IPv4 through a port forward on the wan address&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;&amp;lt;blocklist&amp;gt;&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;anything&lt;/td&gt;
&lt;td&gt;Nothing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;mgmt network&lt;/td&gt;
&lt;td&gt;firewall&lt;/td&gt;
&lt;td&gt;SSH and the pfapid API&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Everything else&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;Dropped and logged&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Step 1: Install pfapid
&lt;/h2&gt;

&lt;p&gt;pfapid ships as signed release archives for OpenBSD amd64 and arm64. Check the signature before you install it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# on a workstation with gpg&lt;/span&gt;
&lt;span class="nv"&gt;v&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$(&lt;/span&gt;curl -s https://api.github.com/repos/pderuiter/pfapid/releases/latest &lt;span class="o"&gt;|&lt;/span&gt;
    sed -n &lt;span class="s1"&gt;'s/.*"tag_name": *"v\([^"]*\)".*/\1/p'&lt;/span&gt;&lt;span class="o"&gt;)&lt;/span&gt;
&lt;span class="nv"&gt;base&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;https://github.com/pderuiter/pfapid/releases/download/v&lt;span class="nv"&gt;$v&lt;/span&gt;
curl -sSLO &lt;span class="nv"&gt;$base&lt;/span&gt;/pfapid_&lt;span class="nv"&gt;${v}&lt;/span&gt;_openbsd_amd64.tar.gz
curl -sSLO &lt;span class="nv"&gt;$base&lt;/span&gt;/pfapid_&lt;span class="nv"&gt;${v}&lt;/span&gt;_SHA256SUMS -O &lt;span class="nv"&gt;$base&lt;/span&gt;/pfapid_&lt;span class="nv"&gt;${v}&lt;/span&gt;_SHA256SUMS.sig
curl -sSL https://raw.githubusercontent.com/pderuiter/pfapid/main/scripts/release-signing-key.asc &lt;span class="o"&gt;|&lt;/span&gt; gpg --import
gpg --verify pfapid_&lt;span class="nv"&gt;${v}&lt;/span&gt;_SHA256SUMS.sig pfapid_&lt;span class="nv"&gt;${v}&lt;/span&gt;_SHA256SUMS
shasum -a 256 --ignore-missing -c pfapid_&lt;span class="nv"&gt;${v}&lt;/span&gt;_SHA256SUMS
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;gpg&lt;/code&gt; must report a good signature from key &lt;code&gt;10A2F1058821D55C61E45C7EE97C02FEE2F51B23&lt;/code&gt;. Then on the firewall, as root:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;tar xzf pfapid_*_openbsd_amd64.tar.gz
useradd -s /sbin/nologin -d /var/empty -L daemon -c &lt;span class="s2"&gt;"pfapid network process"&lt;/span&gt; _pfapid
install -o root -g wheel -m 0555 pfapid /usr/local/sbin/pfapid
install -o root -g wheel -m 0555 deploy/rc.d/pfapid /etc/rc.d/pfapid
install -d -o root -g wheel -m 0700 /etc/pfapid /var/db/pfapid
install -d -o root -g wheel -m 0755 /etc/pf.anchors/api
&lt;span class="k"&gt;for&lt;/span&gt; f &lt;span class="k"&gt;in&lt;/span&gt; api.conf api-queues.conf api-qos.conf&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="k"&gt;do&lt;/span&gt;
    &lt;span class="o"&gt;[&lt;/span&gt; -f /etc/pf.anchors/&lt;span class="nv"&gt;$f&lt;/span&gt; &lt;span class="o"&gt;]&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; install -o root -g wheel -m 0600 /dev/null /etc/pf.anchors/&lt;span class="nv"&gt;$f&lt;/span&gt;
&lt;span class="k"&gt;done&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The three empty files must exist before &lt;code&gt;pf.conf&lt;/code&gt; includes them; pfapid fills them later.&lt;/p&gt;

&lt;p&gt;pfapid has a built-in CA, so you don't need a PKI to get started. Create the CA and the server certificate, then a client certificate for Terraform:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pfapid pki init -dns fw.example.net -ip 192.168.100.1
pfapid pki issue -name tf-firewall -out /root/tf-firewall   &lt;span class="c"&gt;# writes tf-firewall.crt and .key&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Copy &lt;code&gt;/root/tf-firewall.crt&lt;/code&gt;, &lt;code&gt;/root/tf-firewall.key&lt;/code&gt; and the CA certificate (&lt;code&gt;/etc/pfapid/pki/ca.crt&lt;/code&gt;) to the machine that runs Terraform, and delete the key from the firewall. A company CA, Vault or SPIFFE IDs work too; see &lt;a href="https://github.com/pderuiter/pfapid/blob/main/docs/CERTIFICATES.md" rel="noopener noreferrer"&gt;CERTIFICATES.md&lt;/a&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 2: The default-deny base ruleset
&lt;/h2&gt;

&lt;p&gt;This file is yours. It holds everything that must hold no matter what the API does:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight conf"&gt;&lt;code&gt;&lt;span class="c1"&gt;# /etc/pf.conf: default-deny base ruleset for a pfapid-managed NAT firewall.
#
#   wan   vio0 (egress)  203.0.113.2/24, 2001:db8:1::2/64
#   lan   vio1           10.0.10.1/24,   2001:db8:10::1/64
#   dmz   vio2           10.0.20.1/24,   2001:db8:20::1/64
#   mgmt  vio3           192.168.100.1/24
&lt;/span&gt;&lt;span class="na"&gt;admin_nets&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"192.168.100.0/24"&lt;/span&gt;

&lt;span class="n"&gt;set&lt;/span&gt; &lt;span class="n"&gt;skip&lt;/span&gt; &lt;span class="n"&gt;on&lt;/span&gt; &lt;span class="n"&gt;lo&lt;/span&gt;
&lt;span class="n"&gt;set&lt;/span&gt; &lt;span class="n"&gt;block&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;policy&lt;/span&gt; &lt;span class="n"&gt;drop&lt;/span&gt;
&lt;span class="n"&gt;set&lt;/span&gt; &lt;span class="n"&gt;loginterface&lt;/span&gt; &lt;span class="n"&gt;egress&lt;/span&gt;

&lt;span class="c1"&gt;# Tables whose contents pfapid manages: declared empty, with persist,
# so a reload of this file keeps what Terraform put in them.
&lt;/span&gt;&lt;span class="n"&gt;table&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;dmz_web&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;persist&lt;/span&gt;
&lt;span class="n"&gt;table&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;blocklist&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;persist&lt;/span&gt;

&lt;span class="c1"&gt;# Default deny: nothing passes, in or out, unless a rule says so.
&lt;/span&gt;&lt;span class="n"&gt;block&lt;/span&gt; &lt;span class="n"&gt;log&lt;/span&gt; &lt;span class="n"&gt;all&lt;/span&gt;

&lt;span class="c1"&gt;# Packets on lan or dmz must come from that network.
&lt;/span&gt;&lt;span class="n"&gt;antispoof&lt;/span&gt; &lt;span class="n"&gt;quick&lt;/span&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;lan&lt;/span&gt; &lt;span class="n"&gt;dmz&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="c1"&gt;# Management first, and quick: nothing in the API anchors can take it away.
&lt;/span&gt;&lt;span class="n"&gt;pass&lt;/span&gt; &lt;span class="n"&gt;in&lt;/span&gt; &lt;span class="n"&gt;quick&lt;/span&gt; &lt;span class="n"&gt;on&lt;/span&gt; &lt;span class="n"&gt;mgmt&lt;/span&gt; &lt;span class="n"&gt;proto&lt;/span&gt; &lt;span class="n"&gt;tcp&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; $&lt;span class="n"&gt;admin_nets&lt;/span&gt; &lt;span class="n"&gt;to&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;mgmt&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="n"&gt;port&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="mi"&gt;22&lt;/span&gt; &lt;span class="mi"&gt;8443&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="c1"&gt;# IPv6 breaks without these: neighbour discovery and path MTU discovery.
&lt;/span&gt;&lt;span class="n"&gt;pass&lt;/span&gt; &lt;span class="n"&gt;quick&lt;/span&gt; &lt;span class="n"&gt;inet6&lt;/span&gt; &lt;span class="n"&gt;proto&lt;/span&gt; &lt;span class="n"&gt;icmp6&lt;/span&gt; &lt;span class="n"&gt;icmp6&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="k"&gt;type&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;unreach&lt;/span&gt; &lt;span class="n"&gt;toobig&lt;/span&gt; &lt;span class="n"&gt;timex&lt;/span&gt; &lt;span class="n"&gt;paramprob&lt;/span&gt; \
    &lt;span class="n"&gt;routersol&lt;/span&gt; &lt;span class="n"&gt;routeradv&lt;/span&gt; &lt;span class="n"&gt;neighbrsol&lt;/span&gt; &lt;span class="n"&gt;neighbradv&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="c1"&gt;# The firewall offers no services to the inside networks.
&lt;/span&gt;&lt;span class="n"&gt;block&lt;/span&gt; &lt;span class="n"&gt;in&lt;/span&gt; &lt;span class="n"&gt;quick&lt;/span&gt; &lt;span class="n"&gt;on&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;lan&lt;/span&gt; &lt;span class="n"&gt;dmz&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="n"&gt;to&lt;/span&gt; &lt;span class="n"&gt;self&lt;/span&gt;

&lt;span class="c1"&gt;# The firewall's own traffic (DNS, NTP, syspatch).
&lt;/span&gt;&lt;span class="n"&gt;pass&lt;/span&gt; &lt;span class="n"&gt;out&lt;/span&gt; &lt;span class="n"&gt;quick&lt;/span&gt; &lt;span class="n"&gt;on&lt;/span&gt; &lt;span class="n"&gt;egress&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;egress&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="c1"&gt;# pfapid: QoS classification, then the API anchors.
&lt;/span&gt;&lt;span class="n"&gt;include&lt;/span&gt; &lt;span class="s2"&gt;"/etc/pf.anchors/api-queues.conf"&lt;/span&gt;
&lt;span class="n"&gt;anchor&lt;/span&gt; &lt;span class="s2"&gt;"api-qos"&lt;/span&gt;
&lt;span class="n"&gt;load&lt;/span&gt; &lt;span class="n"&gt;anchor&lt;/span&gt; &lt;span class="s2"&gt;"api-qos"&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="s2"&gt;"/etc/pf.anchors/api-qos.conf"&lt;/span&gt;
&lt;span class="n"&gt;anchor&lt;/span&gt; &lt;span class="s2"&gt;"api/*"&lt;/span&gt;
&lt;span class="n"&gt;include&lt;/span&gt; &lt;span class="s2"&gt;"/etc/pf.anchors/api.conf"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Block by block:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;block log all&lt;/code&gt;&lt;/strong&gt; is the default-deny. pf uses the &lt;em&gt;last&lt;/em&gt; matching rule, so every &lt;code&gt;pass&lt;/code&gt; further down (and in the anchors) can open a hole, but nothing is open by default. It applies in both directions, which matters for forwarded traffic later.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;antispoof&lt;/code&gt;&lt;/strong&gt; drops packets on lan or dmz with a source address that doesn't belong there.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Management&lt;/strong&gt; comes before the anchors and is &lt;code&gt;quick&lt;/code&gt;: pf stops evaluating on the first &lt;code&gt;quick&lt;/code&gt; match, so no anchor can override it. pfapid also refuses the &lt;code&gt;mgmt&lt;/code&gt; group in any API rule.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;ICMPv6&lt;/strong&gt; for neighbour discovery and path MTU. Without it, IPv6 breaks in slow, confusing ways. pfapid won't let the API block these either.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;block in quick on { lan dmz } to self&lt;/code&gt;&lt;/strong&gt; keeps the inside networks away from the firewall's own addresses, including the API. If the firewall runs DNS or DHCP for the LAN, add a &lt;code&gt;pass in quick&lt;/code&gt; for exactly that above this line.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The pfapid hooks&lt;/strong&gt;: the queue include and the &lt;code&gt;api-qos&lt;/code&gt; anchor come before &lt;code&gt;anchor "api/*"&lt;/code&gt;, so traffic is classified before an API rule passes it. &lt;code&gt;api.conf&lt;/code&gt; is generated by pfapid with one &lt;code&gt;load anchor&lt;/code&gt; line per anchor, so the anchors survive a reboot.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Check the file, then load it with a way back. I locked myself out of my lab firewall while writing this post: my workstation wasn't in &lt;code&gt;admin_nets&lt;/code&gt;. A background job that restores the old file after 90 seconds unless I cancel it brought the firewall back on its own:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pfctl -nf /etc/pf.conf.new            &lt;span class="c"&gt;# syntax check, loads nothing&lt;/span&gt;
cp -p /etc/pf.conf /etc/pf.conf.good
install -m 0600 /etc/pf.conf.new /etc/pf.conf
rm -f /tmp/pf-keep
&lt;span class="o"&gt;(&lt;/span&gt; sleep 90&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="o"&gt;[&lt;/span&gt; -f /tmp/pf-keep &lt;span class="o"&gt;]&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="o"&gt;{&lt;/span&gt; cp -p /etc/pf.conf.good /etc/pf.conf&lt;span class="o"&gt;;&lt;/span&gt; pfctl -f /etc/pf.conf&lt;span class="o"&gt;;&lt;/span&gt; &lt;span class="o"&gt;}&lt;/span&gt; &lt;span class="o"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&lt;/span&gt;
pfctl -f /etc/pf.conf
&lt;span class="c"&gt;# from a NEW ssh session: it works, keep it&lt;/span&gt;
touch /tmp/pf-keep
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The test has to be a &lt;em&gt;new&lt;/em&gt; connection: existing SSH sessions keep their state and survive a rule change that would lock out the next login.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 3: Tell pfapid what it may touch
&lt;/h2&gt;

&lt;p&gt;&lt;code&gt;/etc/pfapid.json&lt;/code&gt; (mode 0600, root) lists the interface groups, tables and queue devices the API may use, and which client may do what:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nl"&gt;"listen"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"192.168.100.1:8443"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"tls"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nl"&gt;"cert"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"/etc/pfapid/pki/server.crt"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nl"&gt;"key"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"/etc/pfapid/pki/server.key"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nl"&gt;"client_cas"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;"pfapid"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"/etc/pfapid/pki/ca.crt"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"confirm_timeout"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"60s"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"policy"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nl"&gt;"interfaces"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"wan"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"lan"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"dmz"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nl"&gt;"tables"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"dmz_web"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"blocklist"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nl"&gt;"queue_interfaces"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"vio0"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="nl"&gt;"internal_nets"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"10.0.0.0/8"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"172.16.0.0/12"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"192.168.0.0/16"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"fd00::/8"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="nl"&gt;"clients"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nl"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"tf-firewall"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"ca"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"pfapid"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"anchors"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"*"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"tables"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"dmz_web"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"blocklist"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nl"&gt;"qos"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;interfaces&lt;/code&gt;&lt;/strong&gt; are the groups rules may name. &lt;code&gt;mgmt&lt;/code&gt; is refused here and in every rule.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;tables&lt;/code&gt;&lt;/strong&gt; must also be declared in &lt;code&gt;pf.conf&lt;/code&gt;, empty and with &lt;code&gt;persist&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;queue_interfaces&lt;/code&gt;&lt;/strong&gt; are physical devices: pf can't hang a queue on a group.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;internal_nets&lt;/code&gt;&lt;/strong&gt;: pfapid refuses NAT &lt;em&gt;between&lt;/em&gt; two of these networks, a common mistake that hides where traffic really comes from. NAT from the LAN to the internet is fine.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;clients&lt;/code&gt;&lt;/strong&gt;: &lt;code&gt;tf-firewall&lt;/code&gt; (the certificate's CN) may manage every anchor, these two tables and QoS. A team that only owns its own service would get &lt;code&gt;"anchors": ["webshop-*"]&lt;/code&gt; and nothing else.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Start it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pfapid -f /etc/pfapid.json -n       &lt;span class="c"&gt;# checks the configuration and certificates&lt;/span&gt;
rcctl &lt;span class="nb"&gt;enable&lt;/span&gt; pfapid
rcctl start pfapid
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Step 4: The Terraform provider
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight hcl"&gt;&lt;code&gt;&lt;span class="n"&gt;terraform&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;required_providers&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;pf&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;source&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pderuiter/pf"&lt;/span&gt;
      &lt;span class="n"&gt;version&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"~&amp;gt; 0.1"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="c1"&gt;# Endpoint and certificates come from the environment:&lt;/span&gt;
&lt;span class="c1"&gt;#   PFAPID_ENDPOINT, PFAPID_CA_CERT, PFAPID_CLIENT_CERT, PFAPID_CLIENT_KEY&lt;/span&gt;
&lt;span class="n"&gt;provider&lt;/span&gt; &lt;span class="s2"&gt;"pf"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="kd"&gt;export&lt;/span&gt; &lt;span class="nv"&gt;PFAPID_ENDPOINT&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;https://192.168.100.1:8443
&lt;span class="kd"&gt;export&lt;/span&gt; &lt;span class="nv"&gt;PFAPID_CA_CERT&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$HOME&lt;/span&gt;/.pfapid/ca.crt
&lt;span class="kd"&gt;export&lt;/span&gt; &lt;span class="nv"&gt;PFAPID_CLIENT_CERT&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$HOME&lt;/span&gt;/.pfapid/tf-firewall.crt
&lt;span class="kd"&gt;export&lt;/span&gt; &lt;span class="nv"&gt;PFAPID_CLIENT_KEY&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="nv"&gt;$HOME&lt;/span&gt;/.pfapid/tf-firewall.key
terraform init
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The provider is signed with the same key as the pfapid releases; &lt;code&gt;terraform init&lt;/code&gt; checks that for you.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 5: Tables
&lt;/h2&gt;

&lt;p&gt;Tables are lists of addresses that rules refer to as &lt;code&gt;&amp;lt;name&amp;gt;&lt;/code&gt;. Changing a table never reloads a rule, so it's the cheap way to add a web server or block a network. A table can hold IPv4 and IPv6 entries side by side:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight hcl"&gt;&lt;code&gt;&lt;span class="c1"&gt;# The web servers in the DMZ. pf rules reference &amp;lt;dmz_web&amp;gt;; changing the&lt;/span&gt;
&lt;span class="c1"&gt;# entries never reloads a rule.&lt;/span&gt;
&lt;span class="n"&gt;resource&lt;/span&gt; &lt;span class="s2"&gt;"pf_table"&lt;/span&gt; &lt;span class="s2"&gt;"dmz_web"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;name&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"dmz_web"&lt;/span&gt;
  &lt;span class="n"&gt;entries&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"10.0.20.10/32"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"2001:db8:20::10/128"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="c1"&gt;# Sources we never want to hear from.&lt;/span&gt;
&lt;span class="n"&gt;resource&lt;/span&gt; &lt;span class="s2"&gt;"pf_table"&lt;/span&gt; &lt;span class="s2"&gt;"blocklist"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;name&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"blocklist"&lt;/span&gt;
  &lt;span class="n"&gt;entries&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"198.51.100.0/24"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"2001:db8:bad::/48"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Step 6: Filtering and outbound NAT
&lt;/h2&gt;

&lt;p&gt;Each &lt;code&gt;pf_anchor&lt;/code&gt; is one anchor, &lt;code&gt;api/&amp;lt;name&amp;gt;&lt;/code&gt;, and its &lt;code&gt;rules&lt;/code&gt; are loaded as a whole: pf is order-sensitive, so a ruleset is one atomic unit, never rule by rule. Split anchors along ownership: whoever owns the DMZ web server owns &lt;code&gt;dmz-web&lt;/code&gt;.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight hcl"&gt;&lt;code&gt;&lt;span class="c1"&gt;# Anchor api/egress: the inside networks out to the internet.&lt;/span&gt;
&lt;span class="n"&gt;locals&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;lan4&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"10.0.10.0/24"&lt;/span&gt;
  &lt;span class="n"&gt;lan6&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"2001:db8:10::/64"&lt;/span&gt;
  &lt;span class="n"&gt;dmz4&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"10.0.20.0/24"&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;resource&lt;/span&gt; &lt;span class="s2"&gt;"pf_anchor"&lt;/span&gt; &lt;span class="s2"&gt;"egress"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"egress"&lt;/span&gt;
  &lt;span class="n"&gt;rules&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="c1"&gt;# LAN clients may start anything; the out rule below decides where.&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pass"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"lan"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet"&lt;/span&gt;
      &lt;span class="n"&gt;from&lt;/span&gt;      &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;prefixes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;lan4&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"lan-in"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pass"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"lan"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet6"&lt;/span&gt;
      &lt;span class="n"&gt;from&lt;/span&gt;      &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;prefixes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;lan6&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"lan-in"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="c1"&gt;# DMZ servers only get DNS, NTP and HTTPS (updates) out.&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pass"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"dmz"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet"&lt;/span&gt;
      &lt;span class="n"&gt;protocol&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"udp"&lt;/span&gt;
      &lt;span class="n"&gt;from&lt;/span&gt;      &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;prefixes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;dmz4&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;to&lt;/span&gt;        &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;ports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;53&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;123&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"dmz-out"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pass"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"dmz"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet"&lt;/span&gt;
      &lt;span class="n"&gt;protocol&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"tcp"&lt;/span&gt;
      &lt;span class="n"&gt;from&lt;/span&gt;      &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;prefixes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;dmz4&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;to&lt;/span&gt;        &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;ports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;443&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"dmz-out"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="c1"&gt;# Out to the internet: IPv4 is translated to the wan address...&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pass"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"out"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"wan"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet"&lt;/span&gt;
      &lt;span class="n"&gt;from&lt;/span&gt;      &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;prefixes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;lan4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;dmz4&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;nat&lt;/span&gt;       &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;kind&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"nat-to"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"wan"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"nat-out"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="c1"&gt;# ...IPv6 is routed as is.&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pass"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"out"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"wan"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet6"&lt;/span&gt;
      &lt;span class="n"&gt;from&lt;/span&gt;      &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;prefixes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;lan6&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"v6-out"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Things worth knowing:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Every rule names one family.&lt;/strong&gt; pfapid refuses a rule that mixes IPv4 and IPv6: &lt;code&gt;pfctl&lt;/code&gt; would silently turn it into two rules, and what's loaded would no longer match what you wrote. Tables are the way to cover both.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Forwarded traffic is filtered twice.&lt;/strong&gt; A packet from the LAN to the internet goes &lt;em&gt;in&lt;/em&gt; on lan and &lt;em&gt;out&lt;/em&gt; on wan, and with &lt;code&gt;block all&lt;/code&gt; both directions need a &lt;code&gt;pass&lt;/code&gt;. The &lt;code&gt;lan-in&lt;/code&gt; rule allows everything in, but the out rules decide where it can go: only out on wan. A LAN client trying to reach the DMZ gets in on lan and is then dropped going out on dmz, unless a rule there allows it (the next anchor does, for the web ports).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;NAT sits on the out rule.&lt;/strong&gt; &lt;code&gt;nat = { kind = "nat-to", interface = "wan" }&lt;/code&gt; renders as &lt;code&gt;nat-to (wan:0)&lt;/code&gt;: the first address of wan, re-read when it changes, so this works with DHCP on the uplink too.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;IPv6 isn't translated.&lt;/strong&gt; The LAN has a routed prefix, so the IPv6 rule just passes it.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Step 7: Port forwarding to the DMZ
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight hcl"&gt;&lt;code&gt;&lt;span class="c1"&gt;# Anchor api/dmz-web: publish the web server.&lt;/span&gt;
&lt;span class="n"&gt;locals&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;web_ports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;80&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;443&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;resource&lt;/span&gt; &lt;span class="s2"&gt;"pf_anchor"&lt;/span&gt; &lt;span class="s2"&gt;"dmz_web"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"dmz-web"&lt;/span&gt;
  &lt;span class="n"&gt;rules&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="c1"&gt;# IPv4: redirect the wan address to the server (port forward).&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pass"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"wan"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet"&lt;/span&gt;
      &lt;span class="n"&gt;protocol&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"tcp"&lt;/span&gt;
      &lt;span class="n"&gt;to&lt;/span&gt;        &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"wan"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;ports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;web_ports&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;nat&lt;/span&gt;       &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;kind&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"rdr-to"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;address&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"10.0.20.10/32"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"web-rdr"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="c1"&gt;# IPv6: the server has a public address, so just let it through.&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pass"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"wan"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet6"&lt;/span&gt;
      &lt;span class="n"&gt;protocol&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"tcp"&lt;/span&gt;
      &lt;span class="n"&gt;to&lt;/span&gt;        &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;table&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;pf_table&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;dmz_web&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;ports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;web_ports&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"web-in"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="c1"&gt;# Forwarded traffic is filtered twice: in on wan (or lan), and out on&lt;/span&gt;
    &lt;span class="c1"&gt;# dmz. Without these the redirect above goes nowhere.&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pass"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"out"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"dmz"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet"&lt;/span&gt;
      &lt;span class="n"&gt;protocol&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"tcp"&lt;/span&gt;
      &lt;span class="n"&gt;to&lt;/span&gt;        &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;table&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;pf_table&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;dmz_web&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;ports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;web_ports&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"web-out"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"pass"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"out"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"dmz"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet6"&lt;/span&gt;
      &lt;span class="n"&gt;protocol&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"tcp"&lt;/span&gt;
      &lt;span class="n"&gt;to&lt;/span&gt;        &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;table&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;pf_table&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;dmz_web&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;ports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;local&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;web_ports&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"web-out"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;rdr-to&lt;/code&gt; rule changes the destination of connections to the wan address on port 80 or 443 to &lt;code&gt;10.0.20.10&lt;/code&gt;. The same &lt;code&gt;pass&lt;/code&gt; rule creates the state, so there is no separate redirect-then-filter step to keep in sync. The redirected packet then leaves on dmz, and the &lt;code&gt;web-out&lt;/code&gt; rules let it through: forget those and the port forward silently goes nowhere. Those same rules let LAN clients reach the web server directly.&lt;/p&gt;

&lt;p&gt;For IPv6 the server has its own address, so there is nothing to translate: pass it in on wan and out on dmz.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 8: The blocklist
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight hcl"&gt;&lt;code&gt;&lt;span class="c1"&gt;# Anchor api/blocklist. A quick block ends evaluation, so these win over&lt;/span&gt;
&lt;span class="c1"&gt;# any pass rule in another anchor.&lt;/span&gt;
&lt;span class="n"&gt;resource&lt;/span&gt; &lt;span class="s2"&gt;"pf_anchor"&lt;/span&gt; &lt;span class="s2"&gt;"blocklist"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"blocklist"&lt;/span&gt;
  &lt;span class="n"&gt;rules&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;family&lt;/span&gt; &lt;span class="n"&gt;in&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"inet"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"inet6"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;action&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"block"&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="n"&gt;quick&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;
      &lt;span class="n"&gt;log&lt;/span&gt;       &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"wan"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;family&lt;/span&gt;
      &lt;span class="n"&gt;from&lt;/span&gt;      &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;table&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;pf_table&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;blocklist&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"blocklist"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;
  &lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;quick&lt;/code&gt; ends evaluation on a match, so these blocks win over every pass rule in every anchor, whatever order pf evaluates the anchors in. &lt;code&gt;log&lt;/code&gt; sends the dropped packets to &lt;code&gt;pflog0&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Feed the table from wherever your threat data lives: a variable, a file, or a data source. Updating it is a table replace on the firewall, not a ruleset reload.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 9: QoS on the uplink
&lt;/h2&gt;

&lt;p&gt;An upload that fills the uplink makes everything else on the line feel slow: VoIP breaks up, SSH lags, and downloads crawl because their ACKs queue behind the upload. HFSC queues fix that by sharing the uplink by rule:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight hcl"&gt;&lt;code&gt;&lt;span class="c1"&gt;# QoS for a 100 Mbit/s uplink. Queues hang off a physical device (not a&lt;/span&gt;
&lt;span class="c1"&gt;# group), so the root names the device behind wan.&lt;/span&gt;
&lt;span class="n"&gt;variable&lt;/span&gt; &lt;span class="s2"&gt;"uplink"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;type&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;
  &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"vio0"&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;resource&lt;/span&gt; &lt;span class="s2"&gt;"pf_qos"&lt;/span&gt; &lt;span class="s2"&gt;"uplink"&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;queues&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"uplink"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kd"&gt;var&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;uplink&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;bandwidth&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"100M"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;max&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"100M"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"std"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;parent&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"uplink"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;bandwidth&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"60M"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="k"&gt;default&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;flows&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;1024&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"voip"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;parent&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"uplink"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;bandwidth&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"10M"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;min&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"10M"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"interactive"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;parent&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"uplink"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;bandwidth&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"10M"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;min&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"5M"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"bulk"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;parent&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"uplink"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;bandwidth&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"20M"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;max&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"40M"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;]&lt;/span&gt;

  &lt;span class="n"&gt;rules&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;
    &lt;span class="c1"&gt;# Classify where the state is created: in on lan or dmz. pf queues the&lt;/span&gt;
    &lt;span class="c1"&gt;# packets of that connection when they leave wan. Match rules run in&lt;/span&gt;
    &lt;span class="c1"&gt;# order and the last one that matches decides, so general rules first.&lt;/span&gt;
    &lt;span class="c1"&gt;#&lt;/span&gt;
    &lt;span class="c1"&gt;# All TCP from the LAN: data in std, bare ACKs in interactive. A full&lt;/span&gt;
    &lt;span class="c1"&gt;# uplink then can't hold back the ACKs that keep downloads going.&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"lan"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet"&lt;/span&gt;
      &lt;span class="n"&gt;protocol&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"tcp"&lt;/span&gt;
      &lt;span class="n"&gt;queue&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"std"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;priority&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"interactive"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"qos-acks"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"lan"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet"&lt;/span&gt;
      &lt;span class="n"&gt;protocol&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"tcp"&lt;/span&gt;
      &lt;span class="n"&gt;to&lt;/span&gt;        &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;ports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;22&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;queue&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"interactive"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"qos-ssh"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"lan"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet"&lt;/span&gt;
      &lt;span class="n"&gt;protocol&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"udp"&lt;/span&gt;
      &lt;span class="n"&gt;to&lt;/span&gt;        &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;ports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;5060&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;to&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;5061&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;10000&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;to&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;20000&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;queue&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"voip"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;prio&lt;/span&gt;      &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;normal&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;6&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"qos-voip"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="c1"&gt;# Offsite backups from the DMZ: capped, and last in line.&lt;/span&gt;
    &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="n"&gt;direction&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"in"&lt;/span&gt;
      &lt;span class="k"&gt;interface&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"dmz"&lt;/span&gt;
      &lt;span class="n"&gt;family&lt;/span&gt;    &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"inet"&lt;/span&gt;
      &lt;span class="n"&gt;protocol&lt;/span&gt;  &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"tcp"&lt;/span&gt;
      &lt;span class="n"&gt;to&lt;/span&gt;        &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;ports&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;from&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;873&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;queue&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"bulk"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;prio&lt;/span&gt;      &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;normal&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
      &lt;span class="n"&gt;label&lt;/span&gt;     &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;"qos-backup"&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;How it fits together:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Queues shape what &lt;em&gt;leaves&lt;/em&gt; an interface.&lt;/strong&gt; These queues sit on the wan device, so they shape uploads. To shape downloads, put a second tree on the LAN device.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The parent caps the total&lt;/strong&gt; at 100M with &lt;code&gt;max&lt;/code&gt;; set it slightly below your real upload speed so the queue builds here, where pf controls it, not in the modem. Children share it by &lt;code&gt;bandwidth&lt;/code&gt;, &lt;code&gt;min&lt;/code&gt; is a guarantee, &lt;code&gt;max&lt;/code&gt; a hard cap. pfapid refuses children that add up to more than their parent; &lt;code&gt;pfctl&lt;/code&gt; would accept that.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;std&lt;/code&gt; is the default&lt;/strong&gt; and an FQ-CoDel queue (&lt;code&gt;flows = 1024&lt;/code&gt;): it keeps one heavy flow from adding latency to all the others.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Classify where the connection starts.&lt;/strong&gt; The rules match &lt;code&gt;in on lan&lt;/code&gt; (or dmz); pf stores the queue in the connection's state and uses it when its packets leave wan. Keep that habit: a &lt;code&gt;match out on wan&lt;/code&gt; rule never sees the replies to connections opened from the internet, such as the web server's responses.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Two queues in one rule&lt;/strong&gt;: &lt;code&gt;queue = { name = "std", priority = "interactive" }&lt;/code&gt; puts data in &lt;code&gt;std&lt;/code&gt; and bare TCP ACKs in &lt;code&gt;interactive&lt;/code&gt;. That one line is what keeps downloads fast during a big upload.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;prio&lt;/code&gt;&lt;/strong&gt; is pf's simple 0–7 priority on interfaces without HFSC queues, such as lan here: VoIP towards the phones goes first too.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;QoS rules can only classify.&lt;/strong&gt; They're &lt;code&gt;match&lt;/code&gt; rules with no &lt;code&gt;pass&lt;/code&gt;, &lt;code&gt;block&lt;/code&gt; or NAT, so QoS can never change what the firewall lets through. That's also why it's a separate permission (&lt;code&gt;"qos": true&lt;/code&gt;).&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Step 10: Plan and apply
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;terraform plan
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Each anchor's plan includes &lt;code&gt;pf_rules&lt;/code&gt;: the rules exactly as pf will load them, as &lt;code&gt;pfctl -nv&lt;/code&gt; on the firewall printed them. This is what the plan showed in my lab (the QoS root was on &lt;code&gt;vio1&lt;/code&gt; there):&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;pf_anchor.dmz_web:
  "pass in on wan inet proto tcp from any to (wan) port = 80 flags S/SA label \"web-rdr\" rdr-to 10.0.20.10",
  "pass in on wan inet proto tcp from any to (wan) port = 443 flags S/SA label \"web-rdr\" rdr-to 10.0.20.10",
  "pass in on wan inet6 proto tcp from any to &amp;lt;dmz_web&amp;gt; port = 80 flags S/SA label \"web-in\"",
  ...
pf_anchor.egress:
  "pass out on wan inet from 10.0.10.0/24 to any flags S/SA label \"nat-out\" nat-to (wan:0) round-robin",
  "pass out on wan inet from 10.0.20.0/24 to any flags S/SA label \"nat-out\" nat-to (wan:0) round-robin",
  ...
pf_qos.uplink:
  "queue uplink on vio1 bandwidth 100M, max 100M",
  "queue std parent uplink flows 1024 bandwidth 60M default",
  ...
  "match in on lan inet proto tcp all set (queue(std, interactive)) label \"qos-acks\"",
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Lists become one line per port and per prefix, and pf adds its defaults (&lt;code&gt;flags S/SA&lt;/code&gt;, &lt;code&gt;round-robin&lt;/code&gt;). You see that before anything changes, not after.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;terraform apply
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;





&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;pf_table.dmz_web: Creation complete after 0s [id=dmz_web]
pf_table.blocklist: Creation complete after 0s [id=blocklist]
pf_anchor.egress: Creation complete after 0s [id=egress]
pf_qos.uplink: Creation complete after 0s [id=qos]
pf_anchor.dmz_web: Creation complete after 0s [id=dmz-web]
pf_anchor.blocklist: Creation complete after 0s [id=blocklist]

Apply complete! Resources: 6 added, 0 changed, 0 destroyed.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Each change was loaded, confirmed by the provider over the same connection, and only then written to pfapid's state. A second &lt;code&gt;terraform plan&lt;/code&gt; reports no changes.&lt;/p&gt;

&lt;h2&gt;
  
  
  Step 11: Check it on the firewall
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pfctl -sA                    &lt;span class="c"&gt;# anchors: api, api/blocklist, api/dmz-web, api/egress, api-qos&lt;/span&gt;
pfctl -a api/egress -vsr     &lt;span class="c"&gt;# an anchor's rules, with counters&lt;/span&gt;
pfctl -t blocklist -T show   &lt;span class="c"&gt;# table contents&lt;/span&gt;
pfctl -vsq                   &lt;span class="c"&gt;# queues, with packets and drops&lt;/span&gt;
tcpdump -n -e -ttt -i pflog0 &lt;span class="c"&gt;# what the default-deny and the blocklist drop, live&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  The guardrails in action
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Drift.&lt;/strong&gt; I flushed an anchor by hand with &lt;code&gt;pfctl -a api/dmz-web -F rules&lt;/code&gt;. The next plan:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Warning: pf anchor api/dmz-web differs from its committed rules

The rules loaded in pf were changed outside pfapid. The next apply loads the
configured rules again.
Expected:
  pass in on wan inet proto tcp from any to (wan) port = 80 flags S/SA label "web-rdr" rdr-to 10.0.20.10
  ...
Plan: 0 to add, 1 to change, 0 to destroy.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;code&gt;terraform apply&lt;/code&gt; loaded the rules again.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The management interface.&lt;/strong&gt; A rule that opens RDP on &lt;code&gt;mgmt&lt;/code&gt; fails at plan time:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Error: Rules rejected by the firewall

pfapid: 400 invalid: rule 0: invalid: interface "mgmt" is not allowed
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;A rule pf won't take.&lt;/strong&gt; pfapid runs &lt;code&gt;pfctl -n&lt;/code&gt; during the plan, so a rule pf would refuse fails &lt;code&gt;terraform plan&lt;/code&gt;, with pf's own error message, before anything is loaded.&lt;/p&gt;

&lt;h2&gt;
  
  
  Limits worth knowing
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;One firewall, one provider block.&lt;/strong&gt; For an HA pair, configure two providers (with &lt;code&gt;alias&lt;/code&gt;) and apply the same modules to both; pfsync keeps the states in sync, not the rules.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;self&lt;/code&gt; is expanded when &lt;code&gt;pf.conf&lt;/code&gt; loads.&lt;/strong&gt; If the firewall's addresses change, reload the base ruleset.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;No hairpin NAT.&lt;/strong&gt; LAN clients reach the web server on its DMZ address, not on the public one. Use split DNS.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Queues are bit rates, not percentages&lt;/strong&gt;: pf doesn't support percentages in HFSC yet.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Everything in this post was planned and applied with provider v0.1.0 and pfapid v0.1.2 on an OpenBSD 7.9 lab VM, and the pf output shown is what pf loaded there. The code, the design notes and the pf behaviour pfapid relies on are on GitHub: &lt;a href="https://github.com/pderuiter/pfapid" rel="noopener noreferrer"&gt;pfapid&lt;/a&gt; and &lt;a href="https://github.com/pderuiter/terraform-provider-pf" rel="noopener noreferrer"&gt;terraform-provider-pf&lt;/a&gt;. Issues and pull requests are welcome.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published on &lt;a href="https://blog.bsdserver.nl/default-deny-nat-firewall-openbsd-pf-terraform/?utm_source=devto&amp;amp;utm_medium=referral&amp;amp;utm_campaign=default-deny-nat-firewall-openbsd-pf-terraform" rel="noopener noreferrer"&gt;A DevOps Blog&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>openbsd</category>
      <category>security</category>
      <category>networking</category>
      <category>terraform</category>
    </item>
  </channel>
</rss>
