Intégrer la géolocalisation à Apache 2 sous Linux

Il est nécessaire de télécharger trois choses avant de commencer :

• la bibliothèque C, dépendance requise au module que nous compilerons dans un deuxième temps :

   

  Sélectionnez

  cd ~
  wget http://www.maxmind.com/download/geoip/api/c/GeoIP-1.4.5.tar.gz

  Vérifier éventuellement qu'il n'existe pas de versions plus récentes que ce soit maintenant pour la bibliothèque C comme pour les sources du module que nous abordons ci-dessous.

• les sources du module propres aux versions de la branche 2 d'Apache :

   

  Sélectionnez

  wget http://www.maxmind.com/download/geoip/api/mod_geoip2/mod_geoip2_1.2.5.tar.gz

• enfin, télécharger une base de données mise à disposition gratuitement (donc plus limitée). Il en existe deux : celle de base dont vous ne pourrez tirer que le pays du client et une seconde fournissant des informations plus précises puisque capable de vous donner la ville et la région de l'internaute.

# La base "pays" uniquement
wget http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz
 
# La base "allégée des villes"
wget http://www.maxmind.com/download/geoip/database/GeoLiteCity.dat.gz

Procédons à leur installation :

1. Comme mentionné plus haut, un certain ordre doit être respecté : il faut commencer par l'API C de GeoIP puisque le module repose sur celle-ci.
   Décompressez l'archive :

    

   Sélectionnez

   tar xzf GeoIP-1.4.5.tar.gz -C /usr/local/src

   Puis procédez à la compilation et installation (requérant les droits administrateur) :

    

   Sélectionnez

   cd /usr/local/src/GeoIP-1.4.5/
   ./configure --prefix=/usr/local/geoip
   make
   make install

   Pour compiler cette bibliothèque, vous devrez posséder sur votre système les fichiers d'entête de la bibliothèque zlib. Si ce n'est pas le cas, cherchez un paquet éponyme suffixé de dev ou devel puis installez-le.

2. Vient ensuite le tour du module Apache. Détarez les sources de celui-ci…

    

   Sélectionnez

   tar xzf ~/mod_geoip2_1.2.5.tar.gz -C /usr/local/src

   … puis passez à sa compilation.

    

   Sélectionnez

   cd /usr/local/src/mod_geoip2_1.2.5/
   apxs2 -i -a -L/usr/local/geoip/lib -I/usr/local/geoip/include -lGeoIP -c mod_geoip.c

   Pour cette étape, il vous sera nécessaire de posséder les fichiers d'entête d'Apache. Ceux qui ont donc installé leur serveur sous forme de paquet binaire auront sans doute à chercher un paquet nommé sur le modèle apache2(-threaded|mpm)-dev(el) ou encore httpd-dev(el).

   Suivant votre système, la commande apxs2 pourra être plus simplement appelée apxs.

   La commande apxs2, telle qu'elle a été utilisée ci-dessus suppose que le répertoire où elle est située figure comme valeur de la variable d'environnement PATH. À défaut, il est possible d'en préciser son chemin.

3. Décompressez la base que vous avez récupérée plus tôt à l'aide de gunzip :

gunzip GeoIP.dat.gz
# ou suivant la base choisie
gunzip GeoLiteCity.dat.gz

Pour la déplacer vers un répertoire plus « approprié » :

cp ~/GeoIP.dat /usr/local/geoip/share/GeoIP/
# ou suivant la base choisie
cp ~/GeoLiteCity.dat /usr/local/geoip/share/GeoIP/

