Aviatrix VPN Client User Guide

Installing and Launching the Application

Windows

  1. Download the Aviatrix VPN Client installer here.

    Run the installer and follow the onscreen instructions to install the application.

    If you have installed UserVPN previously, TUN TAP drivers would have been installed. If they are not installed , you can install the same from this link.

  2. Save the VPN configuration file (with the extension .ovpn) that was sent to you by your Admin, on to your machine.

  3. Open the “Aviatrix VPN Client” application by going to “Start Menu > Aviatrix VPN Client > Aviatrix VPN Client”.

    Windows Client Location

  4. 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.

  5. Skip to the Using the Application section if you do not need to install it on a Mac or Linux.

Mac

  1. Download the Aviatrix VPN Client installer from this link.

    Follow the on-screen instructions to install the application.

  2. Save the OpenVPN configuration file (with the extension .ovpn) that was sent to you by your Admin, on to your machine.

  3. Start the Aviatrix VPN Client application by going to LaunchPad and clicking on “Aviatrix VPN Client”.

  4. A popup comes up to request sudo privileges to modify routing tables.

    Mac Credential

  5. This opens the application window.

  6. Skip to the Using the Application section if you do not need to install it on Linux.

Linux |lux|

  1. Download the Aviatrix VPN Client installer from this link.

  2. To install the application run the following commands:

    tar -xvzf AVPC_linux.tar.gz
sudo ./install.sh

  3. Save the VPN configuration file (with the extension .ovpn) that was sent to you by your Admin, on to your machine.

  4. To open the “Aviatrix VPN Client” launch a new terminal and type AVPNC.

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:

1.

Add

This opens a window to choose the OpenVPN configuration (.ovpn) file.

2.

Minus

This deletes an item chosen in the Connection Profiles.

3.

3 Dots

This pops up a submenu including "Edit", "Sort", "Connection Log" and "Settings."

  • "Edit": Modify an item chosen in the Connection Profiles

  • "Connection Log": Show every single connection’s log

  • "Settings": Open the advanced settings

Windows

  1. There is a menu on the top of the App GUI.

    1. "File" has a menu to quit the App.

    2. "Help" has menu "About" to show the App information.

  2. Closing the application window hides it to the system tray.

Mac

  1. There is a menu on the top-left of the screen:

    1. "About" shows show the App information

    2. "Quit" exit the App information

  2. Closing the application window hides it to the system tray

    Mac Bottom Bar

  3. Right-click on Windows’s or a click on Mac’s system tray icon to show a menu.

    Tray Menu

    There are 3 status icons that are shown in the window and on the tray.

Advanced Settings Page

Settings

Here you can perform special operations if Troubleshooting is required.

  1. Flush DNS: (Not for Windows) Flushes the DNS configuration if there are internet issues after full tunnel VPN disconnection. Also turning the Wi-fi/ethernet adapter on/off can fix some internet issues.

  2. Kill all OpenVPN process: (Not supported on Windows) Sends a soft kill to all running OpenVPN processes

  3. Force kill all OpenVPN process: Terminates other OpenVPN processes that are running abruptly

  4. 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 VPN 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 LDAP Configuration for Authenticating VPN Users for details.

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.

For example, 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 window appears.

LDAP Auth