Faculty of information technology

User module
The main loop within the routers’ user module is implemented as a finite-state machine
shown in figure
5.2
. Before this loop is started, several actions occur.
∙ Daemonizing activities are performed.
1
docs.python.org/3/c-api
2
www.php-cpp.com
32

---

ExtClientApi
PhpClientApi
PyClientApi
Database
Figure 5.1: Architecture scheme with both API layers.
∙ Syslog is initialized.)
Also, a self-signed certificate and key are generated with the use of OpenSSL binary.
This is, however, done only once, as it is placed within the module’s installation script.
From the all states shown in figure
5.2
, the most time is usually spent inside the s_listening
state. This is where all incoming messages are handled. Function select() with a timeout is
used there, so that when there are no messages for a long period of time, a piece of a code
that checks the state of OpenVPN tunnel can be run. Those checks are currently done by
scanning log messages of the OpenVPN daemon. If, for example, CS migrates to a new
address, the user module is able to eventually arrive back into s_getting_cs_ip state and
obtain the new IP address from the Dispatch Server.
s_gettings_cs_
ip
failure
s_checking_
ovpn_details
s_getting_ovpn_
approval
failure
s_getting_ovpn_
credentials
s_restarting_
ovpn
s_creating_
managing_
socket
s_stop
s_tunnel_
recovery
success
failure
fail_count > x
success
success
success
failure during 
handshake
failure
s_listening
success
success
tunnel is
down
cs is up, but doesn't 
consider us validated
cs is down / 
cs is up and 
considers
us validated
tunnel is
up
other side 
not responding
s_stop
Figure 5.2: FSM representation of the router’s main loop..
33

---

Web UI
As a method of configuring the router module (user needs to fill in the address of the
Dispatch Server), simple web pages were created for routers. It was done through the use
of cgi scripts, since that is the standard way of creating web UI for user modules. There
are 3 different pages:
∙ Page with the logs of the user module,
∙ Page with the logs of the OpenVPN,
∙ Configuration page (can be seen in figure
5.3
).
Figure 5.3: User interface for the router module.