[Tuto] Installer ratticDB sur Debian

daarksim · 4 août 2016

En cours d'installation de mon nouveau serveur, j'ai dû commencer une migration de mes outils vers mon nouveau serveur.
J'utilisais ratticDB comme gestionnaire de mot de passe et ai eu pas mal de difficulté à le faire remarcher.
Ce tutoriel sera donc un premier tuto sur comment réussir à installer ratticDB.
Dans ce chapitre, je ne traiterais pas du chiffrement de la machine, même si celle-ci est vivement recommandée. Je ne traiterais pas non plus la sécurité (pour ma part, je coupe tout accès y compris ssh en dehors du réseau local).

Place au tutoriel!

Mais avant tout, qu'est-ce que ratticDB ?

RatticDB est un gestionnaire de mot de passe plutôt bien foutu avec des groupes, des partages de mot de passe, la possibilité d'ajouter des clefs ssh et les actions sont loggées.
Si vous voulez en savoir plus, je vous invite à aller sur http://rattic.org/

ATTENTION : le projet RatticDB ne semble pas maintenu, certains fork ont débuté, mais je suis resté sur la version principale de Rattic.

Au niveau de ma configuration, il s'agit d'une machine virtuelle proxmox (en ct) sous Debian 8.
Cette vm est uniquement dédiée à RatticDB pour des raisons de sécurité
Le tutoriel a été réalisé le 04/08/2016

Étape 1 : Mise à jour du serveur et installation des multiples dépendances.

apt-get update && apt-get upgrade
apt-get install apache2 php5 git gcc mysql-server python-setuptools yum gcc openssl libxml2 python-dev libxml2-dev libxslt1-dev zlib1g-dev libldap2-dev python-ldap python-mysqldb gettext apache2 libmysqlclient-dev libsasl2-dev python-dev libldap2-dev libssl-dev nano pyflakes

easy_install pip

dpkg-reconfigure locales

#L'installation de pip par easy install plutôt que par apt-get nous permet d'avoir une version qui gère les différentes dépendances dans le fichier de "requirement"
# je réalise cette étape, car par défaut sur mon ct la locale c.UTF8 n'est pas installée, ce qui peut provoquer des souci lors de configurations et ici au démarrage du script

Étape 2 : récupération du dépôt git et installation des prérequis au lancement

cd /opt
mkdir apps
cd apps
git clone https://github.com/tildaslash/RatticWeb.git
cd RatticWeb/
/usr/local/bin/pip install -r requirements-mysql.txt -r requirements-dev.txt

# Ici, je garde la nommenclature /opt/apps/NomAppli pour 3 raisons :
## Les fichiers de configurations proposés comprennent déjà ce répertoire
## Cela respecte les normes de nommage que j'ai pu utiliser en entreprise
## Lors de ma première installation, ce chemin était encore écrit en dur à certains endroits du code en plus de la configuration, changer ce chemin pouvait provoquer des bugs

Étape 3 : Créer le compte sql et la base et associer les privilèges adéquats.

mysql -u root -p

CREATE DATABASE rattic; 
CREATE DATABASE test_rattic; 
CREATE USER 'rattic'@'localhost' IDENTIFIED BY 'votre_mot_de_passe'; 
GRANT USAGE ON *.* TO 'rattic'@'localhost'; 
GRANT ALL PRIVILEGES ON rattic.* TO 'rattic'@'localhost'; 
GRANT ALL PRIVILEGES ON test_rattic.* TO 'rattic'@'localhost'; 
FLUSH PRIVILEGES; 
exit

# la base de données test_rattic peut servir en cas de lancement de leur outil de test

Étape 4 : Changer la configuration pour qu’elle corresponde au serveur (part 1)

Créez le fichier de configuration spécifique (attention le nom est important)

nano conf/local.cfg

[ratticweb]
debug = False
secretkey = maClefSecrete
hostname = votreHostname.daccess.org

[filepaths]
static = /opt/apps/RatticWeb/static

[database]
engine = django.db.backends.mysql
name = rattic
user = rattic
password = votre_mot_de_passe
host = localhost
port = 3306

Étape 5 : Changer la configuration pour qu’elle corresponde au serveur (part 2)

nano conf/defaults.cfg

timezone = Europe/Paris
passwordexpirydays = 365
hostname = votreHostname.daccess.org

Étape 6 : Initialiser la bdd et les fichiers statiques

 cd /opt/apps/RatticWeb/
