Skip to content

Simple Bash script that automates the installation, connection and disconnection of the ULL VPN service through IPSec on Linux.

License

Notifications You must be signed in to change notification settings

domenicogoya/ull-vpn-bundle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ull-vpn-bundle

Simple Bash script that automates the installation, connection and disconnection of the ULL VPN service through IPSec on Linux.

Description

The ull-vpn-bundle repository was created by Pablo Domenico Goya Amato ([email protected]) so the users that might experience problems with the VPN service from the University of La Laguna (either with the installation, the connection or the disconnection) can simply run some automated Bash scripts to complete the basic tasks.

Basic introduction

The ULL VPN service can be accessed from Windows, iOS, Linux and Android, but we will be focusing on the Linux version. As we can see in the VPN Client Configuration Options[2] table, we have the following options:

Operative System GlobalProtect IPSec
Windows 10 Yes No
Ubuntu 18.04 & 20.04 No Yes
Android Yes Yes

The method for accessing the VPN through Linux systems that we will be using is the client for Cisco VPN3000 Concentrator, IOS and PIX[2]: vpn, which will be installed with the script. In our case (using Linux), we will be using the IPSec standard for the connection since it is the only one available. So, to define how the IPSec standard works, we have the following definition:

[...] IPSec adds encryption and authentication to make the protocol more secure. For example, IPSec encrypts data at the source and decrypts it at its destination. It also authenticates the origin of the data. [...][3].

Installation

If you ONLY want to install the service, please refer to the only-install folder [Link].

In order to install the VPN service, we will have to execute the install-vpn.sh file with Super User Priviledges (sudo) using the following command (make sure to be inside the cloned folder):

sudo bash install-vpn.sh

It will ask you for your machine password if it is your first time using sudo in that terminal session. After that, press enter and let the installation begin by itself. Once the installation is completed, the user will be asked if storage of the VPN access credentials would be desired. Then, if the user decides to save the credentials, a prompt asking if an immediate VPN connection would be desired will appear. Lastly, the installation and the optional scripts will be executed and the process will end.

If any errors occur, feel free to open a new issue in the Issues section of the repository. Please make sure that there is not another issue similar to yours before creating a new one so all the same problems can be solved at once.

Usage

To establish a connection with the VPN, execute the connect-vpn.sh file with Super User Priviledges (sudo) using the following command (make sure to be inside the cloned folder):

sudo bash connect-vpn.sh

Once this is done, the VPN will be started and the user will be able to access the internal network.

To disconnect the VPN, execute the disconnect-vpn.sh file with Super User Priviledges (sudo) using the following command (make sure to be inside the cloned folder):

sudo bash disconnect-vpn.sh

Once this is done, the VPN will be disconnected.

Disclaimer

All the commands that are inside the scripts and the information given here were extracted from the University of La Laguna VPN Guide (only in Spanish) [1] and some Google pages (see ref. [2]). Therefore, I am not the author of this information and my only goal is to share and make the access to it easier.

Sources

[1] Servicio TIC de la Universidad de La Laguna. (2022). Servicio de Red Privada Virtual. Guía de configuración clientes VPN. (Spanish)
[2] die.net. vpnc(8) - Linux man page. [Link]. (English)
[3] AWS Amazon. ¿Qué es IPsec?. [Link]. (Spanish)
[4] [1]. Page 3.

About

Simple Bash script that automates the installation, connection and disconnection of the ULL VPN service through IPSec on Linux.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages