Le mode de mise à jour de GeoLite2 change en 2020
Les utilisateurs de Matomo qui ont choisi GeoIP 2 comme système de géolocalisation des visiteurs vont devoir changer les réglages qui permettent de faire la mise à jour de la base de donnée GeoLite2.
À compter du 30 décembre 2019, MaxMind qui fournissait gratuitement la base de données GeoLite2 a dû adapter son fonctionnement à la nouvelle réglementation sur la protection des données concernant les entreprises californiennes, le California Consumer Privacy Act (CCPA).
MaxMind détaille les raisons et conséquences du changement dans un article publié sur son blog : Modifications importantes dans l’accès et l’utilisation des bases de données GeoLite2.
Vos systèmes de logs ont probablement enregistré un message d’erreur envoyé par le cron qui actualise Matomo. Voici à quoi il peut ressembler :
ERROR [2020-01-02 16:00:03] 4921 /home/user/example.com/matomo/plugins/GeoIp2/GeoIP2AutoUpdater.php(140): GeoIP2AutoUpdater: failed to download ‘https://geolite.maxmind.com/download/geoip/database/GeoLite2-City.tar.gz’
La question du GeoIP2AutoUpdater est abordée sur le forum de Matomo.
Comment mettre à jour GeoLite2 à partir de 2020 ?
Le téléchargement de GeoLite2 est encore gratuit, mais maintenant il va falloir montrer patte blanche pour récupérer les mises à jour.
Comment obtenir une clé de licence
1ère étape créer un compte (gratuit) chez MaxMind.
Une fois le compte créer, il sera possible de générer une clé de licence.
Il ne vous restera plus qu’à compléter les URLs de téléchargement des mise à jours des base de données avec votre clé de licence.
YOUR_LICENSE_KEY_HERE = la clé fournie par MaxMind.
Base de données de localisation (GeoLite2-City)
https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-City&license_key=YOUR_LICENSE_KEY_HERE&suffix=tar.gz
Base de données ISP (GeoLite2-ASN)
https://download.maxmind.com/app/geoip_download?edition_id=GeoLite2-ASN&license_key=YOUR_LICENSE_KEY_HERE&suffix=tar.gz
Vous trouverez plus d’informations et de détails au sujet de la configuration du téléchargement sur le site de MaxMind.
Configuration de la géolocalisation de Matomo
Il ne vous reste plus qu’à saisir les URLs dans la zone de réglage sur Matomo, dans Administration > Système > Géolocalisation
Puis en bas de la page dans la zone : Configurer les mises à jour automatiques des bases de données GeoIP.
Vous pouvez choisir la mise à jour hebdomadaire ou mensuelle.
Limite de téléchargement
Les quelques étapes sont relativement facile à suivre.
La question reste de savoir, dans le cas où comme moi vous gérer plusieurs sites Matomo pour des clients, s’il faut créer un compte MaxMind pour chaque client, ou si une clé de licence peut être utilisée pour plusieurs téléchargements.
MaxMind précise sur son site, qu’il se réserve le droit de limiter le nombre de téléchargement par intervalle de temps.
MaxMind reserves the right to limit the number of downloads made within a limited period of time.
https://dev.maxmind.com/geoip/geoipupdate/#Direct_Downloads
Pour ma part, j’ai fait le choix d’utiliser une seule clé de licence en limitant le fréquence de mise à jour au mois, plutôt qu’à la semaine.