Egress Control Filter

Why is egress control filter needed?


For Internet bound egress traffic, specifying outbound policy at IP address level is not sufficient as the domain names of a site can be translated to many different IP addresses.

AWS NAT gateway does not offer security group function, it relies on security groups by each instance. AWS NAT instance’s security group does not have enough entries to support the large set of IP address list. The egress filtering needs to happen at Layer 7.

On the other hand, workloads in AWS are mostly applications where it is deterministic which outbound APIs the application program calls. For example, the application runs API queries to for data retrieving; the application also runs API queries to for app authentication. In these cases, making sure only these sites are allowed for egress traffic is sufficient from security point of view. Note this is very different from on-prem situation where end user traffic and application traffic are mingled together, you may need a full fledged firewall for Internet bound traffic.

What does Aviatrix FQDN feature do?

Aviatrix Fully Qualified Domain Name (FQDN) Whitelisting is a security feature specially designed for workloads in public cloud. It filters Internet bound egress traffic initiated from workloads in a VPC.

Starting from release 3.4, Aviatrix FQDN Whitelisting filters on any TCP and UDP traffic including HTTP, HTTPS and SFTP traffic and allows only the destination host names (whitelist) specified in the list to pass and drop all other destinations. Each host name is specified as fully qualified domain name. For example, if you only allow Internet bound traffic to, you can list the domain name in the whitelist.

For HTTP/HTTPS (TCP port 80/443), FQDN feature also supports wild card, such as *. In this example, you can specify * to allow traffic to any domain names that ends

Note the gateway must have NAT enabled if you want to turn on FQDN whitelists.

How does it work?

This features works for HTTP and HTTPS traffic to public Internet. The function is carried out inline without requiring any certificate or keys to decrypt the traffic.

Starting from release 3.4, non HTTP/HTTPS traffic can also be filtered based on domain names. Use cases are secure file transfer (SFTP) to external sites, secure login in (SSH) to external sites.

A tag is defined as a list of FQDNs and it is created and managed on the Controller console. One or more gateways is attached to a tag. Each gateway can be attached to one tag. Any updates to a tag on the Controller automatically triggers updates to all gateways attached to the tag.

Multiple tags can be defined for the controller. The domains in the tag are the destinations that are allowed for traffic to pass.

Configuration Workflow


The VPC you want to apply FQDN filter must have an Aviatrix gateway launched with NAT enabled before starting the following steps.

Step 1. Add a new tag

Go Security -> FQDN, click New Tag, as shown below:


Click “+New Tag”, and enter a name for the tag, for example, prod-whitelist, as shown below:


Step 2. Add URL list to the new tag

Enable the new tag and click Edit, as shown below:


Click “+Add New” to add each URL, wild card is allowed for HTTP/HTTPS (TCP 443), as shown below. (Action “Update” means to save the rules in the tag and if gateways are attached to the tag, “Update” applies the rules to the gateways.)


Step 3. Attach to gateways

Click “Attach Gateway” to attach a gateway to the tag.

When a gateway is attached to a tag, in the tag will be pushed for enforcement (whitelist or blacklist), as shown below.


Repeat Step 3 if you have more gateways that should be attached to this tag.


Add more tags

Repeat from Step 1 to create more tags and attach different gateways. Note each gateway can only be attached to one tag.

Exception Rule

Exception rule is a system wide mode.

When Exception Rule is enabled, packets passing through the gateway without SNI field are allowed to pass. This usually happens when an application uses hard coded destination IP address for HTTPS connection instead of domain names. This could be a security loop hole.

When Exception Rule is disabled, packets passing through the gateway without SNI field are dropped unless the specific destination IP address of the packet is listed in the Whitelist. The use case could be certain old application uses hard coded destination IP address to access outside services.


This feature is available in Release 3.4 and later.

Export allows you to download the configured FQDN rules on a per tag bases, in a human readable text file format, as shown in the example below:



This feature is available in Release 3.4 and later.

Import allows you to upload a text file that contains FQDN rules to a specific tag. The text file can be:

  1. The downloaded file from FQDN Discovery
  2. The download file from Export from a different tag.
  3. A text file in the format compatible to Export.

How to Troubleshoot FQDN Problems

If you have problems with FQDN on a specific gateway, follow the instructions below to troubleshoot:

  1. Make sure the gateway has NAT function enabled.
  2. Make sure the corresponding AWS or Azure route table has the route entry points to the gateway instance.
  3. To verify the above two steps are setup properly, disable FQDN function of the problem gateway by detaching it from the associated tag, and run a ping test to, to make sure Internet egress works.
  4. Attach the problem gateway to the tag. Make sure the tag has Enabled button on. Make sure the Whitelist or Blacklist is selected as intended.
  5. Check the tag to make sure it has the intended URL configured.
  6. Run a “wget” test from a private instance in the VPC to an URL configured in the tag.
  7. Use “Step 4” at Egress FQDN View Log, select the problem gateway and download the log. Review the log file and analyze if the intended URL is in the log entry, why it is being accepted or denied.
  8. Note if a tag has “White list” option selected, all URL in the tag will be accepted. On the other hand, if a tag has a “Black list” option selected, all URL in the tag will be dropped.
  9. If none of the above works, try Disable and Enable the tag again. This will restart the FQDN function on all attached gateways.
  10. If all above steps failed, get help from aviatrix support team and upload tracelog.

For support, send email to