Pour la suite, assurez-vous que cette base est accessible en lecture de tous (surtout de l'utilisateur sous lequel fonctionne Apache).

Nous pouvons maintenant passer à la configuration d'Apache. Vérifiez tout d'abord la présence d'une ligne LoadModule ressemblant à celle ci-dessous (chemin à adapter) qui chargera notre nouveau module :

LoadModule geoip_module /usr/lib/apache2/modules/mod_geoip.so

Rajoutez-la à la suite des autres si elle se fait porter absente. Gardez le fichier ouvert en vue de placer une ligne LoadFile avant la précédente, nécessaire au bon fonctionnement du module, afin qu'Apache puisse auparavant charger la librairie geoip de laquelle dépend le module :

LoadFile /usr/local/geoip/lib/libGeoIP.so

Puis activez et configurez à présent notre module par la mention des lignes suivantes :

<IfModule mod_geoip.c>
    GeoIPEnable On
    GeoIPDBFile /usr/local/geoip/share/GeoIP/GeoIP.dat # ou /usr/local/geoip/share/GeoIP/GeoLiteCity.dat
</IfModule>

À ce stade vous devriez relancer le serveur et vérifier le bon fonctionnement du tout en poursuivant directement à la partie intitulée.

Dans la mesure où votre système prévoit des paquets pour le module GeoIP, vous avez tout intérêt à les privilégier : son installation n'en sera que plus rapide et plus facile.

Dans le cas de Debian, cela peut se résumer à la commande suivante :

aptitude install libapache2-mod-geoip

Debian vous installera uniquement la base de données « pays ». Si vous prévoyez d'en utiliser une autre ou une version plus à jour, il vous faudra éventuellement décommenter la directive GeoIPDBFile du fichier /etc/apache2/mods-available/geoip.conf en retirant le caractère dièse (#) apparaissant en début de ligne et en modifier la valeur pour pointer sur la vôtre.

Normalement le module devrait être actif par défaut à l'issue de son installation. Assurez-vous-en, en contrôlant la présence des liens symboliques geoip.conf et geoip.load dans le répertoire /etc/apache2/mods-enabled ou exécutez la commande a2enmod, qui le fera pour vous dans le cas contraire :

a2enmod geoip

Enfin, (re)démarrer le serveur web :

/etc/init.d/apache2 force-reload

La récupération des différentes « variables » créées par le module de géolocalisation dépend de la manière dont ce dernier a été configuré. En effet, suivant la valeur de sa directive GeoIPOutput, elles ne seront pas accessibles de la même manière.

• Lorsque GeoIPOutput a pour valeur Notes, les variables relatives à la géolocalisation du client ne sont créées que dans la table interne d'Apache appelée Notes. Ce n'est pas, de ce fait, la méthode la plus facile pour ensuite les atteindre avec un langage serveur.
• En revanche, avec la valeur Env, toutes ces variables sont exportées à la manière des variables d'environnement système. Cette forme facilite fortement leur usage, quel que soit le langage employé côté serveur, comme nous le verrons ci-dessous.
• Enfin, la valeur All (par défaut) est à recommander puisque toutes ces variables seront définies deux fois, selon les méthodes des deux points précédents. Ainsi il n'y a plus lieu de se demander par quel moyen y avoir recours.

III-A-1. PHP▲

foreach ($_SERVER as $k => $v) {
    if (stripos($k, 'GEOIP') !== FALSE) {
        printf('%s : %s<br />', $k, $v);
    }
}

III-A-2. Ruby▲

ENV.each do |k,v|
    puts "#{k} => #{v}" if k ~= /GEOIP/i
end

III-A-3. Perl▲

foreach (keys(%ENV)) {
    print "$_ => $ENV{$_}$/" if $_ =~ /GEOIP/i;
}

III-A-4. Autres langages▲

III-B-1. Première application : interdire l'accès à certains utilisateurs étrangers▲

RewriteEngine on
RewriteCond %{ENV:GEOIP_COUNTRY_CODE} ^CN|RU$
RewriteRule .* - [F]

III-B-2. Deuxième application : redirection suivant le lieu de connexion▲

si GEOIP_REGION = "A5" et page_courante = "/index.html" et non cookie_defini("local")
    alors
        créer_cookie("local", "1", ".corse.fr", 60, "/")
        /**
         * Paramètres :
         * - nom du cookie
         * - sa valeur
         * - le nom de domaine auquel il est associé
         * - durée en minutes avant expiration
         * - le chemin sur lequel il s'applique
         **/
        redirection("/vie-pratique.html")
fsi

RewriteEngine on
 
RewriteCond %{ENV:GEOIP_REGION} =A5                                            # Règle n°1
RewriteCond %{HTTP_COOKIE} !\blocal\b                                          # Règle n°2
RewriteRule ^(:?index.html)?$ /vie-pratique.html [L,CO=local:1:.corse.fr:60:/] # Règle n°3