From ee209ead6d23aa3ca0eeafb1d439fd1060a67431 Mon Sep 17 00:00:00 2001
From: Nicolas Fort <nicolasfort1988@gmail.com>
Date: Tue, 12 Sep 2023 14:34:27 -0300
Subject: [PATCH] Config blueprints: Add new example for policy-based ipsec
 site to site tunnel, plus firewall, using new firewall sintax

---
 .../policy-based-ipsec-and-firewall.png       | Bin 0 -> 42987 bytes
 docs/configexamples/index.rst                 |   1 +
 .../policy-based-ipsec-and-firewall.rst       | 281 ++++++++++++++++++
 3 files changed, 282 insertions(+)
 create mode 100644 docs/_static/images/policy-based-ipsec-and-firewall.png
 create mode 100644 docs/configexamples/policy-based-ipsec-and-firewall.rst

diff --git a/docs/_static/images/policy-based-ipsec-and-firewall.png b/docs/_static/images/policy-based-ipsec-and-firewall.png
new file mode 100644
index 0000000000000000000000000000000000000000..6e9d43ac9274f66cebd8bbc34a727b965d61d794
GIT binary patch
literal 42987
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

literal 0
HcmV?d00001

diff --git a/docs/configexamples/index.rst b/docs/configexamples/index.rst
index 80083fe1..a0413bfd 100644
--- a/docs/configexamples/index.rst
+++ b/docs/configexamples/index.rst
@@ -21,6 +21,7 @@ This chapter contains various configuration examples:
    qos
    segment-routing-isis
    nmp
+   policy-based-ipsec-and-firewall
 
 
 Configuration Blueprints (autotest)
