Branchement entre une application Voo4 et le module de stats

Procédure pour configurer un lien entre une application Voo4 et le module de stats

Edit me

Introduction

L’objectif de cet article est de décrire la procédure pour configurer un lien entre une application Voo4 et le module de stats en faisant attention à l’aspect sécurité.

Pour rappel, la configuration la plus courante est celle-ci :

branchement-stats-voo4

C’est celle qui est décrite dans les étapes ci-dessous.

Une solution alternative

Pour rappel, le widget Stat et le web service de Stats lui-même permette l’utilisation d’un paramêtre use_current_user pour ne pas utiliser de compte de service dans l’application métier pour fournir les données.

Dans ce cas, ce sont les droits de l’utilisateur courant qui sont utilisés.

Etape 1 : Création du compte dans le module de stats

Personne qui le fait : Chef de projet ou développeur

Se connecter au module de stats en production (https://stats.voozanoo.net) avec votre compte administrateur.
Créer un nouveau groupe associé à son application (ex : GLASS pour l’application glass). Ce groupe devra être idéalement un sous-groupe de celui associé à votre team (ex : TEAM2 pour la Team 2).
Créer un utilisateur associé au rôle webservice et au groupe précédemment créé, avec un login différenciant pour l’application (ex : “user4glass” pour l’application Glass)
Communiquer le login/mot de passe au développeur

Note: L’intérêt ici est d’utiliser un compte sur le module de stats qui a les droits les plus limités possibles (groupe et rôle) pour limiter les risques en cas de fuite.

Etape 2 : Mise à jour du fichier application.ini

Personne qui le fait : Le développeur

Récupérer le login/mot de passe créé précédemment par le chef de projet.
Modifier le fichier application.ini de l’application en y ajoutant/complétant la partie ci-dessous

modstat.url = https://stats.voozanoo.net
modstat.login = "xxxxxx"
modstat.password = "xxxxxx"

Important: Pour rappel, les fichiers application.ini contenant des logins et mots de passe ne doivent pas être versionnés.

Etape 3 : Création du compte dans l’application métier

Personne qui le fait : Chef de projet ou développeur

Se connecter au projet de l’application métier Voozanoo 4
Créer un rôle stats limité à la lecture seule sur les varsets réellement utilisés pour générer des statistiques
Créer un compte utilisateur avec le rôle stats dédié à la connexion entre l’application Voo4 et le module de stats (exemple de login pouvant être utilisé : user4stats).

Note: L’intérêt est ici aussi d’utiliser un compte qui a les droits les plus limités possibles (sur l’application métier cette fois) pour limiter les risques en cas de fuite.

Ensuite, suivant les cas, on peut souhaiter :

Créer un export de données avec l’ensemble des données souhaitées pour les stats (ou d’une ressource type dataquery dans le cas d’une utilisation avancée).
Placer un bouton de génération des statistiques sur une page (widget Stat).