evoauth/install/INSTALL

Installation d'Evoauth
----------------------

Extrayez l'archive evoauth.tar.gz dans un repertoire temporaire, comme /tmp,
puis executez :

	# make install


Cr<EFBFBD>ation de la base
-------------------

Personnalisez le fichier /usr/local/share/doc/evoauth/install/database.sql
(login SQL, mot de passe, base), puis utilisez le via :
base), puis utilisez le via :

	$ cd /usr/local/share/doc/evoauth
	$ 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;


Apache SSL
----------

Installez php4 et autorisez la fonction system/exec.

Dans le fichier de configuration d'Apache, ajoutez :

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

Puis relancez Apache :

	# apachectl restart


Notes :

* On peut aussi utiliser Apache 2.
* Il est conseill<6C> d'utilliser Apache + SSL.


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)


Configuration syst<73>me
---------------------

- Evoauth est configurable via deux fichiers de configuration :

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


- Il faut <20>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 la somme md5 du mot de passe de l'admin dans le programme
  htdocs/login.php. On g<>n<EFBFBD>rera cette somme via :
	
	$ echo -n PASS | md5sum

- Enfin, initialiser Evoauth gr<67>ce <20> la commande :

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

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<6C> d'initialiser Evoauth, ceci peut
        <20>tre fait par la commande 'perl Evoauth.pl -i'

2 - Q : Une personne de ce bureau s'est d<>connect<63>e, et mon acc<63>s a <20>t<EFBFBD>
		coup<75>. 

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