UniFi USG

Introduction

This guide will lead you through the procedure to establish a Site-to-Site VPN tunnel between your Perimeter 81 network and the UniFi USG environment.

Breakdown of topics

1. Pre-requisites
2. Configuration Steps
3. Verifying the Setup
4. Troubleshooting
5. Support Contacts

Pre-requisites

To successfully follow this guide, ensure that:

1. Have an active Perimeter 81 account with an existing network.
2. Have the Perimeter 81 application installed on your devices.
3. Maintain an operational UniFi USG setup with the necessary administrative privileges.

Configuration Steps

Configuring an IPSec tunnel in the Management Platform

1. Under Network in the Management Platform on the left side, select the network name in which you'd like to set the tunnel.
2. Locate the desired gateway, and select the three-dotted menu (...).
   
3. Select Add Tunnel and then IPSec Site-2-Site Tunnel.

The following window displays:

4. In the General Settings section, fill in the following information:

• Name: Choose whatever name you find suitable for the tunnel.
• Shared Secret: Enter a string of your own or use Generate.
• Public IP: Enter the public IP of the UniFi USG device.
• Remote IP: Enter the public IP of the UniFi USG device.
• Perimeter 81 Gateway Proposal Subnets: By default, this should be set to 10.255.0.0/16.
• Remote Gateway Proposal Subnets: Click Specified Subnets and specify according to your local LAN Subnets.

5. In the Advanced Settings section, complete the following information:

• IKE Version:IKEv2 if the Firewall version supports it, IKEv1 otherwise. 
• IKE Lifetime: 8h
• Tunnel Lifetime: 8h
• Dead Peer Detection Delay: 10s
• Dead Peer Detection Timeout: 30s
• Encryption (Phase 1): aes256
• Encryption (Phase 2): aes256
• Integrity (Phase 1): sha1
• Integrity (Phase 2): sha1
• Diffie-Hellman Groups (Phase 1): 21
• Diffie-Hellman Groups (Phase 1): 21

Leave the rest of the fields with the default values (as shown in the image below).

Configuring the tunnel in the UniFi - USG Management Interface

1. Open the UniFi - USG management interface.
2. In the left panel, select Networks, then select Create New Network:
   
3. Select Site to Site VPN > Manual IPsec and fill in the following information:

• Enable this Site-to-Site VPN
• Remote Subnets: Enter the Perimeter 81 subnet (by default, it's 10.255.0.0/16).
• Peer IP: Enter the public IP of the location server.
• Local WAN IP: Enter the public IP of the UniFi SCG.
• Pre-shared key: Enter the Shared Key you chose on the Management Portal.

4. In the Advanced Options, fill in the following information:

• Key Exchange Version: IKEv2 if the Firewall version supports it, IKEv1 otherwise.
• Encryption: AES-256
• Hash: SHA1
• DH Group: 21
• PFS: Enable
• Dynamic Routing: Disable

Configuring firewall and static routing

Next, let's add static routes from the Perimeter 81 subnet (10.255.0.0/16) to the local network and from the local network to the Perimeter 81 subnet (10.255.0.0/16) to the local network through the VPN tunnel gateway. Also, it's necessary to create firewall rules to allow this traffic.

1. Go to Routing & Firewall > Static Routes > Create New Route.

• Choose a name.
• Enable the route.
• Enter the Perimeter 81 subnet (by default it's 10.255.0.0/16) in Destination Network.
  
• Make sure to choose the interface you created in the previous section.

2. Create a firewall rule that allows traffic from the Perimeter 81 subnet to the LAN Network.
   

In case IPS/IDS is enabled on the UniFi:

To establish a tunnel with the Perimeter 81 network in version 7 and above of the UniFi firewall, you must create an exception within your Threat detection system.
To add a "Threat Management Allow List" entry:

1. Click on the Firewall & Security tab.
2. Click Create New Allow List
3. Select the Site-2-Site network you created earlier (In the step titled "Configuring the tunnel in the UniFi - USG Management Interface")
4. Save your changes.

Verifying the Setup

After following the above steps, your tunnel should be active.
To verify, go to your Perimeter 81 dashboard, locate the tunnel you just created, and check the tunnel status.
It should indicate that the tunnel is "Up", signifying a successful connection.
Next, connect to your network using the Perimeter 81 agent and attempt to access one of the resources in your environment.

Troubleshooting

If you encounter issues during or after the setup, try reviewing your settings to ensure everything matches the instructions. In particular, check the IP addresses and other details you entered during setup. If issues persist, please consult our dedicated support.

Support Contacts

If you have any difficulties or questions, don't hesitate to contact Perimeter 81's support team. We offer 24/7 chat support on our website at Perimeter81.com, or you can email us at support@perimeter81.com. We're here to assist you and ensure your VPN tunnel setup is a success.