./manage.py syncdb --noinput
# en cas d'erreur cf cas d'erreurs connus
./manage.py migrate --all
./manage.py compilemessages
mkdir static
./manage.py collectstatic -c --noinput

erreur courante :
code erreur

Étape 8 : Création d'un compte de démonstration

./manage.py demosetup

# User : admin
# Password : rattic

Étape 9 : Configurer apache pour rediriger le port 80 en https

nano /etc/apache2/sites-available/000-default.conf

NameVirtualHost *:80
<VirtualHost *:80>
   ServerName votreHostname.daccess.org
   ServerAlias votreHostname.daccess.org
   Redirect permanent / https://votreHostname.daccess.org/
#ATTENTION, le / à la fin est très important
</VirtualHost>

Étape 10 : Configurer apache pour rediriger le port 443 vers l’application
#Vous aurez préalablement déposé vos clefs ssh au bon emplacement

nano /etc/apache2/sites-available/default-ssl.conf

<IfModule mod_ssl.c>
        <VirtualHost *:443>
                ServerAdmin webmaster@votreHostname.daccess.org
                DocumentRoot /var/www/html
                SSLEngine on
                SSLCertificateFile      /etc/ssl/certs/2_passwd.votreHostname.daccess.org.crt
                SSLCertificateKeyFile /etc/ssl/private/passwd.key
                <FilesMatch "\.(cgi|shtml|phtml|php)$">
                                SSLOptions +StdEnvVars
                </FilesMatch>
                <Directory /usr/lib/cgi-bin>
                                SSLOptions +StdEnvVars
                </Directory>

                BrowserMatch "MSIE [2-6]" \
                                nokeepalive ssl-unclean-shutdown \
                                downgrade-1.0 force-response-1.0
                # MSIE 7 and newer should be able to use keepalive
                BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown

Alias /robots.txt /opt/apps/RatticWeb/static/robots.txt
Alias /favicon.ico /opt/apps/RatticWeb/static/favicon.ico

AliasMatch ^/([^/]*\.css) /opt/apps/RatticWeb/static/styles/$1

Alias /media/ /opt/apps/RatticWeb/media/
Alias /static/ /opt/apps/RatticWeb/static/

<Directory /opt/apps/RatticWeb/static>
        Require all granted
</Directory>

<Directory /opt/apps/RatticWeb/media>
        Require all granted
</Directory>

WSGIScriptAlias / /opt/apps/RatticWeb/ratticweb/wsgi.py
WSGIPassAuthorization On

WSGIDaemonProcess rattic processes=2 threads=25 home=/opt/apps/RatticWeb/ python-path=/opt/apps/RatticWeb display-name=%{GROUP}
WSGIProcessGroup rattic


<Directory /opt/apps/RatticWeb/ratticweb>
  <Files wsgi.py>
        Require all granted
  </Files>
</Directory>
        </VirtualHost>
</IfModule>

Étape 11 : Installer la bonne version de mod_wsgi

# Si vous installez une version trop ancienne ou une des versions récentes mais ne marchant pas (comme celle des dépôts), vous risquez de bloquer pendant des heures dessus (pas de documentation que de l’expérimentation). Nous installons donc une version spécifique de mod_wsgi

mkdir ~/sources
cd ~/sources
wget https://codeload.github.com/GrahamDumpleton/mod_wsgi/tar.gz/4.5.2
tar xvfz 4.5.2
apt-get install python-dev apache2-prefork-dev
cd mod_wsgi-4.5.2/
./configure make
make install

Étape 12 : Activer les modules, le site et redémarrer apache

a2enmod ssl
a2enmod wsgi
a2enmod rewrite

a2ensite default-ssl
service apache2 restart

Et voilà, vous n'avez plus qu'a accéder à votre site.
Pensez à changer l'administrateur

Cas d'erreurs connus :

SOUTH_MIGRATION_MODULES

cd /usr/local/lib/python2.7/dist-packages 
rm -rf kombu/transport/django/migrations djcelery/migrations
 mv kombu/transport/django/south_migrations kombu/transport/django/migrations 
mv djcelery/south_migrations djcelery/migrations

PS Le tutoriel doit être revu graphiquement. Aussi, même si ce tutoriel est plutôt simple, en raison du manque de réponse aux tickets et de la date de la dernière version, aucun tutoriel sur internet ne fonctionnait, voila pourquoi je me suis permis de proposer le mien ici

PPS : il s'agit ici de mon premier tutoriel que je publie, n'hésitez pas à faire des retours