|
Size: 7218
Comment:
|
Size: 4162
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| The[http://en.wikipedia.org/wiki/Virtual_private_network VPN] is implimented with[http://www.openvpn.org OpenVPN]. | The VPN ([http://en.wikipedia.org/wiki/Virtual_private_network Virtual Private Network]) running on the Babase server uses the [http://www.openvpn.org OpenVPN] implementation. |
| Line 3: | Line 3: |
| == Installing the Babase VPN == === Mac OSX === |
== Babase VPN on Mac OS X == |
| Line 9: | Line 9: |
| Go to http://www.tunnelblick.net/ and download the latest released version which will extract itself upon downloading. Available[http://www.tunnelblick.net/Tunnelblick_3.0_B4.zip here] | Go to http://www.tunnelblick.net/ and download the latest released version which will extract itself upon downloading. * Version 3.0_B4 is available[http://www.tunnelblick.net/Tunnelblick_3.0_B4.zip here] |
| Line 19: | Line 20: |
| When you run Tunnelblick you will, I think, want to configure it so that it does _not_ run the up/down scripts to change the nameserver. If you find this to be the case, please update this wiki with the proper instructions. [[Anchor(client.conf)]] | When you run Tunnelblick you will see a little tunnel at the top right hand corner of the screen which will let you connect by selecting "Connect 'openvpn'" and disconnect with the "Disconnect 'openvpn'" commands through the graphical dropdown. It may be helpful to have tunnelblick be in your startup items so you don't have to run it every time you want to connect on computers that are typically used for ranking. |
| Line 21: | Line 22: |
| === The client.conf file === {{{ ############################################## # Client-side OpenVPN 2.0 config file # # for connecting to the babase VPN on. # # papio.biology.duke.edu. # # # # On Windows, you might want to rename this # # file so it has a .ovpn extension # ############################################## |
== BabaseVPN on Windows XP == |
| Line 32: | Line 24: |
| # Specify that we are a client and that we # will be pulling certain config file directives # from the server. client |
As Administrator, install [http://www.openvpn.se/ OpenVPN GUI for Windows]. Unless you already have OpenVPN (without GUI) installed on your computer, it is easiest to download and install the installation package with both OpenVPN and OpenVPN GUI. Once installation completes, you should notice a new OpenVPN GUI icon in your system tray (at the lower-right corner of your desktop). The icon should be lit red at this point, because you have not made a VPN connection yet. |
| Line 37: | Line 26: |
| # Use the same setting as you are using on # the server. # On most systems, the VPN will not function # unless you partially or fully disable # the firewall for the TUN/TAP interface. ;dev tap dev tun |
Download the following two files, and place them in the {{{C:\\Program Files\OpenVPN\config\}}} directory on your computer: * [{{{albertslab.crt}}}] * [{{{papio.ovpn}}}] |
| Line 45: | Line 30: |
| # Windows needs the TAP-Win32 adapter name # from the Network Connections panel # if you have more than one. On XP SP2, # you may need to disable the firewall # for the TAP adapter. ;dev-node MyTap |
Now, to connect, right click on the OpenVPN GUI icon in your system tray, and choose "Connect". You will be prompted for your Duke Biology Unix user name and password. If the connection is successful, the icon will turn green. To disconnect, simply right lick on the icon and choose "Disconnect". |
| Line 52: | Line 32: |
| # Are we connecting to a TCP or # UDP server? Use the same setting as # on the server. ;proto tcp proto udp |
==== Optional Tweaks to Configuration ==== |
| Line 58: | Line 34: |
| # The hostname/IP and port of the server. # You can have multiple remote entries # to load balance between the servers. remote papio.biology.duke.edu 1194 ;remote my-server-2 1194 |
By default, OpenVPN GUI will start in your system tray whenever your computer starts up. If you do not want this behavior, you can use [http://www.microsoft.com/technet/sysinternals/Utilities/AutoRuns.mspx AutoRuns for Windows] to tweak it. |
| Line 64: | Line 36: |
| # Choose a random host from the remote # list for load-balancing. Otherwise # try hosts in the order specified. ;remote-random |
If you normally use your Windows XP computer as a non-Administrator user, you should create a shortcut to {{{C:\\Program Files\OpenVPN\bin\openvpn-gui.exe}}}, right-click on the shortcut, select "Properties", click "Advanced..." and select "Run with different credentials". Now, when you double-click this shortcut, you should choose to run it as Administrator (VPN will not function correctly if you do not run it as Administrator). The How-To section of the [http://openvpn.se/howto.html OpenVPN GUI website] has more information on how to run VPN as a non-admin user. |
| Line 69: | Line 38: |
| # Keep trying indefinitely to resolve the # host name of the OpenVPN server. Very useful # on machines which are not permanently connected # to the internet such as laptops. resolv-retry infinite |
== Note on Using the Babase VPN == |
| Line 75: | Line 40: |
| # Most clients don't need to bind to # a specific local port number. nobind |
When you start the VPN you will be asked for your Duke Biology Unix user name and password. |
| Line 79: | Line 42: |
| # Downgrade privileges after initialization (non-Windows only) user nobody ;group nobody # Try to preserve some state across restarts. persist-key persist-tun # If you are connecting through an # HTTP proxy to reach the actual OpenVPN # server, put the proxy server/IP and # port number here. See the man page # if your proxy server requires # authentication. ;http-proxy-retry # retry on connection failures ;http-proxy [proxy server] [proxy port #] # Wireless networks often produce a lot # of duplicate packets. Set this flag # to silence duplicate packet warnings. ;mute-replay-warnings # SSL/TLS parms. # See the server config file for more # description. It's best to use # a separate .crt/.key file pair # for each client. A single ca # file can be used for all clients. ca albertslab.crt ;cert client.crt ;key client.key auth-user-pass # Verify server certificate by checking # that the certicate has the nsCertType # field set to "server". This is an # important precaution to protect against # a potential attack discussed here: # http://openvpn.net/howto.html#mitm # # To use this feature, you will need to generate # your server certificates with the nsCertType # field set to "server". The build-key-server # script in the easy-rsa folder will do this. ;ns-cert-type server ns-cert-type server # If a tls-auth key is used on the server # then every client must also have the key. ;tls-auth ta.key 1 # Select a cryptographic cipher. # If the cipher option is used on the server # then you must also specify it here. ;cipher x # Enable compression on the VPN link. # Don't enable this unless it is also # enabled in the server config file. ;comp-lzo # Set log file verbosity. verb 3 # Silence repeating messages ;mute 20}}} [[Anchor(albertslab.crt)]] === The root certificate authority === This data belongs in a file named: {{{albertslab.crt}}} The root certificate authority certificate for the babase VPN is: {{{ -----BEGIN CERTIFICATE----- MIID7jCCA1egAwIBAgIBADANBgkqhkiG9w0BAQQFADCBsTELMAkGA1UEBhMCVVMx CzAJBgNVBAgTAk5DMQ8wDQYDVQQHEwZEVVJIQU0xLDAqBgNVBAoTI0R1a2UgVW5p dmVyc2l0eSwgQmlvbG9neSBEZXBhcnRtZW50MRQwEgYDVQQLEwtBbGJlcnRzIExh YjEfMB0GA1UEAxMWcGFwaW8uYmlvbG9neS5kdWtlLmVkdTEfMB0GCSqGSIb3DQEJ ARYQYWxiZXJ0c0BkdWtlLmVkdTAeFw0wNzAxMTgxODMyMjhaFw0xNzAxMTUxODMy MjhaMIGxMQswCQYDVQQGEwJVUzELMAkGA1UECBMCTkMxDzANBgNVBAcTBkRVUkhB TTEsMCoGA1UEChMjRHVrZSBVbml2ZXJzaXR5LCBCaW9sb2d5IERlcGFydG1lbnQx FDASBgNVBAsTC0FsYmVydHMgTGFiMR8wHQYDVQQDExZwYXBpby5iaW9sb2d5LmR1 a2UuZWR1MR8wHQYJKoZIhvcNAQkBFhBhbGJlcnRzQGR1a2UuZWR1MIGfMA0GCSqG SIb3DQEBAQUAA4GNADCBiQKBgQDMrqCCviAKmIJ/Hkmg92Uh4UD0S38Z0sDAk9T1 yw/1LyMMP8I3jR0y5nGQaExk0bNSrcwp1FOLj/a7D965a2zYg2/0XyArEP+sQWsR F28QeTcr14M5g8aVY/SapxvhU2zQkrcq3Gzq+vJkfiorPadUPMLj4aliI4VZBvAo Zvy2/wIDAQABo4IBEjCCAQ4wHQYDVR0OBBYEFHf5eTppS3HZbpk8qv2vg24nb8ga MIHeBgNVHSMEgdYwgdOAFHf5eTppS3HZbpk8qv2vg24nb8gaoYG3pIG0MIGxMQsw CQYDVQQGEwJVUzELMAkGA1UECBMCTkMxDzANBgNVBAcTBkRVUkhBTTEsMCoGA1UE ChMjRHVrZSBVbml2ZXJzaXR5LCBCaW9sb2d5IERlcGFydG1lbnQxFDASBgNVBAsT C0FsYmVydHMgTGFiMR8wHQYDVQQDExZwYXBpby5iaW9sb2d5LmR1a2UuZWR1MR8w HQYJKoZIhvcNAQkBFhBhbGJlcnRzQGR1a2UuZWR1ggEAMAwGA1UdEwQFMAMBAf8w DQYJKoZIhvcNAQEEBQADgYEAIiyqufdwn4ud7RyU20RYsZjUACygVGRwkZzk1h/l bmrw5L0CB48+LpraG0pPRduyn156RD313+MqOu2RD50aT7MuJUMu4uaBU/qEpiTk prVz3ACeiAlnnaTSdJl6n55Dc059vr2pxBZ8rLDIRaK9TDEwTSHPyzfmHExcAcRk JvE= -----END CERTIFICATE-----}}} == Using the Babase VPN == When you start the VPN you will be asked for your Duke Biology Unix username and password. To test the vpn use the "ping" program to ping {{{papio-vpn.biology.duke.edu}}} (aka 172.16.3.1). If you get a response the VPN is working. |
To test the VPN use the "ping" program to ping {{{papio-vpn.biology.duke.edu}}} (aka 172.16.3.1). If you get a response the VPN is working. |
The VPN ([http://en.wikipedia.org/wiki/Virtual_private_network Virtual Private Network]) running on the Babase server uses the [http://www.openvpn.org OpenVPN] implementation.
Babase VPN on Mac OS X
You always have the option of installing the application using the instructions on the OpenVPN [http://www.openvpn.org web site], but the easier way, if you've Mac OS X 10.3 or higher, is to use the pre-packaged OpenVPN that includes a management GUI.
Note: This will probably work for Mac OS X 10.3 or 10.4 on the PPC/Intel architecture. If you have an older version we'll have to do something else.
Go to http://www.tunnelblick.net/ and download the latest released version which will extract itself upon downloading.
Version 3.0_B4 is available[http://www.tunnelblick.net/Tunnelblick_3.0_B4.zip here]
When the program is done downloading and extracts itself, place it in your applications folder then drag the icon in the applications folder to your dock.
Open your home folder and go to Library. Then open the folder entitled openvpn.
In this folder you will need to place two files in this directory.
The[http://papio.biology.duke.edu/babasewiki/BabaseVPN?action=AttachFile&do=get&target=openvpn.conf client.conf] from below which will be named openvpn.conf
The[http://papio.biology.duke.edu/babasewiki/BabaseVPN?action=AttachFile&do=get&target=albertslab.crt albertslab.crt] from below which will retain the same name
When you run Tunnelblick you will see a little tunnel at the top right hand corner of the screen which will let you connect by selecting "Connect 'openvpn'" and disconnect with the "Disconnect 'openvpn'" commands through the graphical dropdown. It may be helpful to have tunnelblick be in your startup items so you don't have to run it every time you want to connect on computers that are typically used for ranking.
BabaseVPN on Windows XP
As Administrator, install [http://www.openvpn.se/ OpenVPN GUI for Windows]. Unless you already have OpenVPN (without GUI) installed on your computer, it is easiest to download and install the installation package with both OpenVPN and OpenVPN GUI. Once installation completes, you should notice a new OpenVPN GUI icon in your system tray (at the lower-right corner of your desktop). The icon should be lit red at this point, because you have not made a VPN connection yet.
Download the following two files, and place them in the C:\\Program Files\OpenVPN\config\ directory on your computer:
[albertslab.crt]
[papio.ovpn]
Now, to connect, right click on the OpenVPN GUI icon in your system tray, and choose "Connect". You will be prompted for your Duke Biology Unix user name and password. If the connection is successful, the icon will turn green. To disconnect, simply right lick on the icon and choose "Disconnect".
Optional Tweaks to Configuration
By default, OpenVPN GUI will start in your system tray whenever your computer starts up. If you do not want this behavior, you can use [http://www.microsoft.com/technet/sysinternals/Utilities/AutoRuns.mspx AutoRuns for Windows] to tweak it.
If you normally use your Windows XP computer as a non-Administrator user, you should create a shortcut to C:\\Program Files\OpenVPN\bin\openvpn-gui.exe, right-click on the shortcut, select "Properties", click "Advanced..." and select "Run with different credentials". Now, when you double-click this shortcut, you should choose to run it as Administrator (VPN will not function correctly if you do not run it as Administrator). The How-To section of the [http://openvpn.se/howto.html OpenVPN GUI website] has more information on how to run VPN as a non-admin user.
Note on Using the Babase VPN
When you start the VPN you will be asked for your Duke Biology Unix user name and password.
To test the VPN use the "ping" program to ping papio-vpn.biology.duke.edu (aka 172.16.3.1). If you get a response the VPN is working.
To connect to papio using the VPN you cannot use papio.biology.duke.edu. Use papio-vpn.biology.duke.edu (172.16.3.1) instead.
