Skip to Content

Wiki source code of VPN Access

Last modified by Thomas Coelho (local) on 2024/11/18 11:42
Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 {{warning}}
6 This page needs to be rework. New screen shots need to be doone.
7 {{/warning}}
8
9 To get full access to our network from external locations we provide a VPN access based on openVPN. This is free software and part of every Linux distribution. The following guide has been tested with Ubuntu.
10
11 For Linux we recommend the graphical configuration with ~[~[VPN with Networkmanager]].
12
13 It is available for Windows and MacOS too.
14
15
16 This article shows you how to log into our VPN network without using the terminal. This method is by far more convenient and you also may find this helpful if you are not very familiar with command lines.
17 We will use a VPN Plugin called network-manager.
18
19 === Installation ===
20
21 Open up a terminal of your choice (Ctrl + T) and install OpenVPN Network Manager by typing the following line:
22
23 sudo apt-get install network-manager-openvpn-gnome
24
25 Please enter your password to confirm the installation.
26
27 After the successful installation NetworkManager must be restartet:
28 \\ sudo service network-manager restart
29
30 Again, confirm with your password if necessary. 
31
32 ~== Getting Started ==
33
34 <br>~[~[File:step_01.png|thumb|x50|Menu in the top right corner in Ubuntu 14.04]]
35 ~[~[File:Settings-network.png|thumb|x50|Settings menu in Ubuntu 18.04]]
36 ~[~[File:Settings-network-vpn.png|thumb|x50|VPN Settings in Ubuntu 18.04]]
37
38 To get VPN access you must set up a new VPN connection first. Click on the two arrow symbol (or the WiFi symbol - depending on which connection you are currently using) in the top right corner.
39 ~: Now choose <code>VPN Connections ->  Configure VPN...</code>. <br>
40 A new window will open up.
41 ~: Click on <code>Add</code> to add a new connection. <br>
42 You will be asked for the connection type.
43 ~: Choose <code>OpenVPN</code> and click on <code>Create...</code>.
44 If in the top right corner the option <code>VPN Connections</code> does not exist, the open the normal settings and add a new openvpn connection in <code>Network</code>.
45
46 Next you need to edit and configure your connection. Choose any connection name (e.g. itp_openvpn). <br>
47
48 For the '''Gateway''' type:
49 vgw.itp.uni-frankfurt.de
50
51 (old gateway: vpn.itp.uni-frankfurt.de)
52
53 Under '''Authentication''' select <code>Password</code> as authentication type. Enter your user name and password and choose the CA Certificate 'private-ca-itp.crt'. It can be downloaded [http:~/~/th.physik.uni-frankfurt.de/~~thw/vpn/private-ca-itp.crt here].
54
55 Your new VPN connection will be listet in '''Network Connections'''.
56
57 ~==Using a VPN Connection==
58 To access a VPN network just click on the arrow or WiFi symbol on the top right corner. Your configured connection should be found under '''VPN Connections'''.
59
60
61 == OpenVPN from the command line ==
62
63 ~=== Install OpenVPN ===
64
65 It is not part of the default installation, but can easily installed using apt. Enter the following commands:
66
67 sudo apt install openvpn
68
69 This requires to enter your password to get super user privileges.
70
71 ~=== Command line configuration ===
72
73 We have setup a new VPN gateway. Please use this configuration and report problems.
74
75 This configuration routes all traffic trough ITP. This is useful if you want to download papers, which are restricted to the university network.
76 The second examples only routes the traffic going directly to the ITP trough the VPN and leaves your default gateway untouched. The only difference is the missing 'redirect-gateway' statement [http:~/~/th.physik.uni-frankfurt.de/~~thw/vpn/all-via-itp.ovpn]
77
78 <pre>
79 client
80 dev tun
81 proto udp
82 nobind
83 remote vgw.itp.uni-frankfurt.de
84 verify-x509-name vgw.itp.uni-frankfurt.de name
85 remote-cert-tls server
86 resolv-retry infinite
87 auth-user-pass
88 ca private-ca-itp.crt
89 # Comment this, if you don't want to redirect the default gateway
90 redirect-gateway def1             
91 </pre>
92
93 Download our CA (Certificate of Authority) [http:~/~/th.physik.uni-frankfurt.de/~~thw/vpn/private-ca-itp.crt] and store it in the same place. This file is needed for the verification of the authenticity of the server.
94
95 For only accessing internal services and routing your the normal traffic to your normal uplink use the following configuration: [http:~/~/th.physik.uni-frankfurt.de/~~thw/vpn/itp.ovpn]
96
97 <pre>
98 client
99 dev tun
100 proto udp
101 nobind
102 remote vgw.itp.uni-frankfurt.de
103 verify-x509-name vgw.itp.uni-frankfurt.de name
104 remote-cert-tls server
105 resolv-retry infinite
106 auth-user-pass
107 ca private-ca-itp.crt
108 </pre>
109
110
111 ~=== Start the VPN connection ===
112
113 Open a terminal and change to the path where the vpn config file is stored. Start the connection with
114 \\ sudo openvpn itp.ovpn
115
116 where itp.ovpn is the name of the config file. openvpn needs root access, therefore you must enter your local password for sudo. After this you have to enter your ITP credentials (Username and Password).
117
118 If everything went fine the output will look like:
119
120 <pre>
121 Fri Dec  7 15:03:00 2012 WARNING: Make sure you understand the semantics of ~-~-tls-remote before using it (see the man page).
122 Fri Dec  7 15:03:00 2012 NOTE: OpenVPN 2.1 requires '~-~-script-security 2' or higher to call user-defined scripts or executables
123 Fri Dec  7 15:03:00 2012 UDPv4 link local: [undef]
124 Fri Dec  7 15:03:00 2012 UDPv4 link remote: [AF_INET]141.2.246.2:1194
125 Fri Dec  7 15:03:00 2012 WARNING: this configuration may cache passwords in memory ~-~- use the auth-nocache option to prevent this
126 Fri Dec  7 15:03:00 2012 [FIAS-ITP_Generic_VPN_Service] Peer Connection Initiated with [AF_INET]141.2.246.2:1194
127 Fri Dec  7 15:03:02 2012 TUN/TAP device tap0 opened
128 Fri Dec  7 15:03:02 2012 do_ifconfig, tt->ipv6=0, tt->did_ifconfig_ipv6_setup=0
129 Fri Dec  7 15:03:02 2012 /sbin/ifconfig tap0 10.63.131.1 netmask 255.255.0.0 mtu 1500 broadcast 10.63.255.255
130 Fri Dec  7 15:03:02 2012 Initialization Sequence Completed
131 </pre>
132
133 Termiate the session by pressing Ctrl-C in this terminal.
134
135 == OpenVPN for Windows 10 ==
136
137 At the time of writing, you can download OpenVPN on '[[https:~~/~~/openvpn.net/community-downloads/>>https://openvpn.net/community-downloads/]]'.
138 Download the exe-file for Windows 10 and install OpenVPN.
139 Start 'OpenVPN GUI'. You will get a message that no config file was found. But starting 'OpenVPN GUI' creates a directory to put the config files into.
140
141 Next you need to download our [[CA (Certificate of Authority)>>http://th.physik.uni-frankfurt.de/~~thw/vpn/private-ca-itp.crt]] [http:~/~/th.physik.uni-frankfurt.de/~~thw/vpn/private-ca-itp.crt] and the [[config file>>http://th.physik.uni-frankfurt.de/~~thw/vpn/all-via-itp.ovpn]] [http:~/~/th.physik.uni-frankfurt.de/~~thw/vpn/all-via-itp.ovpn].
142
143 Some Browsers, depending on the download method, save some of these files as standard text files '.txt'. If this happens, you need to rename them to 'private-ca-itp.crt' and 'all-via-itp.ovpn'. With standard configuration Windows 10 does not show the endings of the file names. The endings are correct if for 'all-via-itp.ovpn' the file type is shown as 'OpenVPN Config' and  for 'private-ca-itp.crt' as 'Sicherheitszertifikat' or 'security certificate'.
144
145 You need to copy/save both files to C:/Users/'yourusername'/OpenVPN/config/, where 'yourusername' is your local username. In the picture below, the directory with the two needed files in it for a german Windows 10 is shown (for the username 'user'). (For both is assumed that 'C' is, as for most Windows systems, your main hard drive.)
146
147 ~[~[File:Openvpn-win10-1.png|center]]
148
149 If 'OpenVPN GUI' is started, you can find it in the lower right corner where the minisymbols are. Most likely you need to click on the small arrow first. It is the symbol with the computer screen and the lock symbol. Right click on the symbol and you get a menu where the first option is to connect. Click this option. This menu has less entries if the settings are not found. Then control the previous step.
150
151 ~[~[File:Openvpn-win10-2.png|center]]
152
153 After a few seconds you should get a login screen where you use the credentials of your itp account.
154
155 ~[~[File:Openvpn-win10-3.png|center]]
156
157 The login takes a few seconds. Your connection was successful if no error window occurs and now the symbol in the lower right is green.
158
159 ~[~[File:Openvpn-win10-4.png|center]]
160
161 ~==MacOS (tunnelblick)==
162
163 First download the itp certificate [http:~/~/th.physik.uni-frankfurt.de/~~thw/vpn/private-ca-itp.crt] and configuration file [http:~/~/th.physik.uni-frankfurt.de/~~thw/vpn/all-via-itp.ovpn]. If a '.txt' was added to the configuration file name, remove the ending '.txt'. At the end the two files should normally be namend 'private-ca-itp.crt' and 'all-via-itp.ovpn'.
164
165 Download the last stable release of the software tunnelblick [https:~/~/tunnelblick.net/downloads.html] and execute the dowloaded file.
166
167 ~[~[File:Tunnelblick1.png|center|750px]]
168
169 After completion of the installation, a new icon appears in the top bar. Drag and drop the downloaded configuration file to this new icon to add the configuration to tunnelblick. Most likely you do not need to add the certificate manually (it was enough to download it and is handled automatically). Alternatively double-clicking the .ovpn file will also start the import. Both files are copied to system. The original files are no longer referred.
170
171 ~[~[File:Tunnelblick2.png|center|750px]]
172
173 Open the settings page, like shown in the screenshot below and make sure the Default Route Option is selected. This option is ignored from the ovpn configuration.
174
175 ~[~[File:Ovpn_settings_default_route.jpg|center|750px]]
176
177 Now you can connect to the itp vpn via the new tunnelblick icon.
178
179 If something fails look into the log of the connection. It also includes multiple times the path to place where the configuration file (tunnelblick automatically renames it into 'config.ovpn') and the certificate are stored. The exact path varies depending on your previous choice to use the configuration just for the  current user or for all users.
180
181 ~[~[File:Tunnelblick3.png|center|750px]]
182
183 In this case the configuration file and the certificate are located in '/Library/Application Support/Tunnelblick/Shared/all-via-itp.tblk/Contents/Resources'. If you need to edit or replace the configuration file or the certificate, this can be done in this directory. If there is just the configuration file in the directory, then copy the certificate to the in the log mentioned directory.
184
185 ~==Problems changing the vpn settings in tunnelblick (macOS)==
186
187 There were problems reported when switching in tunnelblick from the old vpn (vpn.th.physik.uni-frankfurt.de with tap) to the new one (vgw.itp.uni-frankfurt.de with tun). You also have this problem if, after applying the new configuration file itp.ovpn, the vpn does not work and the output contains a line containing 'vpn.th.physik.uni-frankfurt.de'. Search the output for a line beginning with '~-~-config' and ending on '.ovpn'. This line specifies which configuration file (.ovpn) is used to establish the vpn connection and where it is located. Edit this file to have the same content as the itp.ovpn [http:~/~/th.physik.uni-frankfurt.de/~~thw/vpn/itp.ovpn] (most likely the lines 2, 5 and 6 need to be edited).
188
189 ~==Warning in tunnelblick (macOS)==
190 If you get the following warning, you can check the box and click OK.
191 ~[~[File:Tb-warn.png|center|500px]]
192
193 ~== Replacing the CA Certificate in macOS ==
194
195 When importing the configuration, the crt file is copied to somewhere in the system (see above). If you replace the crt file in your download or whatever folder it will not be used. The simpliest way to fix this is to delete the configuration from Tunnelblick and reimport it. Make sure the option "Route all traffic through the VPN" is checked (see instrcutions above).
196
197 This is needed after the replacment of the CA certificate in Nov 2020. This lives for 5 years. Next replacment will be in 2025, if we are still using openVPN then.
198
199