Frequently Asked Questions

Aviatrix product consists of a controller and gateways. When the product is deployed in the public cloud marketplace, what you launch is the controller instance and from controller console you launch gateways.

When the product is deployed as a virtual appliance in a virtualized datacenter environment, the controller and gateway is bundled into one virtual image, such as OVF and VHD.

The following FAQ discusses only the cloud deployment scenario.

Aviatrix Cloud Gateway

Q1: What can it do for me?

Aviatrix Cloud Gateway provides an end to end secure network solution for AWS, Azure and Google GCloud. The solution includes an enterprise OpenVPN access to VPC/VNet, encrypted routing among VPC/VNets and monitoring and logging of link status and latency. The solution enables you to build a secure private network spanning one or more public clouds where a user access any instance/VM with a private IP address directly. No more bastion stations and jump hosts, the solution gives user the seamless experience that they enjoy when using the on-prem network.

Aviatrix Cloud Gateway supports encryption over AWS Direct Connect and Azure Express Route.

In additioin, the product interoperates with any third party IPSEC capable devices, including AWS VGW and Aviatrix’s own on-prem virtual appliance CloudN.

Architecturally, Aviatrix solution is a centrally managed, loosely coupled and globally deployed platform built for the cloud from the ground up.

Q2: What are the key features?

  • Manage all your cloud networking requirements from a central controller.

  • Peering Features

    • point and click encrypted peering applied to multi VPCs, multi regions and multi clouds (AWS, Azure and GCloud) enables you to build a partial or full mesh network.
    • Transitive peering enables you to build a hub and spoke network with ease.
    • Cluster peering enables you to build encrypted tunnel with a performance that scales to 10Gbps.
  • Site2Cloud Features

    • Secure connection to remote branch sites and interoperability with legacy router/firewall device.
    • Encryption over AWS Direct Connect and Azure Express Route.
  • OpenVPN Features

    • Scalable and highly available OpenVPN solution.
    • Integrated with cloud provider native ELB, the solution scales out to unlimited number of users and bandwidth.
    • Supports multi factor authentication: DUO, LDAP and OKTA.
    • User profile defined dynamic security access rules that allow administrator to determine access privilege of any given user to any resources at the network perimeter.
    • Supports Geo VPN for a global VPN solution deployment where a VPN user automatically connects to a nearest VPC.
    • Supports wide range of clients: Windows, OSX, Linux, Android, iOS, and Chromebook.
    • Supports event logging with SumoLogic, Logstash, Splunk and remote syslog server.
    • Supports Split tunnel and full tunnel mode.
    • No extra hop to other VPC/VNets.
    • Policy based stateful firewall at the VPC level for both access and deny to apps.
    • Environment Stamping solution for repeatable enterprise SaaS deployment.
    • Create identical VPC environments with one click for each customer.
    • Uniquely mapping and addressing instances for CloudOps and developers access.
    • Integrate AWS Route 53 DNS name service for each accessing.
  • Security Features

    • Stateful firewall on each gateway that controls traffic in and out the VPC.
    • Fully Qualified Domain Name (FQDN) whitelists control Internet bound egress traffic from instances on private subnets.

Q3: How do I launch the product?

The product consists of two components, the controller and one or more gateways. The gateway is launched from the controller.

The controller provides a central console for all provisioning, monitoring and upgrades of the services.

The controller is available in AWS and Azure marketplace. It is also available as a GCloud community image. For marketplace launch, search for “Aviatrix” in marketplace.

Follow Getting Started instructions to launch controller.

Q4: How do I access the controller?

Once you have launched the instance, you access the Controller instance via a web browser.


Login with username “admin”. The first time password is the private IP address of the controller instance. You are required to change the password at your first login.

Q5: How do I secure the controller?

Only TCP port 443 needs to be opened for inbound traffic to the controller. If you wish to reduce the scope of source addresses by specifying custom IP address, you must include all gateway public IP addresses, in addition to your own public IP address. This is because gateways launched from the controller use its public IP address to communicate back to controller.

Q6: Is Aviatrix Cloud Gateway a SaaS offer?

No. Aviatrix Cloud Gateway is a software product that is deployed in your own network perimeter.


Q1: Where do I start?

The first time when you login, complete Onboarding process. It takes a few steps.

If you have a BYOL license or use a community image, you need to have a customer ID provided by Aviatrix to be able to use the product. Contact if you do not have a customer ID.

Q2: What is an Aviatrix Cloud Account?

An Aviatrix Cloud Account is specific and unique on the controller. It contains cloud credentials, for example, your AWS IAM Access Key ID and Secret Key. The controller uses these credential to launch Aviatrix gateways by using cloud APIs.

An Aviatrix Cloud Account can correspond to multiple cloud account. For example, it can contain credentials for an AWS IAM account, Azure account and GCloud account.

Q3: How do I upgrade software?

Click Settings -> Upgrade. This upgrades to the latest release of the controller software.

When a new release becomes available, an alert message appears on Dashboard. An email will also be sent to the admin of the controller.

Q4: Is there a reference design example?

Check out

Q5: What is the support model?

