Dans ce tutoriel je vais vous montrer étape par étape comment déployer le serveur de développement de Helios en utilisant Django.

Pour mon installation, j’utilise Ubuntu Server 18.04. Ces instructions peuvent fonctionner sur une autre version avec quelques modifications, mais le tutoriel va se contenter de donner les instructions pour Ubuntu Server 18.04.

L’utilisateur Ubuntu que j’utilises pour toute la suite est nommé helios, le nom de l’utilisateur est important pour PostgreSQL, car un utilisateur accède à une base de données de même nom.

Installation et configuration de PostgreSQL

On va donc commencer par installer PostgreSQL et PostgreSQL-contrib avec les commandes suivantes :

sudo apt update

sudo apt install postgresql postgresql-contrib

Ensuite, il faut créer le rôle correspondant a notre utilisateur et qui aura le même nom que la base de données :

sudo -u postgres createuser –interactive

A partir de là on doit rentrer le nom du rôle qu’on veut rajouter, et le définir en tant que super user :

On crée la base de données avec toujours le même nom :

sudo -u postgres createdb helios

On peut maintenant accéder à la console Postgres de notre base de données pour vérifier que ça fonctionne :

psql

Pour quitter la console Postgres il suffit d’exécuter \q, notre base de données fonctionne bien.

On va revenir dans la console Postgres pour définir un mot de passe pour notre rôle postgresql, on en aura besoin pour la configuration de Django :

psql

ALTER USER helios WITH PASSWORD ‘motdepasse’ ; (remplacez motdepasse par le mot de passe de votre choix et n'oubliez pas le ";" à la fin de la commande)

On peut maintenant quitter la console Postgres ;

\q

Pour régler des erreurs d’authentification a notre base de données il faut modifier le fichier pg_hba.conf de PostgreSQL, il faut donc naviguer jusqu’au répertoire et modifier le fichier comme suit :

sudo nano /etc/postgresql/10/pg_hba.conf

On rajoute la ligne « local all helios md5 » comme ci-dessus au-dessus de « local all postgres peer »

Récupération du git et installation de dépendances pour le projet

Il faut ensuite installer build-essential et python-pip :

sudo apt-get install build-essential

sudo apt-get install python-pip

Il faut maintenant cloner le répertoire GitHub de helios-server et installer virtualenv avec pip :

git clone https://github.com/benadida/helios-server

pip install virtualenv

Je vous conseille de recharger la console Ubuntu, car il se peut que l’installation de virtualenv ne soit pas utilisable sans avoir fait ça au préalable.

On doit maintenant rentrer dans le répertoire ou helios a été téléchargé, créer un nouvel environnement virtuel et l’activer :

Cd helios-server

Virtualenv venv (vous pouvez remplacer venv par le nom de votre choix, ça n’a pas vraiment d’importance ici)

Source venv/bin/activate

On continue en installant toutes les dépendances qui sont dans le fichier requirements.txt avec la commande suivante :

Pip install -r requirements.txt

Paramétrage de Django

On modifie les paramètres de Django pour pouvoir se connecter à la base de données qu’on a configure plus tôt :

Sudo nano settings.py

Il faut donc mettre les paramètres suivants à la place de ce qu’il y a déjà dans le fichier settings.py

DATABASES = {

'default': {

'ENGINE': 'django.db.backends.postgresql_psycopg2',

'NAME': 'helios',

'USER': 'helios',

'HOST': 'localhost',

'PASSWORD': 'motdepasse'

}}

En remplacant ‘motdepasse’ par le mot de passe choisi pour le role helios qu’on a défini plus tôt.

Maintenant on peut vérifier que notre configuration a été faite correctement en exécutant la commande suivante :

./reset.sh

Il faut rajouter l’adresse IP de notre machine si le serveur ne tourne pas en local.

Sudo nano settings.py

Et rajouter l’adresse IP dans le paramètre ALLOWED_HOSTS, à la suite de localhost avec une virgule séparant les deux : ALLOWED_HOSTS=get_from_env(‘ALLOWED_HOSTS’, ‘localhost, 1.2.3.4’).split(‘,’)

On peut maintenant tester le serveur de développement en exécutant, dans deux consoles différentes :

Python manage.py runserver 0.0.0.0 :8000 (qui nous donne notre serveur django au port 8000)

et

Python manage.py celeryd (qui permet d’effectuer certaines tâches qui se répètent souvent, tel que l’envoi de mails, l’enregistrement des votes, la gestion des fichiers des électeurs etc.)

En se connectant à l’adresse IP de notre serveur ou localhost au port 8000 si c’est sur l’ordinateur local, on voit notre page d’accueil helios, qui va nous permettre de gérer les élections. Mais pour l’instant nous ne pouvons pas faire grand-chose, il va falloir d’abord modifier certains paramètres.

Tout d’abord, pour pouvoir utiliser des modules d’authentification tels que OAUTH 2.0 de Google ou Facebook login il faut forcement avoir un nom de domaine, car en effet, ils n’autorisent pas les adresses IP publiques. Il vous faut donc un nom de domaine pour la suite de ce tutoriel et d’avoir rajoute celui-ci au préalable dans ALLOWED_HOSTS comme l’exemple ci-dessus. Si vous n’avez pas de nom de domaine, vous pouvez gratuitement enregistrer un nom de domaine en .tk sur freenom.com.

Mise en place de l’authentification Google

Je vais donc continuer le tutoriel en vous montrant comment mettre en place l’authentification Google.

Il faut commencer par créer une nouvelle application web sur Google pour pouvoir utiliser l’API d’authentification en y indiquant notre nom domaine. On crée ensuite de nouveaux credentials Google Auth pour notre application en y inscrivant l’uri javascript d’origine pour l’authentification, qui est donc notre page principale soit dvicheliostest.tk :8000 dans mon cas, et l’URI de redirection à la suite de l’authentification ou il suffit de rajouter /auth/after a la fin du lien utilise ci-dessus.

On récupère ensuite l’ID Client et le secret client donnes par Google, pour les mettre dans les paramètres GOOGLE_CLIENT_ID et GOOGLE_CLIENT_SECRET de settings.py.

Il faut maintenant changer le paramètre URL_HOST en y mettant son nom de domaine, ainsi que SECURE_URL_HOST pour avoir le serveur en http et les liens de votes en SSL.

Il ne reste plus qu’a paramétrer le serveur mail pour pouvoir envoyer les mails automatiques aux électeurs. J’ai décidé d’utiliser le serveur SMTP Gmail, mais on peut aussi utiliser son propre serveur SMTP ne pas dépendre d’autres services.

Toujours dans settings.py, il faut modifier les paramètres suivants :

Les paramètres présents ci-dessus permettent d’utiliser le serveur Gmail, en y mettant bien sur son propre mot de passe et adresse mail.

Il ne reste plus qu’a lancer le serveur et celeryd avec les commandes suivantes :

Python manage.py runserver 0.0.0.0

Python manage.py celeryd

Et voilà, le serveur de développement est fonctionnel et on peut utiliser le site pour organiser des élections, envoyer des mails aux électeurs, calculer les résultats des élections etc.

Pour un serveur de production, il y a plusieurs options possibles mais en tout cas il est important de passer par un serveur web tel qu’Apache en utilisant une architecture LAPP ou LINUX APACHE PostgreSQL Python par exemple.

How to deploy an online voting system ?