OpenVPN Client Settings¶

Packages:¶

• Debian/Ubuntu: sudo aptitude install openvpn network-manager-openvpn

Procedure:¶

• Copy your key, certificate, and server certificate to a secure location of your choice such as ~/openvpn/. Set paranoid permissions (-r-x—— or similar).
• Install Network Manager (installed by default in many Linux distributions)
• Install the Network Manager OpenVPN package
• Open Network Manager
• Add a new VPN connection:
  • Connection name: <witty name>
  • Gateway: vpn.osuosl.org
  • Type: Certificates (TLS)
  • User Certificate: <username>.crt
  • CA Certificate: ca.crt
  • Private Key: <username>.key
  • Private Key Password: <password> (if applicable)
  • IPv4 Settings->Routes...->Use this connection only for resources on its network: ✔ (if unchecked, all network traffic is routed through the VPN)
• Apply
• Click on the Network Manager status bar icon and select VPN Connections-><witty name>
• Wait until connection is established
• Check connection:
  • ifconfig -a: IP address should be in the 10.2.*.* range.
  • ping 10.2.0.1: The router should respond

Trouble shooting¶

Shotgun style - try again, reboot, disable network devices, do the chicken dance. If all else fails, try the command line version. If that works, try this again, maybe it just didn’t like you the first time.

Packages:¶

• Debian/Ubuntu: sudo aptitude install openvpn
• Gentoo: sudo emerge openvpn. For detailed instructions, including kernel configuration see http://en.gentoo-wiki.com/wiki/OpenVPN.

Procedure:¶

• Copy your key, certificate, and server certificate to a secure location of your choice such as /etc/openvpn/. Set paranoid permissions (-r-x—— or similar).
• Create a configuration file in a location of your choice such as /etc/openvpn/openvpn.conf. Here is an example configuration file:

client                         # Client mode
dev tun                        # Create a TUN device (not TAP)
proto udp                      # Use UDP (not TCP)

remote vpn.osuosl.org 1194  # Server settings
remote-cert-tls server         # Use TLS to check server identity

ca /etc/openvpn/ca.crt                      # Server certificate
cert /etc/openvpn/<username>.crt            # Client certificate
key /etc/openvpn/<username>.key             # Client private key

resolv-retry infinite          # Never give up trying to connect to the
                               # server (useful for unreliable internet
                               # connections and laptops)
nobind                         # Don't bind a local port

# Drop privileges after initialization (not applicable to Windows)
user nobody
group nobody

# Preserve state across restarts.
persist-key
persist-tun

mute-replay-warnings           # Do not complain about duplicate packets
                               # (common on wireless networks)

# Verify server certificate by checking that the certicate has the
# nsCertType field set to 'server'. See:
# http://openvpn.net/index.php/open-source/documentation/howto.html#mitm
ns-cert-type server

verb 4                         # Set log file verbosity
script-security 3 system       # Enable dns-pushing

# For Ubuntu:
up /etc/openvpn/update-resolv-conf
down /etc/openvpn/update-resolv-conf

# For Gentoo:
up /etc/openvpn/up.sh
down /etc/openvpn/down.sh

# For Fedora:
up /usr/share/doc/openvpn/contrib/pull-resolv-conf/client.up
down /usr/share/doc/openvpn/contrib/pull-resolv-conf/client.down

• Run OpenVPN: openvpn /etc/openvpn/openvpn.conf
• Check connection:
  • ifconfig -a: IP address should be in the 10.*.*.* range.
  • ping 10.0.0.1: The router should respond

Troubleshooting¶

The version of OpenVPN we are running is incompatible with OpenVPN client v2.4+ on OS X. If you are running OS X, please use OpenVPN v2.3 to connect to the VPN.

Disabling LZO compression may help on older OpenVPN instances.

In addition, the version of OpenVPN we are running is incompatible with TLSv1.2, so if you are running into issues (such as on Debian 10), please do the following in /etc/ssl/openssl.cnf:

#MinProtocol = TLSv1.2
MinProtocol = TLSv1

We plan to resolve this issue soon.

Installation¶

Download and install Tunnelblick from the project’s downloads page.

Alternatively install the package using the Homebrew:

brew cask install tunnelblick

Configuration¶

1. Download this Tunnelblick profile.
2. Replace the contents of osuosl.tblk/USER.crt and osuosl.tblk/USER.key with your personal crt and key.
3. Double click the osuosl.tblk file to install the profile in Tunnelblick.
4. Connect to the osuosl profile in Tunnelblick.