For support, send email to We also offer premium customers with 24x7 support. To request a feature, click Make a wish button at the bottom of each page.

Scale Out VPN Solutions

Q1: How do I launch a VPN gateway?

Click Gateway -> + New Gateway

The controller launches an Aviatrix gateway instance in AWS/Azure/GCloud. The gateway instance must be launched from a public subnet. You need to give it a name (The name is presented as a Gateway Name field), this name becomes part of the instance name with a prefix CloudOps.

In the Create page, select VPN Access to enable OpenVPN server capability. There is a default VPN CIDR “”. But you can change it, make sure the CIDR is outside the existing and future VPC CIDR range. This VPN CIDR is where VPN server assign virtual IP address to each user when she connects.

You can select Save Template to save the gateway template. When you come to the page the next time, most of the fields are pre populated. You may change any of the fields.

Q2: How do I scale out VPN solution?

You can launch multiple VPN gateways in the same VPC at the Create Gateway time.

While launching a gateway, select yes for “Enable AWS ELB”. This will automatically create an AWS ELB (for the first gateway) and register the gateway with the newly created load balancer. VPN traffic will be load balanced across these multiple gateways.

It is required to have consistent gateway configuration when ELB is enabled. For example, authentication methods, tunnel modes and PBR configurations should be identical.

Q3: How do I setup Okta authentication for VPN?

Aviatrix vpn gateway integrates seamlessly with Okta. It can authenticate vpn users to Okta service using Okta’s OpenVPN pluggin in module. Follow the link: How to setup Okta for Aviatrix VPN gateway

Q4: How do I enable Geo VPN?

If you have global workforce that needs to access the cloud, Geo VPN offers a superior solution. Geo VPN enables a VPN user to connect to a nearest VPC that hosts Aviatrix VPN gateway.

To enable Geo VPN, go to OpenVPN -> GEO VPN.

Also check out this link for help.

Q5: How do I add a VPN user?

After at least one gateway is created, you can add VPN users.

Click OpenVPN -> VPN Users -> +Add New.

When a user is added, an email is sent to the user with instructions on how to download client software and connect to VPN server.

If you like to assign user profile based policies, you need to create profiles first, see the next section.

Q6: What user devices are VPN client software supported?

Windows, MAC, Linux, Chromebook, Android and iOS devices are supported.

Q7: Is NAT capability supported on the gateway?

Yes, you can enable NAT function at gateway launch time. When enabled, instances on the private subnet can access Internet directly.

If full tunnel mode is selected, you may want to enable NAT to allow instances in the VPC to have direct Internet access.

Q8: Is full tunnel mode supported on the gateway?

Yes, both split tunnel and full tunnel modes are supported. You can specify the mode at the gateway launch time.

Full tunnel means all user traffic is carried through the VPN tunnel to the gateway, including Internet bound traffic.

Split tunnel means only traffic destined to the VPC and any additional network range is carried through the VPN tunnel to the gateway. Any Internet bound traffic does not go through the tunnel.

Q9: Can the maximum number of simultaneous connections to VPN gateway be configured?

Yes, you can set the maximum number of connections at the gateway launch time.

Site2Cloud VPN

Q1: Occasionally my tunnel will show as down since there is no interesting traffic transversing, how do I keep it up?

This problem can be solved by disabling dead peer detection on your edge firewall.

User Profile Based Security Policies

Q1: What is user profile based security policy?

In VPN access, a user is dynamically assigned a virtual IP address when connected to a gateway. It is highly desirable to define resource access policies based on the users. For example, you may want to have a policy for all employees, a different policy for partners and a still different policy for contractors. You may even give different policies to different departments and business groups.

The profile based security policy lets you define security rules to a target address, protocol and ports. The default rule for a profile can be configured as deny all or allow all during profile creation. This capability allows flexible firewall rules based on the users, instead of a source IP address.

Q2: How do I setup profile based security policies?

When a user connects to a VPC, the security policies associated with the profile that the user is assigned to are applied to the VPN gateway instance that user logs in. This effectively blocks traffic from entering the network.

Click OpenVPN -> Profiles -> +New Profile to create profiles, then click Edit Policies to add rules. You can add multiple of them, then click on Save.

Q3: How do I assign a user to a profile?

When you create a VPN user at OpenVPN -> VPN Users -> +Add New, you can select profile option to assign the user to a specific profile.

You can also attach the user to a profile at a later time. Go to OpenVPN -> Profiles. Click Attach User on a specific Profile and select a user that is added to the VPN gateway.

Q4: What if I want to change profile policies?

You can change profile policies any time. However, the users who are currently active in session will not receive the new policy. The user need to disconnect and reconnect to VPN for the new policy to take effect.

Q5: How do I change a user’s profile programmatically?

The controller provides a REST API which can be invoked to change a user’s profile. Refer to API document under Help menu.

During this operation, the user’s existing VPN session will be terminated. The new profile policy will take effect when he or she logs in again.

The use case for this feature is to allow administrator to quarantine a VPN user for security reasons.

User Authentication

Q1: Is DUO multi-factor authentication supported?

