evoauth/install/INSTALL

INSTALLATION D'EVOAUTH
----------------------


1 - Installation du logiciel
----------------------------

Vous devez posséder l'archive evoauth.tar.gz; choisissez un répertoire
temporaire, comme /tmp, et exécutez :

	# cd /tmp
	# tar xvzf evoauth.tar.gz
	# cd evoauth
	# make install

Evoauth est à présent installé sur votre système. Passon à la
configuration :

  * /etc/evoauth/evoauth.conf pour la partie administration
  * /var/www/htdocs/evoauth/includes/config.php pour la partie web


Il faut également installer sudo et mettre les lignes suivantes dans le 
fichier sudoers (par exemple via la commande `vipw`) : 

	User_Alias WWW = www-data
	Cmnd_Alias EVOAUTH = /usr/local/share/evoauth/Evoauth.pl
	WWW ALL= NOPASSWD: EVOAUTH

Changez par sécurité la somme md5 du mot de passe de 'admin' dans
/home/aanriot/cvs/evoauth/htdocs/includes/config.php :
	
	$ echo -n PASS | md5sum


2 - Base de données Mysql
-------------------------

Installez la base de données Mysql (mysql-common, mysql-client).

Personnalisez le fichier /usr/local/share/doc/evoauth/install/database.sql
(spécifiez le login à utiliser, le mot de passe, la base), puis utilisez
le via : 

	$ cd /usr/local/share/doc/evoauth/install
	$ mysql -u <mysqladmin> -p < database.sql
	$ mysql -u <mysqladmin> -p

mysql> use mysql;
mysql> GRANT ALL PRIVILEGES ON *.* TO 'evoauth_user'@'192.168.4.1' \
	IDENTIFIED BY 'test' WITH GRANT OPTION;
mysql> GRANT ALL PRIVILEGES ON *.* TO 'evoauth_user'@'192.168.4.86' \
	IDENTIFIED BY 'test' WITH GRANT OPTION;
mysql> GRANT ALL PRIVILEGES ON *.* TO 'evoauth_user'@'192.168.4.123' \
	IDENTIFIED BY 'test' WITH GRANT OPTION;


3 - Serveur web Apache
----------------------

Installez Apache (Evoauth a été développé avec Apache 1.29),
l'utilisation de SSL (HTTPS) est conseillée.

Dans le fichier de configuration d'Apache (/etc/apache/httpd.conf),
ajoutez :

	Include /usr/local/share/doc/evoauth/install/http-evoauth.conf

Puis relancez Apache :

	# apachectl restart


4 - Installation des modules Perl nécessaires
---------------------------------------------

Vous devez installer les modules suivants :

- DBD Mysql (libdbd-mysql)

- DBD::Mysql (libdbd-mysql-perl)
- DBI (libdbi-perl)
- MIME::Lite (libmime-lite-perl)
- Config::Tiny (libconfig-tiny-perl)


5 - Installation des composants PHP nécessaires
------------------------------------------------

Vous devez installer les composants suivants :

- php4

En prévision pour la version 0.9 :

- php4-pear
- le module pear PEAR::Config.

6 - Lancement
-------------

Enfin, initialiser Evoauth grâce à la commande :

	# perl /usr/local/share/evoauth/Evoauth.pl -i

Si vous devez l'arrêter :

	# perl /usr/local/share/evoauth/Evoauth.pl -s

Si vous voulez juste le redémarrer :

	# perl /usr/local/share/evoauth/Evoauth.pl -r


FAQ
---

1 - Q : J'obtiens une erreur de type :
		iptables: Bad rule (does a matching rule exist in that chain?)
	
    R : Vous avez probablement oublié d'initialiser Evoauth, ceci peut
        être fait par la commande 'perl Evoauth.pl -i'

2 - Q : Une personne de ce bureau s'est déconnectée, et mon accès a été
		coupé. 

    R : Ce mécanisme est basé sur le firewall Iptables, et fonctionne,
		même si les adresses MAC seront à terme gérées, par des adresses
		IP. A cause du mécanisne de NAT, toutes les personnes connectées
		via une même IP seront affectées par une décision.