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

Date de publication : 10/02/2009 , Date de mise à jour : 19/02/2009

Par Jean-Yves Lacour (Site professionnel)
 julp (Autres articles)
 

1. Présentation

• Les informations relatives à la géolocalisation sont transmises sous forme de variable d'environnement au langage serveur employé. Leur récupération n'en est que plus aisée et ceci offre une certaine indépendance : il n'y a ainsi nul besoin d'installer une bibliothèque pour chaque langage que vous pourriez être amené à utiliser sur votre serveur ;
• Apache devient alors capable d'interagir en fonction de la localisation du client. Il peut ainsi directement effectuer un filtrage des clients, les rediriger, ...

2. Mise en place

2.1. A partir des sources

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

  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 :

  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 "villes allégée" wget http://www.maxmind.com/download/geoip/database/GeoLiteCity.dat.gz

  La fiabilité des bases de données mises gratuitement à votre disposition est estimée à 98% pour celle des pays et à 69% en ce qui concerne celle des villes. Avec une perte supplémentaire d'environ 1,5% tous les mois si vous ne téléchargez pas sa nouvelle version paraissant de manière mensuelle.

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 :

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

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

   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 ...

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

   ... puis passez à sa compilation.

   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. A 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).
   
   

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

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

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

2.2. Exemple de Debian Etch pour une installation à partir des paquets binaires prévus

aptitude install libapache2-mod-geoip

a2enmod geoip

/etc/init.d/apache2 force-reload

3. Utilisation

• GEOIP_COUNTRY_CODE : code international du pays (suivant la norme ISO 3166)
• GEOIP_COUNTRY_NAME : nom complet du pays (en anglais)

Si GeoIP est incapable de déterminer la provenance de l'utilisateur, les variables ne seront pas définies.

• GEOIP_REGION : un code indiquant la région (voir les valeurs plus bas ainsi que leur correspondance pour la France)
• GEOIP_CITY : la ville
• GEOIP_DMA_CODE : code DMA (Designated Market Area) attribué à une zone où les fréquences (télévision, radio, etc) sont identiques (concerne les Etats Unis, valeur par défaut : 0)
• GEOIP_AREA_CODE : indice téléphonique représentant une zone précise (concerne les Etats Unis, valeur par défaut : 0)
• GEOIP_LATITUDE : la latitude
• GEOIP_LONGITUDE : la longitude
• GEOIP_POSTAL_CODE : le code postal (concerne uniquement les Etats Unis, ne sera pas définie pour tout autre pays)

3.1. Par l'usage d'un langage de programmation côté serveur

• 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 recourt.

3.1.1. PHP

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

3.1.2. Ruby

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

3.1.3. Perl

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

3.1.4. Autres langages

3.2. Dans le cadre de la configuration du serveur seul

3.2.1. Première application : interdire l'accès à certains utilisateurs étrangers

• En introduisant une variable d'environnement :

  SetEnvIf GEOIP_COUNTRY_CODE ^CN|RU$ FORBIDDEN=1 Deny from env=FORBIDDEN

  Notre variable d'environnement FORBIDDEN ne sera créée que si l'on sait que le client est russe (code pays "RU") ou chinois (de code "CN") d'après le module GeoIP. Le fait que cette variable soit dans ces conditions définie, lui vaudra un blocage (le serveur retournera la page d'erreur 403 au lieu de la page attendue).
  
  
• A l'aide du module de réécriture :

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

  Strictement la même chose, écrite avec des règles de réécriture. En réalité, le module a été quelque peu détourné de son but premier : le tiret fourni en deuxième paramètre de la directive RewriteRule indique qu'il ne faut pas effectuer de réécriture et c'est l'option F (pour forbidden, située entre les crochets, qui va retourner l'erreur 403 pour nos clients identifiés comme russes et chinois.
  
  

3.2.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

4. Epilogue

•  Connaître le pays d'un visiteur en fonction de son adresse IP en PHP

•  Le site de la société MaxMind à l'origine de ce module (entre autres)

5. Remerciements