diff --git a/docs/configexamples/policy-based-ipsec-and-firewall.rst b/docs/configexamples/policy-based-ipsec-and-firewall.rst
new file mode 100644
index 00000000..1f969453
--- /dev/null
+++ b/docs/configexamples/policy-based-ipsec-and-firewall.rst
@@ -0,0 +1,281 @@
+.. _examples-policy-based-ipsec-and-firewall:
+
+
+Policy-Based Site-to-Site VPN and Firewall Configuration
+--------------------------------------------------------
+
+This guide shows an example policy-based IKEv2 site-to-site VPN between two
+VyOS routers, and firewall configiuration.
+
+For simplicity, configuration and tests are done only using ipv4, and firewall
+configuration in done only on one router.
+
+Network Topology and requirements
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This configuration example and the requirments consists on:
+
+- Two VyOS routers with public IP address.
+
+- 2 private subnets on each site.
+
+- Local subnets should be able to reach internet using source nat.
+
+- Communication between private subnets should be done through ipsec tunnel
+  without nat.
+
+- Configuration of basic firewall in one site, in order to:
+
+    - Protect the router on 'WAN' interface, allowing only ipsec connections
+      and ssh access from trusted ips.
+
+    - Allow access to the router only from trusted networks.
+    
+    - Allow dns requests only only for local networks.
+
+    - Allow icmp on all interfaces.
+
+    - Allow all new connections from local subnets.
+
+    - Allow connections from LANs to LANs throught the tunnel.
+
+
+.. image:: /_static/images/policy-based-ipsec-and-firewall.png
+
+
+Configuration
+^^^^^^^^^^^^^
+
+Interface and routing configuration:
+
+.. code-block:: none
+
+    # LEFT router:
+    set interfaces ethernet eth0 address '198.51.100.14/30'
+    set interfaces ethernet eth1 vif 111 address '10.1.11.1/24'
+    set interfaces ethernet eth2 vif 112 address '10.1.12.1/24'
+    set protocols static route 0.0.0.0/0 next-hop 198.51.100.13
+
+    # RIGHT router:
+    set interfaces ethernet eth0 address '192.0.2.130/30'
+    set interfaces ethernet eth1 vif 221 address '10.2.21.1/24'
+    set interfaces ethernet eth2 vif 222 address '10.2.22.1/24'
+
+
+IPSec configuration:
+
+.. code-block:: none
+
+    # LEFT router:
+    set vpn ipsec authentication psk RIGHT id '198.51.100.14'
+    set vpn ipsec authentication psk RIGHT id '192.0.2.130'
+    set vpn ipsec authentication psk RIGHT secret 'p4ssw0rd'
+    set vpn ipsec esp-group ESP-GROUP mode 'tunnel'
+    set vpn ipsec esp-group ESP-GROUP proposal 1 encryption 'aes256'
+    set vpn ipsec esp-group ESP-GROUP proposal 1 hash 'sha256'
+    set vpn ipsec ike-group IKE-GROUP key-exchange 'ikev2'
+    set vpn ipsec ike-group IKE-GROUP proposal 1 dh-group '14'
+    set vpn ipsec ike-group IKE-GROUP proposal 1 encryption 'aes256'
+    set vpn ipsec ike-group IKE-GROUP proposal 1 hash 'sha256'
+    set vpn ipsec interface 'eth0'
+    set vpn ipsec site-to-site peer RIGHT authentication mode 'pre-shared-secret'
+    set vpn ipsec site-to-site peer RIGHT connection-type 'initiate'
+    set vpn ipsec site-to-site peer RIGHT default-esp-group 'ESP-GROUP'
+    set vpn ipsec site-to-site peer RIGHT ike-group 'IKE-GROUP'
+    set vpn ipsec site-to-site peer RIGHT local-address '198.51.100.14'
+    set vpn ipsec site-to-site peer RIGHT remote-address '192.0.2.130'
+    set vpn ipsec site-to-site peer RIGHT tunnel 0 local prefix '10.1.11.0/24'
+    set vpn ipsec site-to-site peer RIGHT tunnel 0 remote prefix '10.2.21.0/24'
+    set vpn ipsec site-to-site peer RIGHT tunnel 1 local prefix '10.1.11.0/24'
+    set vpn ipsec site-to-site peer RIGHT tunnel 1 remote prefix '10.2.22.0/24'
+    set vpn ipsec site-to-site peer RIGHT tunnel 2 local prefix '10.1.12.0/24'
+    set vpn ipsec site-to-site peer RIGHT tunnel 2 remote prefix '10.2.21.0/24'
+    set vpn ipsec site-to-site peer RIGHT tunnel 3 local prefix '10.1.12.0/24'
+    set vpn ipsec site-to-site peer RIGHT tunnel 3 remote prefix '10.2.22.0/24'
+
+    # RIGHT router:
+    set vpn ipsec authentication psk LEFT id '192.0.2.130'
+    set vpn ipsec authentication psk LEFT id '198.51.100.14'
+    set vpn ipsec authentication psk LEFT secret 'p4ssw0rd'
+    set vpn ipsec esp-group ESP-GROUP mode 'tunnel'
+    set vpn ipsec esp-group ESP-GROUP proposal 1 encryption 'aes256'
+    set vpn ipsec esp-group ESP-GROUP proposal 1 hash 'sha256'
+    set vpn ipsec ike-group IKE-GROUP key-exchange 'ikev2'
+    set vpn ipsec ike-group IKE-GROUP proposal 1 dh-group '14'
+    set vpn ipsec ike-group IKE-GROUP proposal 1 encryption 'aes256'
+    set vpn ipsec ike-group IKE-GROUP proposal 1 hash 'sha256'
+    set vpn ipsec interface 'eth0'
+    set vpn ipsec site-to-site peer LEFT authentication mode 'pre-shared-secret'
+    set vpn ipsec site-to-site peer LEFT connection-type 'respond'
+    set vpn ipsec site-to-site peer LEFT default-esp-group 'ESP-GROUP'
+    set vpn ipsec site-to-site peer LEFT ike-group 'IKE-GROUP'
+    set vpn ipsec site-to-site peer LEFT local-address '192.0.2.130'
+    set vpn ipsec site-to-site peer LEFT remote-address '198.51.100.14'
+    set vpn ipsec site-to-site peer LEFT tunnel 0 local prefix '10.2.21.0/24'
+    set vpn ipsec site-to-site peer LEFT tunnel 0 remote prefix '10.1.11.0/24'
+    set vpn ipsec site-to-site peer LEFT tunnel 1 local prefix '10.2.22.0/24'
+    set vpn ipsec site-to-site peer LEFT tunnel 1 remote prefix '10.1.11.0/24'
+    set vpn ipsec site-to-site peer LEFT tunnel 2 local prefix '10.2.21.0/24'
+    set vpn ipsec site-to-site peer LEFT tunnel 2 remote prefix '10.1.12.0/24'
+    set vpn ipsec site-to-site peer LEFT tunnel 3 local prefix '10.2.22.0/24'
+    set vpn ipsec site-to-site peer LEFT tunnel 3 remote prefix '10.1.12.0/24'
+
+Firewall Configuration:
+
+.. code-block:: none
+
+    # Firewall Groups:
+    set firewall group network-group LOCAL-NETS network '10.1.11.0/24'
+    set firewall group network-group LOCAL-NETS network '10.1.12.0/24'
+    set firewall group network-group REMOTE-NETS network '10.2.21.0/24'
+    set firewall group network-group REMOTE-NETS network '10.2.22.0/24'
+    set firewall group network-group TRUSTED network '198.51.100.125/32'
+    set firewall group network-group TRUSTED network '203.0.113.0/24'
+    set firewall group network-group TRUSTED network '10.1.11.0/24'
+    set firewall group network-group TRUSTED network '192.168.70.0/24'
+
+    # Forward traffic: default drop and only allow what is needed
+    set firewall ipv4 forward filter default-action 'drop'
+    
+    # Forward traffic: global state policies
+    set firewall ipv4 forward filter rule 1 action 'accept'
+    set firewall ipv4 forward filter rule 1 state established 'enable'
+    set firewall ipv4 forward filter rule 1 state related 'enable'
+    set firewall ipv4 forward filter rule 2 action 'drop'
+    set firewall ipv4 forward filter rule 2 state invalid 'enable'
+    
+    # Forward traffic: Accept all connections from local networks
+    set firewall ipv4 forward filter rule 10 action 'accept'
+    set firewall ipv4 forward filter rule 10 source group network-group 'LOCAL-NETS'
+    
+    # Forward traffic: accept connections from remote LANs to local LANs
+    set firewall ipv4 forward filter rule 20 action 'accept'
+    set firewall ipv4 forward filter rule 20 destination group network-group 'LOCAL-NETS'
+    set firewall ipv4 forward filter rule 20 source group network-group 'REMOTE-NETS'
+
+    # Input traffic: default drop and only allow what is needed
+    set firewall ipv4 input filter default-action 'drop'
+
+    # Input traffic: global state policies
+    set firewall ipv4 input filter rule 1 action 'accept'
+    set firewall ipv4 input filter rule 1 state established 'enable'
+    set firewall ipv4 input filter rule 1 state related 'enable'
+    set firewall ipv4 input filter rule 2 action 'drop'
+    set firewall ipv4 input filter rule 2 state invalid 'enable'
+
+    # Input traffic: add rules needed for ipsec connection
+    set firewall ipv4 input filter rule 10 action 'accept'
+    set firewall ipv4 input filter rule 10 destination port '500,4500'
+    set firewall ipv4 input filter rule 10 inbound-interface interface-name 'eth0'
+    set firewall ipv4 input filter rule 10 protocol 'udp'
+    set firewall ipv4 input filter rule 15 action 'accept'
+    set firewall ipv4 input filter rule 15 inbound-interface interface-name 'eth0'
+    set firewall ipv4 input filter rule 15 protocol 'esp'
+
+    # Input traffic: accept ssh connection from trusted ips
+    set firewall ipv4 input filter rule 20 action 'accept'
+    set firewall ipv4 input filter rule 20 destination port '22'
+    set firewall ipv4 input filter rule 20 protocol 'tcp'
+    set firewall ipv4 input filter rule 20 source group network-group 'TRUSTED'
+
+    # Input traffic: accepd dns requests only from local networks.
+    set firewall ipv4 input filter rule 25 action 'accept'
+    set firewall ipv4 input filter rule 25 destination port '53'
+    set firewall ipv4 input filter rule 25 protocol 'udp'
+    set firewall ipv4 input filter rule 25 source group network-group 'LOCAL-NETS'
+
+    # Input traffic: allow icmp
+    set firewall ipv4 input filter rule 30 action 'accept'
+    set firewall ipv4 input filter rule 30 protocol 'icmp'
+
+And NAT Configuration:
+
+.. code-block:: none
+
+    set nat source rule 10 destination group network-group 'REMOTE-NETS'
+    set nat source rule 10 exclude
+    set nat source rule 10 outbound-interface 'eth0'
+    set nat source rule 10 source group network-group 'LOCAL-NETS'
+    set nat source rule 20 outbound-interface 'eth0'
+    set nat source rule 20 source group network-group 'LOCAL-NETS'
+    set nat source rule 20 translation address 'masquerade'
+
+Checking through op-mode commands
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+After some testing, we can check ipsec status, and counter on every tunnel:
+
+.. code-block:: none
+
+    vyos@LEFT:~$ show vpn ipsec sa
+    Connection      State    Uptime    Bytes In/Out    Packets In/Out    Remote address    Remote ID    Proposal
+    --------------  -------  --------  --------------  ----------------  ----------------  -----------  ---------------------------------------
+    RIGHT-tunnel-0  up       36m24s    840B/840B       10/10             192.0.2.130       192.0.2.130  AES_CBC_256/HMAC_SHA2_256_128/MODP_2048
+    RIGHT-tunnel-1  up       36m33s    588B/588B       7/7               192.0.2.130       192.0.2.130  AES_CBC_256/HMAC_SHA2_256_128/MODP_2048
+    RIGHT-tunnel-2  up       35m50s    1K/1K           15/15             192.0.2.130       192.0.2.130  AES_CBC_256/HMAC_SHA2_256_128/MODP_2048
+    RIGHT-tunnel-3  up       36m54s    2K/2K           32/32             192.0.2.130       192.0.2.130  AES_CBC_256/HMAC_SHA2_256_128/MODP_2048
+    vyos@LEFT:~$ 
+
+
+Also, we can check firewall counters:
+
+.. code-block:: none
+
+    vyos@LEFT:~$ show firewall
+    Rulesets Information
+
+    ---------------------------------
+    IPv4 Firewall "forward filter"
+
+    Rule     Action    Protocol      Packets    Bytes  Conditions
+    -------  --------  ----------  ---------  -------  ------------------------------------------------------
+    1        accept    all               681    96545  ct state { established, related }  accept
+    2        drop      all                 0        0  ct state invalid
+    10       accept    all               360    27205  ip saddr @N_LOCAL-NETS  accept
+    20       accept    all                 8      648  ip daddr @N_LOCAL-NETS ip saddr @N_REMOTE-NETS  accept
+    default  drop      all
+
+    ---------------------------------
+    IPv4 Firewall "input filter"
+
+    Rule     Action    Protocol      Packets    Bytes  Conditions
+    -------  --------  ----------  ---------  -------  ----------------------------------------------
+    1        accept    all               901   123709  ct state { established, related }  accept
+    2        drop      all                 0        0  ct state invalid
+    10       accept    udp                 0        0  udp dport { 500, 4500 } iifname "eth0"  accept
+    15       accept    esp                 0        0  meta l4proto esp iifname "eth0"  accept
+    20       accept    tcp                 1       60  tcp dport 22 ip saddr @N_TRUSTED  accept
+    25       accept    udp                 0        0  udp dport 53 ip saddr @N_LOCAL-NETS  accept
+    30       accept    icmp                0        0  meta l4proto icmp  accept
+    default  drop      all
+
+    vyos@LEFT:~$ 
+    vyos@LEFT:~$ show firewall statistics 
+    Rulesets Statistics
+
+    ---------------------------------
+    IPv4 Firewall "forward filter"
+
+    Rule     Packets    Bytes    Action    Source       Destination    Inbound-Interface    Outbound-interface
+    -------  ---------  -------  --------  -----------  -------------  -------------------  --------------------
+    1        681        96545    accept    any          any            any                  any
+    2        0          0        drop      any          any            any                  any
+    10       360        27205    accept    LOCAL-NETS   any            any                  any
+    20       8          648      accept    REMOTE-NETS  LOCAL-NETS     any                  any
+    default  N/A        N/A      drop      any          any            any                  any
+
+    ---------------------------------
+    IPv4 Firewall "input filter"
+
+    Rule     Packets    Bytes    Action    Source      Destination    Inbound-Interface    Outbound-interface
+    -------  ---------  -------  --------  ----------  -------------  -------------------  --------------------
+    1        905        124213   accept    any         any            any                  any
+    2        0          0        drop      any         any            any                  any
+    10       0          0        accept    any         any            eth0                 any
+    15       0          0        accept    any         any            eth0                 any
+    20       1          60       accept    TRUSTED     any            any                  any
+    25       0          0        accept    LOCAL-NETS  any            any                  any
+    30       0          0        accept    any         any            any                  any
+    default  N/A        N/A      drop      any         any            any                  any
+
+    vyos@LEFT:~$