Aviatrix VPN Client User Guide
Installing and Launching the Application
Windows
Download the Aviatrix VPN Client installer from this link
Run the installer and follow the on-screen instructions to install the application.
If you have installed OpenVPN previously, TUN TAP drivers would have been installed. If they are not installed, you can install the TUN TAP at the end of the installation.
Save the OpenVPN configuration file (with the extension .ovpn) that was sent to you by your Admin, on to your machine.
Open the “Aviatrix VPN Client” application by going to “Start Menu -> Aviatrix VPN Client-> Aviatrix VPN Client”.
A UAC window pops up.
Allow administrator access so that the application can modify the routing tables. The Aviatrix VPN Client window should come up which should look like.
Skip to the Using the Application section if you do not need to install it on a Mac or Linux
Mac
Download the Aviatrix VPN Client installer from this link
Follow the on-screen instructions to install the application
Save the OpenVPN configuration file (with the extension .ovpn) that was sent to you by your Admin, on to your machine.
Start the Aviatrix VPN Client application by going to LaunchPad and clicking on “Aviatrix VPN Client”.
A popup comes up to request sudo privelages to modify routing tables
This opens the application window.
Skip to the Using the Application section if you do not need to install it on Linux
Linux
Download the Aviatrix VPN Client installer from this link
To install the application run the following commands
tar -xvzf AVPC_linux.tar.gz
sudo ./install.sh
Save the OpenVPN configuration file (with the extension .ovpn) that was sent to you by your Admin, on to your machine.
To open the “Aviatrix VPN Client” launch a new terminal and type AVPNC
Note
This has been tested only on Ubuntu 16/14. Theoretically, it should work with other flavours of linux as well as long as openvpn is installed separately.
Using the Application
There are 3 buttons on the bottom
: This opens a window to choose the OpenVPN configuration (.ovpn) file.
: This pops up a submenu including “Edit”, “Sort”, “Connection Log” and “Settings”
3.1 “Edit”: Modify a item choosed in the Connection Profiles
3.2 “Connection Log”: Show every single connection’s log
3.3 “Settings”: Open the advanced settings
Windows
Mac
There is a menu on the top-left of the screen
1.1 “About” shows show the App information
1.2 “Quit” exit the App information
Closing the application window hides it to the system tray
By a right click on Windows’s or a click on Mac’s system tray icon to show a menu
There are 3 status icons that are shown in the window and on the tray.
Advanced Settings Page
Here you can perform special operations if Troubleshooting is required
Flush DNS: (Not for windows) Flushes the DNS configuration if there are internet issues after full tunnel VPN disconnection. Also turning the wifi/ethernet adapter on/off can fix some internet issues.
Kill all OpenVPN process: (Not supported on Windows) Sends a soft kill to all running OpenVPN processes
Force kill all OpenVPN process: Terminates other OpenVPN processes that are running abruptly
Check VPN DNS server reachability: (MacOS only) If this option is checked, it will apply the VPC DNS servers in the MacOS system. If it is disabled, it will use the local DNS servers or other local DNS mechanism (e.g. CISCO Umbrella)
Connecting to a SAML Gateway
Enter your IDP Credentials to login.
Check doc OpenVPN® with SAML Authentication for detail.
Connecting to a Gateway without any Authentication
Just load the OpenVPN configuration(.ovpn) file on to the VPN Client and click on “Connect”.
Connecting to a Gateway with Username-Password Authentication
CloudN VPC supports a variety of authentication methods to verify VPN user credentials. Here’s a brief overview of how to enter user credentials for different authentication methods.
LDAP:
Enter username and password stored on LDAP server.
Check doc LDAP Configuration for Authenticating VPN Users for detail.
Google 2-step verification:
Use your email address as the username.
Password should be appended with the 6-digit code generated by Google authenticator app on your phone.
E.g., If your email is “joe@examplecompany.com”, the following username password combination of “joe@examplecompany.com” and “password123456” should be used where “password” is your account password and “123456” is the 6 digit-code.
Duo Security Two-Factor Authentication: Mac and Windows users:
An automatic approval request will be pushed to your registered cellphone. Select “Approve” to connect to VPN gateway.
LDAP + Duo Security Two-Factor Authentication:
Enter username and password for the LDAP server and an automatic approval request will be pushed to your registered cellphone.
Select “Approve” to connect to VPN gateway.
The username and password windows is shown