CSE OpenVPN NetworkCSE runs a VPN using the OpenVPN software. This package works on all major operating systems and distributions and has a relatively straightforward setup across the board.
OverviewCSE's VPN service allows users to:
- Encrypt network traffic between computers on CSE's untrusted or wireless subnetworks and CSE's servers and lab computers, and
- Access computers on CSE's server, trusted and untrusted subnetworks in a secure fashion from outside of the university.
Basic ConfigurationEssentially, you install openvpn, grab the config file and CA certificate file, and then run openvpn using the config file...
Install OpenVPNFor Windows, we recommend you visit the OpenVPN Community Software page and get an installer from there. Note that this package also includes the VNC server which is not generally required.
For macOS, you can visit the Tunnelblick (Homepage) and download the installer from there. For macOS, you might also wish to check out the Viscosity (Homepage).
On Linux/*NIX, there should be an openvpn package for whatever distribution you're running. On Debian: apt-get install openvpn.
On iOS (iPad and iPhone) you can download the free app called OpenVPN Connect from OpenVPN Technologies.
Configure OpenVPN: macOS, Linux & WindowsDownload and save the CSE Certificate Authority file.
Then save the following text in a configuration file:
# OpenVPN config file for use with UNSW/CSE wireless
# get cacert.pem from http://www.cse.unsw.edu.au/cacert.pem
verify-x509-name wireless.vpn.cse.unsw.edu.au name
Save this file using the filename wireless.ovpn for Windows. On Linux & macOS, use the filename wireless.conf The running instructions contains information on where to put these files (if it is important). For Windows installations, we recommend you place the wireless.opvn file and the cacert.pem in the OpenVPN configuration file directory for which you will find a shortcut in the OpenVPN program folder in the Windows Start Menu. By default, this is C:\Program Files\OpenVPN\config
Configure OpenVPN: iOS (iPad/iPhone)All of the required keys and certificates mentioned above are embedded in the cse-smartphone.ovpn file. Only this one file needs to be copied over to your iPad or iPhone.
- Download the cse-smartphone.ovpn file from the Download section at the end of this page.
- Start iTunes with your device connected to the computer.
- Select your device and then select the "Apps" screen.
- Scroll down to File Sharing and select the OpenVPN app.
- Drag the cse-smartphone.ovpn into the Documents window.
- Open the OpenVPN app on your iPad or iPhone.
- Select iTunes Sync as the method to import your profile.
- Select the wireless-vpn... profile.
- Enter your CSE user name and password.
Run OpenVPNThis service requires that you enter a user name and password. These can be either:
- Your zID and zPass (preferred), or
- your CSE user name and password (which most people don't have so don't worry if you don't have them either).
Linux/*NIXIf you want to run Openvpn manually on Linux you should not put the config file in /etc/openvpn, otherwise it will get run automatically at reboot. Put it somewhere else, and run:
sudo /usr/sbin/openvpn --config wireless.confYou will be prompted for username and password. Enter these and then it should all start working. If you are logged in to your computer as root you can omit the sudo.
Running OpenVPN automatically on LinuxIf you place the wireless.conf file (and cacert.pem) in /etc/openvpn, then openvpn will be run on this config file every time your computer boots. With the default configuration this can be awkward because it will prompt for a username and password and the boot sequence will not complete until these are given. An alternative is to place the username and password, each on a separate line, in a file, e.g. /etc/openvpn/userpass. Then change the auth-user-pass line in wireless.conf to have the name of the file as well. e.g. auth-user-pass /etc/openvpn/userpass For you own security you should not use your normal password, but a special authentication token. To test this out (without the need to reboot), run
macOSManually create the .opvn file as described in this step, and download CSE Certificate Authority file to the same local directory as the .opvn file. You will use both two files when configuring your OpenVPN client. Tunnelblick (Homepage) and Viscosity (Homepage) are two recommended OpenVPN clients. Follow the instructions for your chosen application to import and use these files.
Importing Configuration file into TunnelblickAfter install Tunnelblick on your mac, double-click wireless.opvn file(which manually created in previous step).
Choose to install Configuration file for either yourself (Only Me) or for All users on your mac.
(if the cacert.pem is saved in the same directory as wireless.opvn file, it will be imported automatically)
Microsoft WindowsThe openvpn installation on MS-Windows associated the OpenVPN program with .ovpn files. If you simply open (double-click) wireless.ovpn the file will be opened in an editor so you can review it. If you right-click you will get a menu which includes "Start OpenVPN on this config file". If you select that it will run OpenVPN and prompt for username and password.
Windows Vista, Windows 7 and aboveTo do this, copy over wireless.ovpn and cacert.pem to \Program Files\OpenVPN\config folder.
Create a shortcut for openvpn-gui.exe file which locates in C:\Program Files\OpenVPN\bin folder.
Right-click on this shortcut, then choose Properties -> Shortcut tab
- Change the target to read: "C:\Program Files\OpenVPN\bin\openvpn-gui.exe" --connect wireless.ovpn
- Switch to "Compatibility" tab, tick "Run this program as an administrator" under Privilege Level section
Please note: You need to run the OpenVPN Gui as administrator.
You can do this by right clicking on the icon and choosing "Run as Administrator". You can make this permanent by right clicking on the icon, selecting Properties, and then checking "Run this program as an administrator" from the Compatibility tab.
Replacing CA certificate fileTo replace a CA certificate file for a connection configuration file, you can simply locate the existing CA(.pem file) in your local computer then replace it with the updated one.
macOSThe CA file saved in the same directory as the configuration file depending on whether it is for All users or Only yourself:
location for All Users
/Library/Application Support/Tunnelblick/Shared/wireless.tblk/Contents/Resourceslocation for the current logon user
~/Library/Application Support/Tunnelblick/Configurations/wireless.tblk/Contents/Resources(paths are written in macOS Finder format. Accessing the paths via terminal, please replace " "(space) between the words "Application" and "Support" with "\ ")
WindowsThe CA file on Windows is saved in the following directory:
Multiple ConnectionsOpenVPN normally identifies each connection by the username that was used for authentication. This means that you normally cannot have two concurrent OpenVPN connections that are authenticated with the same username. If you attempt to make a second connection with the same username, the first one will be disconnected. To alleviate this, our VPN configuration allows you to add an arbitrary suffix to your username which is stripped off during authentication, effectively providing you with multiple unique usernames. So, if you have two computers for which you want to have VPN tunnels established, you could configure one to authenticate as myusername.notebook and the other as myusername.home. Note that the suffix is separated from the username by a period (dot, or fullstop).
External SitesBy default the VPN does not allow your network traffic to flow through it to the outside world. This means that when you try to connect to any sites outside of CSE the network traffic will flow directly between your computer and these sites, rather then being routed through the VPN and then to the sites. Sometimes this isn't ideal, such as when when you are trying to access services subscribed to by UNSW which use UNSW's IP address to allow access. It is, however, possible to cause all your network traffic to be routed through CSE rather than just the network traffic for CSE's own subnetworks. To enable this, when you authenticate add a suffix beginning with the string ".setdefaultroute" to the end of your username. This causes a default route to be set for the VPN which routes all your traffic through CSE's VPN, not just the traffic addressed to CSE's subnetworks. Note that if you are using a username suffix as described in the previous section, the .setdefaultroute suffix must appear after the arbitrary suffix you chose e.g. <username>.<arbitrary suffix>.setdefaultroute There's a minor problem in this however, and that is when all of your traffic flows through the VPN your local DNS server may be unreachable. This is particularly a problem when you are using the VPN from home through something like an ADSL connection. In such a case your DNS server would normally be set to be the address of your ADSL router (e.g., 192.168.0.1), but once the VPN is set up this can no longer be reached. A solution to this is to allow OpenVPN to reconfigure your DNS settings so that your computer uses the DNS servers at CSE. This makes sense and it also allows you to use short names for servers---such as "williams" instead of "williams.cse.unsw.edu.au". To make this happen under Linux you need to install the following files in the configuration directory you use for OpenVPN and then restart the VPN on your computer:
wireless.conf.setdefaultrouteAdd these lines to the end of wireless.conf file above:
up wireless-up down wireless-down
#!/bin/sh # resolv_conf_new="/etc/resolv.conf.openvpn" resolv_conf_old="/etc/resolv.conf.openvpn.keep" # rm -f "$resolv_conf_new $resolv_conf_old" # env > /tmp/dummy # n=1 dns_set=0 while true; do # eval v=\$foreign_option_$n if [ "a$v" = "a" ]; then break; fi # opt=`echo "$v" | cut -d' ' -f1` case $opt in dhcp-option) subopt=`echo "$v" | cut -d' ' -f2` param=`echo "$v" | cut -d' ' -f3` case $subopt in DNS) echo "nameserver $param" >> $resolv_conf_new dns_set=1 ;; DOMAIN) echo "domain $param" >> $resolv_conf_new dns_set=1 ;; esac ;; esac # n=$(($n + 1)) done # if [ $dns_set -ne 0 ]; then cp -p /etc/resolv.conf $resolv_conf_old mv -f $resolv_conf_new /etc/resolv.conf fi
#!/bin/sh # resolv_conf_old="/etc/resolv.conf.openvpn.keep" # if [ -e $resolv_conf_old ]; then mv -f $resolv_conf_old /etc/resolv.conf fi