LimeSurvey

Présentation

LimeSurvey is a web survey software written in PHP. LimeSurvey dispose d'un mode d'authentification par serveur web qui permet de l'integrer directement dans LemonLDAP::NG.

To have a stronger integration, we will configure LimeSurvey to autocreate unknown users and use HTTP headers to fill name, mail and roles. Par exemple, en utilisant 3 rôles :

Configuration

On suppose que LimeSurvey est installé dans /var/www/html/limesurvey

Configuration de LimeSurvey

La configuration est effectuée via config.php:

vi /var/www/html/limesurvey/config.php
//==================================
// WebSSO
//==================================
 
$useWebserverAuth = true;
$WebserverAuth_autocreateUser = true;
$WebserverAuth_autouserprofile = Array(
 'full_name' => $_SERVER['HTTP_AUTH_CN'],
 'email' => $_SERVER['HTTP_AUTH_MAIL'],
 'lang' => 'en',
 'htmleditormode' => 'inline',
 'templatelist' => 'default,basic,MyOrgTemplate',
 'create_survey' => $_SERVER['HTTP_AUTH_ADMIN'] || $_SERVER['HTTP_AUTH_SUPERADMIN'],
 'create_user' =>  $_SERVER['HTTP_AUTH_SUPERADMIN'],
 'delete_user' =>  $_SERVER['HTTP_AUTH_SUPERADMIN'],
 'superadmin' => $_SERVER['HTTP_AUTH_SUPERADMIN'],
 'configurator' =>  $_SERVER['HTTP_AUTH_SUPERADMIN'],
 'manage_template' =>  $_SERVER['HTTP_AUTH_SUPERADMIN'],
 'manage_label' =>  $_SERVER['HTTP_AUTH_SUPERADMIN']
);

We directly use HTTP headers to fill default user profile.

Hôte virtuel LimeSurvey dans Apache

Configurer l'hôte virtuel LimeSurvey comme n'importe quel autre hôte virtuel protégé.

<VirtualHost *:80>
       ServerName limesurvey.example.com
 
       PerlHeaderParserHandler Lemonldap::NG::Handler
 
      SetEnvIfNoCase Auth-User "(.*)" PHP_AUTH_USER=$1
 
      Alias /limesurvey /var/www/html/limesurvey
      DocumentRoot /var/www/html/limesurvey
 
</VirtualHost>

You need to set the PHP_AUTH_USER variable to have the Webserver authentication mode working.

Hôte virtuel LimeSurvey dans le manager

Aller dans le manager et créer un nouvel hôte virtuel pour LimeSurvey.

En-têtes

Nom d'en-tête Description
Auth-User nom de connexion
Auth-Cn Nom complet de l'utilisateur
Auth-Mail Email de l'utilisateur
Auth-Admin 1 si l'utilisateur est administrateur
Auth-SuperAdmin 1 si l'utilisateur est super-administrateur

On peut gérer les rôles avec le modèle RBAC ou en utilisant les groupes.

Règles

Nom de la règle Expression Description
Déconnexion action=logout$ Règle de déconnexion (par exemple logout_app_sso)
Admin ^/limesurvey/admin/ Autorisé seulement pour les rôles admin et superadmin
Défaut default Autorise seulement les utilisateurs avec un rôle LimeSurvey

Il est possible de mettre l'accès par défaut à :

  • accept : tous les utilisateurs authentifiés peuvent accéder aux surveillances
  • unprotect : aucune authentification n'est nécessaire pour accéder aux surveillances