TalTech VPN: Difference between revisions

From ICO wiki
Jump to navigationJump to search
 
(80 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=Uni-ID=
=Uni-ID=
* EST https://confluence.ttu.ee/it-info/varia/uni-id-ehk-digitaalne-identiteet
[https://taltech.atlassian.net/wiki/spaces/ITI/pages/38994346/Uni-ID+ehk+Digitaalne+identiteet about Uni-ID (EST/ENG)]
* EST https://wiki.ttu.ee/et/juhendid/it/doc/uni-id
* ENG https://wiki.ttu.ee/en/manuals/it/doc/uni-id


Uni-ID is required to use TTU VPN.
Uni-ID is required to use TalTech VPN.
 
=eduVPN=
'''NB!
* Since June 30, 2024 eduVPN will be closed and replaced with [[#Forticlient_VPN|FortiClient VPN]]
* Since July 2021 has been old [[#OpenVPN|OpenVPN]] service replaced by eduVPN, used for library.'''
 
More information:
* [https://eduvpn.taltech.ee/ eduVPN portal in TalTech - OpenVPN settings generation and download]
* [https://taltech.atlassian.net/wiki/spaces/ITI/pages/39000862/Kaugt+hendus+eduVPN+sulgub+30.06.2024+Remote+connection+with+eduVPN+closes+30.06.2024 how to configure (EST, ENG)]
* [https://www.eduvpn.org/ about eduVPN]
 
Usually generated OpenVPN settings are enough. Still there is a separate ''eduvpn-client'' possible to use:
* [https://python-eduvpn-client.readthedocs.io/en/master/installation.html#debian-and-ubuntu Ubuntu and Debian client installation, configuration] (also Fedora, CentOS and manual installation via [https://en.wikipedia.org/wiki/Pip_(package_manager) pip] available)
sudo apt install apt-transport-https curl
curl -L https://app.eduvpn.org/linux/deb/eduvpn.key | sudo apt-key add -
echo "deb https://app.eduvpn.org/linux/deb/ stable main" | sudo tee -a /etc/apt/sources.list.d/eduvpn.list
sudo apt update
sudo apt install eduvpn-client
sudo ldconfig && sudo dpkg --configure -a && sudo apt-get clean
 
For OpenVPN installation, [[#Installation_in_Debian.2FUbuntu|please see here]]
 
For smart devices, there are an eduVPN clients available:  [https://play.google.com/store/apps/details?id=nl.eduvpn.app Android] | [https://apps.apple.com/us/app/eduvpn-client/id1292557340 iOS], that makes connection via TAAT authentication.


=Forticlient VPN=
=Forticlient VPN=
'''FortiClient VPN is for employees only.''' Does not allow to access the TTU library outside university. You will get only a secure VPN connection.
* [https://taltech.atlassian.net/wiki/spaces/ITI/pages/38994267/Kaug+hendus+FortiClient+VPN+Remote+connection+with+FortiClient+VPN FortiClient guidance]
 
* EST https://confluence.ttu.ee/it-info/kauguehendus-vpn/kauguehendus-forticlient-vpn
* EST https://wiki.ttu.ee/et/juhendid/it/doc/vpn
* ENG https://wiki.ttu.ee/en/manuals/it/doc/vpn


==Packages==
==Packages==
* clean client https://www.forticlient.com/downloads
* clean client https://www.forticlient.com/downloads
* for MS Windows, TTU preconfigured http://www.ttu.ee/FortiClient.exe
* for MS Windows, TalTech preconfigured software [https://taltech.atlassian.net/wiki/spaces/ITI/pages/38994267/Kaug+hendus+FortiClient+VPN+Remote+connection+with+FortiClient+VPN available here], there are also other packages and links for other operating systems
* for MS Windows, [https://portal.itcollege.ee:10443/SslvpnClient.exe IT College client] (requires login beforehand, usually older version than original one from Fortinet)
* [https://forticlient.com/downloads original FortiClient software packages (MS Windows, macOS, GNU/Linux, Android, iOS, Windows Phone, Chromebook)]
* Debian packages
* Debian packages
** FortiClient (deprecated -> use OpenFortiGUI)
** FortiClient (deprecated -> use OpenFortiGUI)
**'''OpenFortiGUI - recommended'''
*** repository https://apt.iteas.at (older: https://styrion.at/apt/)
*** repository https://apt.iteas.at (older: https://styrion.at/apt/)
*** https://hadler.me/linux/forticlient-sslvpn-deb-packages/
*** https://hadler.me/linux/openfortigui/
**'''OpenFortiGUI - recommended'''
*** https://apt.iteas.at Ubuntu 18.04 and newer, Debian Stretch and newer
*** https://hadler.me/linux/openfortigui/ - direct .deb packages
*** Ubuntu 16.04 repository https://styrion.at/apt/ (deprecated repo)


==Usage==
'''NB! About connecting using OpenFortiGUI''':
'''NB! About connecting using OpenFortiGUI''':
* please use SUDO -E parameter in OpenfortiGUI settings! (File→Settings)
* please use SUDO -E parameter in OpenfortiGUI settings! (File→Settings). Might be necessary (not usually) to disable temporarily for certificate retrieval in first time.
* also it might be necessary to turn off the ''Set DNS'' parameter (see [https://github.com/theinvisible/openfortigui/issues/41 this report]). Choose Edit connection and under Options tab uncheck '''Options > Advanced > Set DNS''' so that openfortivpn does not handle DNS or overwrite ''/etc/resolv.conf''. Otherwise after disconnecting is Internet connectivity lost with error message ''Temporary failure in name resolution''.
Also whenever needed, uncheck '''Options > PPPD > PPPD no peerdns''' so that pppd does handle DNS - and hopefully does the right thing.
* on first connection attempt, the certificate must be accepted
* on first connection attempt, the certificate must be accepted
* next connection attempt can be actually connect via VPN
* next connection attempt can be actually connect via VPN
* at file ''/etc/sudoers.d/openfortigui'' there is a line (will be created automatically during OpenFortiGUI setup):
  %sudo  ALL=NOPASSWD:SETENV: /usr/bin/openfortigui --start-vpn *
This means, that all users in group sudo can use it without password with superuser rights. Although running the app is regular (as user in group sudo) without actual sudo command.
* When you got an error ''Peer refused to agree to his IP address'' in log then you need to enable ''ipcp-accept-remote'' (or possibly ''ipcp-accept-local'' - choose one at a time) in /etc/ppp/options - this will work immediately on next connection, no services need restart. More details at [https://github.com/adrienverge/openfortivpn/issues/920 this issue]


==Connecting==
==Connecting==
* use your Uni-ID credentials to login (without ''@ttu.ee'')
[https://taltech.atlassian.net/wiki/spaces/ITI/pages/38994267/Kaug+hendus+FortiClient+VPN+Remote+connection+with+FortiClient+VPN guide]
* Web: https://vpn.ttu.ee:443/
* SSL-VPN
* server: '''vpn.ttu.ee'''
* ''Connection name'' - cannot be empty, use whatever you want to name the connection
* port: 443
* ''Description'' - can be empty, use whatever you want to describe the connection
* ''Remote gateway'' (VPN-server): '''vpn.taltech.ee'''
* ''Customize port'': 443
* ''Authentication'': Save login
* use your [[#Uni-ID|Uni-ID]] credentials to login ('''NB! without ''@taltech.ee''''')
* accept offered certificate
* Web: https://vpn.taltech.ee:443/


'''... in IT College:'''
'''... in IT College:'''
* use your Uni-ID credentials to login (without ''@ttu.ee'')
* use your [[#Uni-ID|Uni-ID]] credentials to login ('''NB! without ''@taltech.ee''''')
* Web: https://portal.itcollege.ee:10443/
* Web: https://portal.itcollege.ee:10443/
* server: '''portal.itcollege.ee'''
* ''Remote gateway'' (VPN-server): '''portal.itcollege.ee'''
* port: 10443
* ''Customize port'': 10443


In IT College there is an option to use SSH tunnel using http://enos.itcollege.ee/ server using your IT College credentials. For convenient usage there is a [[Sshuttle]] (article in Estonian) available. This SSH tunnel is available also for students. MS Windows users [https://www.startpage.com/do/search?q=putty+SSH+tunnel can use puTTY]. Also macOS users [https://www.startpage.com/do/search?q=SSH+tunnel+macOS can use SSH tunnel].
Then you can use remote access:
* [https://mesh.itcollege.ee/ Mesh Central] to switch operating systems remotely
* RDP for remote usage <-- suggested as on screen is nothing then visible
 
In IT College there is an option to use SSH tunnel using http://enos.itcollege.ee/ server using your Uni-ID credentials. For convenient usage there is a [[Sshuttle]] (article in Estonian) available. This SSH tunnel is available also for students. MS Windows users [https://www.startpage.com/do/search?q=putty+SSH+tunnel can use puTTY]. Also macOS users [https://www.startpage.com/do/search?q=SSH+tunnel+macOS can use SSH tunnel].


=OpenVPN=
=OpenVPN=
'''NB! Since July 2021 OpenVPN has been replaced by [[#eduVPN|eduVPN]], which in turn will be since June 30, 2024 replaced by [[#Forticlient_VPN|Forticlient VPN]].'''
Allows to access the TTU library outside university. Additionally you will get a secure VPN connection. [[#Uni-ID|Uni-ID account]] is required.
Allows to access the TTU library outside university. Additionally you will get a secure VPN connection. [[#Uni-ID|Uni-ID account]] is required.
* EST https://confluence.ttu.ee/it-info/kauguehendus-vpn/kauguehendus-toru
* EST https://wiki.ttu.ee/et/juhendid/it/doc/lib_toru
* ENG https://wiki.ttu.ee/en/manuals/it/doc/lib_toru


==Client software==
==Client software==
Line 63: Line 90:
==Installation in Debian/Ubuntu==
==Installation in Debian/Ubuntu==
* open the terminal, e.g. CTRL+ALT+T and copy-paste the following line and press ''Enter''
* open the terminal, e.g. CTRL+ALT+T and copy-paste the following line and press ''Enter''
** copy-paste in terminal: SHIFT+CTRL+C, SHIFT+CTRL+V
copy-paste in terminal: SHIFT+CTRL+C, SHIFT+CTRL+V
* ''sudo apt-get update && sudo apt-get install openvpn openvpn-blacklist && sudo apt-get clean''
sudo apt-get update && sudo apt-get install openvpn
sudo ldconfig && sudo dpkg --configure -a && sudo apt-get clean
You may want to search also ''openvpn-blacklist'' package, but it might be also deprecated and not available.
* for GUI Network Manager:
* for GUI Network Manager:
** ''sudo apt-get update && sudo apt-get install network-manager-openvpn-gnome openvpn-systemd-resolved''<ref>[https://www.cyberciti.biz/faq/linux-import-openvpn-ovpn-file-with-networkmanager-commandline/ Network Manager]</ref>
sudo apt-get update && sudo apt-get install network-manager-openvpn-gnome
sudo ldconfig && sudo dpkg --configure -a && sudo apt-get clean
You may want to search the package ''openvpn-systemd-resolved'' and also install it to integrate OpenVPN with systemd.
<ref>[https://www.cyberciti.biz/faq/linux-import-openvpn-ovpn-file-with-networkmanager-commandline/ Network Manager]</ref>


==Configuration==
==Configuration==
Line 114: Line 146:
=Benefits of TalTech VPN=
=Benefits of TalTech VPN=
* you have a secure tunnel over insecure network, e.g. public WiFi, mobile internet or similar
* you have a secure tunnel over insecure network, e.g. public WiFi, mobile internet or similar
* OpenVPN can be use TTU library and its paid databases outside TalTech:
* OpenVPN can be used for TalTech library and its paid databases outside TalTech:
** EST https://www.taltech.ee/koik-andmebaasid
** EST https://www.taltech.ee/koik-andmebaasid
** ENG https://www.taltech.ee/en/all-databases
** ENG https://www.taltech.ee/en/all-databases


=TTU helpdesk=
=TalTech helpdesk=
* in case of questions, issues - please contact TTU helpdesk
* in case of questions, issues - please contact TalTech helpdesk
** https://wiki.ttu.ee/en:manuals:it:doc:contacts
** https://confluence.ttu.ee/it-info/
** http://it.taltech.ee/ (choose website language if needed)
** https://it.taltech.ee/ (choose website language if needed)
** self-service: http://helpdesk.ttu.ee (to visit self-service you must own [[#Uni-ID|Uni-ID account]])
** self-service: http://helpdesk.taltech.ee/ (to visit self-service you must own [[#Uni-ID|Uni-ID account]])


=References=
=References=
Line 128: Line 160:


[[Category:TalTech]]
[[Category:TalTech]]
[[Category:Vaba_Tarkvara_Teadmuskeskus]]

Latest revision as of 10:19, 6 February 2024

Uni-ID

about Uni-ID (EST/ENG)

Uni-ID is required to use TalTech VPN.

eduVPN

NB!

  • Since June 30, 2024 eduVPN will be closed and replaced with FortiClient VPN
  • Since July 2021 has been old OpenVPN service replaced by eduVPN, used for library.

More information:

Usually generated OpenVPN settings are enough. Still there is a separate eduvpn-client possible to use:

sudo apt install apt-transport-https curl
curl -L https://app.eduvpn.org/linux/deb/eduvpn.key | sudo apt-key add -
echo "deb https://app.eduvpn.org/linux/deb/ stable main" | sudo tee -a /etc/apt/sources.list.d/eduvpn.list
sudo apt update
sudo apt install eduvpn-client
sudo ldconfig && sudo dpkg --configure -a && sudo apt-get clean

For OpenVPN installation, please see here

For smart devices, there are an eduVPN clients available: Android | iOS, that makes connection via TAAT authentication.

Forticlient VPN

Packages

Usage

NB! About connecting using OpenFortiGUI:

  • please use SUDO -E parameter in OpenfortiGUI settings! (File→Settings). Might be necessary (not usually) to disable temporarily for certificate retrieval in first time.
  • also it might be necessary to turn off the Set DNS parameter (see this report). Choose Edit connection and under Options tab uncheck Options > Advanced > Set DNS so that openfortivpn does not handle DNS or overwrite /etc/resolv.conf. Otherwise after disconnecting is Internet connectivity lost with error message Temporary failure in name resolution.

Also whenever needed, uncheck Options > PPPD > PPPD no peerdns so that pppd does handle DNS - and hopefully does the right thing.

  • on first connection attempt, the certificate must be accepted
  • next connection attempt can be actually connect via VPN
  • at file /etc/sudoers.d/openfortigui there is a line (will be created automatically during OpenFortiGUI setup):
 %sudo  ALL=NOPASSWD:SETENV: /usr/bin/openfortigui --start-vpn *

This means, that all users in group sudo can use it without password with superuser rights. Although running the app is regular (as user in group sudo) without actual sudo command.

  • When you got an error Peer refused to agree to his IP address in log then you need to enable ipcp-accept-remote (or possibly ipcp-accept-local - choose one at a time) in /etc/ppp/options - this will work immediately on next connection, no services need restart. More details at this issue

Connecting

guide

  • SSL-VPN
  • Connection name - cannot be empty, use whatever you want to name the connection
  • Description - can be empty, use whatever you want to describe the connection
  • Remote gateway (VPN-server): vpn.taltech.ee
  • Customize port: 443
  • Authentication: Save login
  • use your Uni-ID credentials to login (NB! without @taltech.ee)
  • accept offered certificate
  • Web: https://vpn.taltech.ee:443/

... in IT College:

Then you can use remote access:

  • Mesh Central to switch operating systems remotely
  • RDP for remote usage <-- suggested as on screen is nothing then visible

In IT College there is an option to use SSH tunnel using http://enos.itcollege.ee/ server using your Uni-ID credentials. For convenient usage there is a Sshuttle (article in Estonian) available. This SSH tunnel is available also for students. MS Windows users can use puTTY. Also macOS users can use SSH tunnel.

OpenVPN

NB! Since July 2021 OpenVPN has been replaced by eduVPN, which in turn will be since June 30, 2024 replaced by Forticlient VPN.

Allows to access the TTU library outside university. Additionally you will get a secure VPN connection. Uni-ID account is required.

Client software

Installation in Debian/Ubuntu

  • open the terminal, e.g. CTRL+ALT+T and copy-paste the following line and press Enter

copy-paste in terminal: SHIFT+CTRL+C, SHIFT+CTRL+V

sudo apt-get update && sudo apt-get install openvpn
sudo ldconfig && sudo dpkg --configure -a && sudo apt-get clean

You may want to search also openvpn-blacklist package, but it might be also deprecated and not available.

  • for GUI Network Manager:
sudo apt-get update && sudo apt-get install network-manager-openvpn-gnome
sudo ldconfig && sudo dpkg --configure -a && sudo apt-get clean

You may want to search the package openvpn-systemd-resolved and also install it to integrate OpenVPN with systemd. [1]

Configuration

  • download the preconfigured client.ovpn from https://toru.ttu.ee/
  • use your Uni-ID credentials to login and also later to authenticate in OpenVPN
  • for GNU/Linux in file client.ovpn after setenv PUSH_PEER_INFO please add the following lines and then save the file:

script-security 2
up /etc/openvpn/update-resolv-conf
down /etc/openvpn/update-resolv-conf

Connecting in Debian/Ubuntu

  • use your Uni-ID credentials
  • open the terminal, e.g. using CTRL+ALT+T
  • navigate to folder where the client.ovpn is saved or provide the full path
  • sudo openvpn --config client.ovpn or use more convenient way - the alias created below

Usually there is possible to import *.ovpn files into graphical network manager[2]. In Ubuntu 16.04 LTS cannot be imported current but in Ubuntu 18.04 LTS already can.

Convenient login in GNU/Linux

  • open the terminal, e.g. using CTRL+ALT+T
  • create an alias:
    • nano ~/.bash_aliases #open CLI text editor
    • alias vpn-ttu='sudo openvpn --config /path/client.ovpn' #add appropriate alias and path to client.ovpn, then save the file
  • source ~/.bash_aliases (or reopen terminal or relogin)
  • add permissions to run OpenVPN without entering a password
    • sudo nano /etc/sudoers.d/permissions #the file name permissions could be replaced whatever else you like
    • username ALL=(ALL) NOPASSWD: /usr/sbin/openvpn #replace username with your real one and then save the file
  • type your new alias vpn-ttu in terminal to start a VPN session


in nano text editor

  • save the file:
    • CTRL+O and Enter if you agree the proposed file name (or enter a new one if needed)
    • or F3
  • quit the file:
    • CTRL+X
    • or F2


More information about...

Benefits of TalTech VPN

TalTech helpdesk

References