Yes. If your enterprise has a DUO account with multi-factor authentication, it can be integrated into the VPN solution. From Gateways tab, click Create. At two-step authentication drop down menu, select DUO, then enter your company Integration Key, Secret Key and API hostname.

To obtain Integration Key, Secret key and API hostname, login to DUO website as an admin,, click on the left panel Applications, click Protect an Application below. Scroll down the application list and select OpenVPN (click Protect this Application), the next screen should reveal the credentials you need to configure on the Aviatrix controller.

For additional help, follow this instruction.

Currently advanced feature such as Trusted Device and Trusted Networks are not supported. Send us a request if you like to integrate these features.

Q2: How do I configure LDAP authentication?

LDAP configuration is part of the Gateway creation when VPN Access is enabled. Enter the necessary parameters and click Enable button to enable LDAP authentication for VPN clients. If your LDAP server is configured to demand client certificates for incoming TLS connections, upload a client certificate in PEM format (This certificate should contain a public and private key pair).

Q3: Can I combine LDAP and DUO authentication?

Yes. With both LDAP and DUO authentication methods enabled on a gateway, when launching the VPN client, a remote user will have to enter his or her LDAP user credentials and then approve the authentication request received on a registered mobile device to login to VPN.

Q4: Is OKTA supported?

Yes. OKTA with MFA is also supported. Follow the instructions

Policy Based Routing

Q1: How does Policy Based Routing (PBR) work?

When PBR is enabled at gateway launch time, all VPN user traffic arrives at the gateway will be forwarded to a specified IP address defined as PBR default gateway. User must specify the PBR Subnet which in AWS must be in the same availability zone as Ethernet 0 interface of the gateway.

When PBR feature is combined with encrypted peering capability, VPN user should be able to access any instances in the peered VPC/VNets. This helps build an end to end cloud networking environment. For details, check out our reference design.

Another use case for Policy Based Routing is if you like to route all Internet bound traffic back to your own firewall device on Prem, or log all user VPN traffic to a specific logging device, PBR lets you accomplish that.

Logging and Monitoring

Q1: How do I forward syslog events to my Logstash server?

Click on Settings-> Logging ->LogStash logging and input the required parameters to enable forwarding of controller syslog events and all gateways syslog and auth log to a Logstash server.

SUMO Logic, Splunk, DataDog and rSyslog are also supported.

Q2: What are the monitoring capabilities?

Encrypted tunnel (peering and site2cloud) status is monitored. When a tunnel status changes, an alert email is sent to the controller admin.

Active VPN users are displayed on the Dashboard. Click on any username, the user VPN connectivity history is displayed.

You can also disconnect a user from the dashboard.

Q3: Can alert email be sent to a different email address?

Yes, you can choose an alternative email address to send alert messages. This is useful if the controller admin is different from the operation team.

Encrypted peering

Q1: What can Aviatrix encrypted peering do?

Aviatrix encrypted peering builds an encrypted tunnel between two VPC/VNet with a single click. In addition to build the encrypted connection, the controller also program the cloud infrastructure routing table so that you don’t have to.

The VPC and/or VNet can be across region and across cloud. The solution enables you to build a full mesh encrypted network. You can enable stateful firewalls on each VPC/VNet to add additional security measures.

Q2: How do I configure encrypted peering?

Step 1: Gateway -> +New Gateway in one existing VPC/VNet. VPN access may be disabled.

Step 2: Repeat Step 1 with a different VPC ID or VNet Name.

Step 3: At Peering -> Encrypted Peering -> +New Peering. Select the two gateway names and click OK.

Environment Stamping Networking

Q1: What does Environment Stamping networking feature do?

Environment Stamping (envStamping) takes advantage of the unique nature of Virtual Private Cloud (VPC) and offers a deployment architecture that is secure and scalable.

envStamping provides a deployment solution where you can create identical environments such as identical VPC CIDRs and access instances in the VPC seamlessly and securely via encrypted tunnel, as shown in the picture below:


In the above picture, each managed VPC shares identical CIDRs, instances private IP addresses and security groups. CloudOps and developers access VPC instances by connecting to the gateway in the management VPC via Aviatrix VPN capability.

Q2: Who should be deploying this model?

This deployment model allows for infinite scale of deployment, it is suitable for SaaS providers, development and testing. With this model, SaaS provider can offer secure and single tenant to its enterprise customers, while being able to access instances for maintenance and support.

For example, a SaaS provider can offer an enterprise customer its own AWS account and VPC environment. Customer data is completely isolated from others. Only authorized personal can access customer instances for maintenance and troubleshooting.

Q3: What is the workflow to enable this feature?

Refer to this link for workflow steps.


Q1: Can there be multiple admins?

Yes. Username “admin” is the default admin user. But you can create multiple users with admin privilege. Follow the instructions to learn more about setting up multiple admin users.

Q2: Is there 2FA support to log in to the console?

Yes. In addition to password login, DUO authentication and LDAP are supported.

Q3: Can there be read only account for operation team?

Yes. Accounts -> Account Users -> Add A NEW USER, at Account Name field, select “read_only” from the drop down menu. This user account will have views to all pages but cannot make changes to any configurations.