ProFTPD MySQL et quotas

ProFTPD, MySQL et Quota

ProFTPD, MySQL et Quota

par Space2d

Exemple d'utilisation du support MySQL pour ProFTPD avec gestion des quotas

Prérequis

Je vous conseille de lire d'abord le didactitiel de DuF : Introduction à proftpd

Il vous faut un système avec un serveur MySQL installé avec si possible un serveur web et PHPMyAdmin pour faciliter l'administration de la BD.

Remarque : ce document peut aussi convenir à la configuration du support PostGreSQL.

Introduction

Au début, j'utilisais le serveur ProFTPD avec la configuration d'origine (ou presque), donc sur la base de l'authentification unix. J'ai eu besoin de modifier regulièrement les comptes FTP. Ajouter et supprimer les utlisateurs (compte linux) devient vite lourd. Je me suis donc penché sur le support MySQL de ProFTPD et je vous propose mes explications.

Le fait d'utiliser l'authentification de ProFTPD par base de données vous permet, par exemple, de faire une page php de configuration ou d'administrer facilement vos comptes ftp via l'interface Web PHPMyAdmin.

Installation

• Soit vous installez ProFTPD à partir de package. (Soyez sur que le package va installer le support MySQL)
• Soit à partir des sources.

Sous Debian (apt)

Il suffit de taper en tant que root :

#apt-get install proftpd-mysql

A partir des sources

Téléchargez les sources en allant sur le site de proftpd pour obtenir la version la plus récente.

Décompressez-les et lancez la compilation :

tar jxvf proftpd-version.tar.bz2
cd proftpd-version
./configure\
--with-modules=mod_sql:mod_sql_mysql:mod_quotatab:mod_quotatab_sql\
--with-includes=/usr/include/mysql\
--with-libraries=/usr/lib
make

Et en tant que root : make install

Configuration

Linux

Créer un groupe ftpgroup avec un GID de 5500 :

groupadd -g 5500 ftpgroup

Explications :

• groupadd : invoque la commande d'ajout de groupe.
• -g 5500 : défini le GID (numéro identifiant) du groupe.
• ftpgroup : défini le nom du group.

Créer un utilisateur ftpuser avec un UID de 5500 :

useradd -u 5500 -s /bin/false -d /bin/null -c "proftpd user" -g ftpgroup ftpuser

Explications :

• useradd : invoque la commande d'ajout d'utilisateur.
• -u 5500 : défini l'UID (numéro identifiant) de l'utilisateur.
• -s /bin/false : défini le shell utilisé pour cet utilisateur, en l'occurence, aucun puisque la connection sur une console linux est désactivée pour cet utilisateur.
• -d /bin/null : défini le répertoire de l'utilisateur, également inexistant.
• -c "proftp user" : commentaire.
• -g ftpgroup : ajoute l'utilisateur ftpuser au group ftpgroup précédemment créé.
• ftpuser : défini le nom de l'utilisateur.

Le groupe et l'utilisateur ainsi créés serviront de lien entre les utilisateurs créés dans la base MySQL et le système d'authentification/droits du système.

La base de données

Entrez dans l'interface de la base de données :

• si vous n'avez jamais modifié les utilisateurs de la base : mysql -u root
• sinon (avec un utilisateur/pwd ayant le droit de modifier la base): mysql -u utilisateur -p

Il faut tout d'abord créer la base de données (ex : proftpd) et les tables qu'elle contient.

CREATE DATABASE `proftpd`;
USE proftpd;

--
-- Table structure for table `ftpgroup`
--
CREATE TABLE `ftpgroup` (
`groupname` varchar(16) NOT NULL default '',
`gid` smallint(6) NOT NULL default '5500',
`members` varchar(16) NOT NULL default '',
KEY `groupname` (`groupname`)
) TYPE=MyISAM COMMENT='Table des groupes ProFTPD';

--
-- Table structure for table `ftpquotalimits`
--
CREATE TABLE `ftpquotalimits` (
`name` varchar(30) default NULL,
`quota_type` enum('user','group','class','all') NOT NULL default 'user',
`par_session` enum('false','true') NOT NULL default 'false',
`limit_type` enum('soft','hard') NOT NULL default 'soft',
`bytes_up_limit` float NOT NULL default '0',
`bytes_down_limit` float NOT NULL default '0',
`bytes_transfer_limit` float NOT NULL default '0',
`files_up_limit` int(10) unsigned NOT NULL default '0',
`files_down_limit` int(10) unsigned NOT NULL default '0',
`files_transfer_limit` int(10) unsigned NOT NULL default '0'
) TYPE=MyISAM COMMENT='Table des quotas ProFTPD';

--
-- Table structure for table `ftpquotatotal`
--
CREATE TABLE `ftpquotatotal` (
`name` varchar(30) NOT NULL default '',
`quota_type` enum('user','group','class','all') NOT NULL default 'user',
`bytes_up_total` float NOT NULL default '0',
`bytes_down_total` float NOT NULL default '0',
`bytes_transfer_total` float NOT NULL default '0',
`files_up_total` int(10) unsigned NOT NULL default '0',
`files_down_total` int(10) unsigned NOT NULL default '0',
`files_transfer_total` int(10) unsigned NOT NULL default '0'
) TYPE=MyISAM COMMENT='Table des compteurs des quotas ProFTPD';

--
-- Table structure for table `ftpuser`
--
CREATE TABLE `ftpuser` (
`id` int(10) unsigned NOT NULL auto_increment,
`userid` varchar(32) NOT NULL default '',
`passwd` varchar(32) NOT NULL default '',
`uid` smallint(6) NOT NULL default '5500',
`gid` smallint(6) NOT NULL default '5500',
`homedir` varchar(255) NOT NULL default '',
`shell` varchar(16) NOT NULL default '/bin/false',
`count` int(11) NOT NULL default '0',
`accessed` datetime NOT NULL default '0000-00-00 00:00:00',
`modified` datetime NOT NULL default '0000-00-00 00:00:00',
`LoginAllowed` enum('true','false') NOT NULL default 'true',
PRIMARY KEY (`id`)
) TYPE=MyISAM COMMENT='Table des utlisateurs ProFTPD';

Ensuite il faut créer un nouvel utilisateur (ex : proftpd) avec un mot de passe (ex : password) qui a seulement les droits de lire les données de la base proftpd:

GRANT USAGE ON proftpd.localhost TO proftpd@'localhost'
IDENTIFIED BY password WITH GRANT OPTION;

Attention : Si votre serveur MySQL n'est pas sur la même machine que ProFTPD remplacez localhost par le nom de la machine (du serveur MySQL) ou par *

Configuration de ProFTPD

Editez le fichier /etc/proftpd.conf ou /usr/local/etc/proftpd.conf.

# Configuration de base
# =====================
ServerName "Mon serveur FTP"
ServerType standalone
ServerIdent on "Bienvenue sur mon ftp. Veuillez-vous identifiez"
DeferWelcome on
ServerAdmin "ftp_admin@mydomain.com"

MultilineRFC2228 on
DefaultServer on
ShowSymlinks on
AllowOverwrite on

TimeoutNoTransfer 600
TimeoutStalled 600
TimeoutIdle 1200

ListOptions "-l"
Defaultroot ~

DenyFilter \*.*/

Port 21

# A configurer selon sa connection
# ================================
MaxInstances 6
MaxLoginAttempts 3
MaxClientsPerUser 10
MaxClientsPerHost 2
MaxHostsPerUser 4
MaxClients 6 "Limite a 6 utilisateurs"

# ProFTPD est exécuté avec des droits réduits
# ============================================
User nobody
Group nogroup

Umask 022
AllowStoreRestart on
AllowRetrieveRestart on

# Mod MySQL
# =========
# Les mots de passe sont cryptés dans la base avec la fct ENCRYPT (MySQL)
SQLAuthTypes Plaintext Crypt
SQLAuthenticate users* groups*

# Modifiez cette ligne selon l'utilisateur et le mot de passe définit plus tôt
SQLConnectInfo proftpd@localhost proftpd password

# On donne à ProFTPD le nom des colonnes de la table usertable
SQLUserInfo ftpuser userid passwd uid gid homedir shell
SQLUserWhereClause "LoginAllowed = 'true'"

# On donne à ProFTPD le nom des colonnes de la table "grouptable"
SQLGroupInfo ftpgroup groupname gid members

# Créer le repertoire home de l'utilisateur si il n'existe pas
SQLHomedirOnDemand on

# Met à jour les compteurs à chaque connection d'un utilisateur
SQLLog PASS updatecount
SQLNamedQuery updatecount UPDATE "count=count+1, accessed=now() WHERE userid='%u'" ftpuser

#Met à jour les compteurs à chaque upload ou download d'un utilisateur
SQLLog STOR,DELE modified
SQLNamedQuery modified UPDATE "modified=now() WHERE userid='%u'" ftpuser

# Mod quota
# =========
QuotaEngine on
QuotaDirectoryTally on
QuotaDisplayUnits Mb
QuotaShowQuotas on

# Définit les requêtes SQL pour que ProFTPd recupere les infos sur les quotas

SQLNamedQuery get-quota-limit SELECT "name, quota_type, par_session, limit_type, bytes_up_limit, bytes_down_limit, bytes_transfer_limit, files_up_limit, files_down_limit, files_transfer_limit FROM ftpquotalimits WHERE name = '%{0}' AND quota_type = '%{1}'"

SQLNamedQuery get-quota-tally SELECT "name, quota_type, bytes_up_total, bytes_down_total, bytes_transfer_total, files_up_total, files_down_total, files_transfer_total FROM ftpquotatotal WHERE name = '%{0}' AND quota_type = '%{1}'"

SQLNamedQuery update-quota-tally UPDATE "bytes_up_total = bytes_up_total + %{0}, bytes_down_total = bytes_down_total + %{1}, bytes_transfer_total = bytes_transfer_total + %{2}, files_up_total = files_up_total + %{3}, files_down_total = files_down_total + %{4}, files_transfer_total = files_transfer_total + %{5} WHERE name = '%{6}' AND quota_type = '%{7}'" ftpquotatotal

SQLNamedQuery insert-quota-tally INSERT "%{0}, %{1}, %{2}, %{3}, %{4}, %{5}, %{6}, %{7}" ftpquotatotal

QuotaLimitTable sql:/get-quota-limit
QuotaTallyTable sql:/get-quota-tally/update-quota-tally/insert-quota-tally

RootLogin off
RequireValidShell off

# Gestion des logs
# ================
# Enregistre les requêtes SQL dans /var/log/proftpd/mysql.log
SQLLogFile /var/log/proftpd/mysql.log
# Enregistre les authentifications
LogFormat auth "%v [%P] %h %t \"%r\" %s"
ExtendedLog /var/log/proftpd/auth.log AUTH auth
# Enregistre les accès aux fichiers
LogFormat write "%h %l %u %t \"%r\" %s %b"
ExtendedLog /var/log/proftpd/access.log WRITE,READ write

# Recupère le nom à partir de l'ip de la machine de l'utilisateur ( resolution DNS )
IdentLookups on

Démarrage de proftpd

Il faut désormais créer le script qui va lancer proftpd. Copiez ces lignes dans /etc/init.d/proftpd (sur une Debian par exemple)

#!/bin/sh

# Start the proftpd FTP daemon.

PATH=/bin:/usr/bin:/sbin:/usr/sbin
DAEMON=/usr/sbin/proftpd
NAME=proftpd

# Defaults
RUN="no"
OPTIONS=""

PIDFILE=`grep -i 'pidfile' /etc/proftpd.conf | sed -e 's/pidfile[\t ]\+//i'`
if [ "x$PIDFILE" = "x" ];
then
PIDFILE=/var/run/proftpd.pid
fi

# Read config (will override defaults)
[ -r /etc/default/proftpd ] && . /etc/default/proftpd

trap "" 1
trap "" 15

test -f $DAEMON || exit 0

#
# Servertype could be inetd|standalone|none.
# In all cases check against inetd and xinetd support.
#
if ! egrep -qi "^[[:space:]] *ServerType.*standalone" /etc/proftpd.conf
then

 if [ $(dpkg-divert --list xinetd|wc -l) -eq 1 ]  
 then 
 if egrep -qi "server[[:space:]]*= [[:space:]]*/usr/sbin/proftpd" /etc/xinetd.conf -o \ 
 egrep -qi "server[[:space:]]*=[[:space:]] */usr/sbin/proftpd" /etc/xinetd.d/* 2>/dev/null 
 then 
 RUN="no" 
 INETD="yes" 
 else 
 if ! egrep -qi "^[[:space:]]*ServerType.*inetd" /etc/proftpd.conf 
 then 
 RUN="yes" 
 INETD="no" 
 else 
 RUN="no" 
 INETD="no" 
 fi 
 fi 
 else 
 if egrep -qi "^ftp.*/usr/sbin/proftpd" /etc/inetd.conf 2>/dev/null 
 then 
 RUN="no" 
 INETD="yes" 
 else 
 if ! egrep -qi "^[[:space:]]*ServerType.*inetd" /etc/proftpd.conf 
 then 
 RUN="yes" 
 INETD="no" 
 else 
 RUN="no" 
 INETD="no" 
 fi 
 fi 
 fi 
 fi 

start() {

   if start-stop-daemon --start --quiet --pidfile "$PIDFILE" \
       --exec $DAEMON -- $OPTIONS ; then
       echo "$NAME."
   else
       echo "."
   fi

}

signal()

 {
 if [ "$1" = "stop" ]; then
 SIGNAL="TERM"
 else
 if [ "$1" = "reload" ]; then
 SIGNAL="HUP"
 else
 echo "ERR: wrong parameter given to signal()"
 fi
 fi
 if start-stop-daemon --stop --signal $SIGNAL --quiet --pidfile "$PIDFILE"; then
 echo "$NAME."
 else
 SIGNAL="KILL"
 if start-stop-daemon --stop --signal $SIGNAL --quiet --pidfile "$PIDFILE"; then
 echo "$NAME."
 else
 echo "."
 fi
 fi
 if [ "$SIGNAL" = "KILL" ]; then
 rm -f "$PIDFILE"
 fi

}

case "$1" in start)

 if [ "x$RUN" = "xyes" ] ; then
 echo -n "Starting ProFTPD ftp daemon: "
 start
 else
 if [ "x$INETD" = "xyes" ] ; then
 echo "ProFTPd is started from inetd/xinetd."
 else 
 echo "ProFTPd warning: cannot start neither in standalone nor in inetd/xinetd mode. Check your configuration."
 fi
 fi
 ;;

force-start)

 if [ "x$INETD" = "xyes" ] ; then
 echo "Warning: ProFTPd is started from inetd/xinetd (trying to start anyway)."
 fi
 echo -n "Starting ProFTPD ftp daemon: "
 start
 ;; 
 

stop)

 if [ "x$RUN" = "xyes" ] ; then
 echo -n "Stopping ProFTPD ftp daemon: "
 signal stop
 else
 if [ "x$INETD" = "xyes" ] ; then
 echo "ProFTPd is started from inetd/xinetd."
 else 
 echo "ProFTPd warning: cannot start neither in standalone nor in inetd/xinetd mode. Check your configuration."
 fi
 fi
 ;;

force-stop)

 if [ "x$INETD" = "xyes" ] ; then
 echo "Warning: ProFTPd is started from inetd/xinetd (trying to kill anyway)."
 fi
 echo -n "Stopping ProFTPD ftp daemon: "
 signal stop
 ;;

reload)

 echo -n "Reloading $NAME configuration..."
 signal reload
 echo " done."
 ;;

force-reload|restart)

 if [ "x$RUN" = "xyes" ] ; then
 echo -n "Restarting ProFTPD ftp daemon."
 signal stop
 echo -n "."
 sleep 2
 echo -n "."
 start
 echo " done."
 else
 if [ "x$INETD" = "xyes" ] ; then
 echo "ProFTPd is started from inetd."
 else 
 echo "ProFTPd warning: cannot start neither in standalone nor in inetd/xinetd mode. Check your configuration."
 fi
 fi
 ;;
*)
 echo "Usage: /etc/init.d/$NAME {start|force-start|stop|force-stop|reload|restart|force-reload}"
 exit 1
 ;;
 esac

exit 0

Maintenant vous pouvez redémarrer le serveur ProFTPd pour appliquer la configuration :

/etc/init.d/proftpd restart

Utilisation

Maintenant que la configuration est faite, nous allons voir comment gérer les utilisateurs à travers la base de données.

Je vous conseille d'utiliser PHPMyAdmin pour ceux qui ne connaissent pas le langage SQL.

Gestion des utilisateurs

Ajout d'un utilisateur

Création de l'utilisateur 'test' avec un mot de passe 'pwd'. Cet utilisateur a accès au repertoire '/home/ftp/test' avec les droits de l'utilisateur (UID) 5500, et de groupe (GID) 5500, sans shell ('/bin/false').

La valeur 'LoginAllowed' est mise à 'true' pour autoriser la connection de cet utilisateur, à 'false' pour l'interdire.

INSERT INTO `ftpuser` ( `id`, `userid`, `passwd`, `uid`, `gid`, `homedir`, `shell`, `count`, `accessed` , `modified`, `LoginAllowed` ) VALUES ('', 'test', ENCRYPT('pwd'), '5500', '5500', '/home/ftp/test', '/bin/false', '', '', '', 'true' );

'count' représente le nombre d'authentifications effectuées par cet utilisateur,
'accessed' la date du dernier accès et
'modified' la date de la dernière écriture.

Suppression d'un utilisateur

Suppression de l'utilisateur 'test'

DELETE FROM `ftpuser` WHERE `userid`='test';
DELETE FROM `ftpgroup` WHERE `members`='test';

Gestion des groupes

Affecter un utilisateur à un groupe

Affecte l'utilisateur 'test' au groupe 'group_test' avec les droits de groupe (GID) du groupe 5500

INSERT INTO `ftpgroup` ( `groupname` , `gid` , `members` ) VALUES ('group_test', '5500', 'test');

Enlever un utilisateur d'un groupe

Enlève l'utilisateur 'test' du groupe 'group_test'

DELETE FROM `ftpgroup` WHERE `members`='test';

Gestion des quotas

La table 'ftpquotalimits' contient la description des quotas.
La table 'ftpquotatotal' contient les statistiques d'utilisation correspondant aux règles des quotas défini dans la table 'ftpquotalimits'. Cette table permet à ProFTPd de gérer les quotas.

Ajouter une règles de quotas

Exécuter la requête suivante :

INSERT INTO `ftpquotalimits` ( `name`, `quota_type`, `par_session`, `limit_type`, `bytes_up_limit`, `bytes_down_limit`, `bytes_transfer_limit`, `files_up_limit`, `files_down_limit`, `files_transfer_limit` )
VALUES ( 'NOM' , 'TYPE', 'SESSION', 'LIMIT_TYPE', 'B_UP', 'B_DOWN', 'B_TRANS', 'F_UP', 'F_DOWN', 'F_TRANS');

où

• name : nom de l'utilisateur, du groupe ou de la règle selon la valeur de quota_type.
• quota_type : 'user' si le quota s'applique à un utilisateur, 'group' à un groupe, 'class' à une classe (ici inutile), 'all' à tous les utilisateurs.
• par_session : 'true' si les quotas doivent être remis à zéro à chaque nouvelle session, 'false' sinon. ('false' est conseillé).
• limit_type : 'soft' pour une mesure logicielle de la taille, 'hard' pour une mesure hardware.
• bytes_up_limit : taille (en Mbytes) autorisé à être uploadé sur le serveur.
• bytes_down_limit : taille (en Mbytes) autorisé à être downloadé à partir du serveur.
• bytes_transfer_limit : taille (en Mbytes) autorisé à transféré à sur et à partir du serveur (upload+download).
• files_up_limit : nombre de fichiers autorisé à être uploadé sur le serveur.
• files_down_limit : nombre de fichiers autorisé à être downloadé à partir du serveur.
• files_transfer_limit : nombre de fichiers autorisé à transféré sur et à partir du serveur (upload+download).

Pour définir un quota illimité à l'un des champs, mettez une valeur négative ou nulle.

Attention : Les quotas de type 'all', 'class' ou 'group' ne définissent pas un quota pour chaque utilisateur mais un quota partagé par tous les utlisateurs concernés par cette règle.

Réinitialiser les quotas

Il suffit de supprimer l'entrée (ligne) correspondant à la règle devant être réinitialisé. Par exemple :

DELETE FROM `ftpquotatotal` WHERE `name`='test' AND `quota_type`='user';

Si vous voulez réinitialiser tous les quotas, par exemple tous les mois, faîtes une tâche cron se connectant sur le serveur et exécutant la requête suivante :

TRUNCATE TABLE `ftpquotatotal`;

Et voilà, c'est terminé... Vous n'avez plus qu'à tester ;-)

Cette page est issue de la documentation 'pré-wiki' de Léa a été convertie avec HTML::WikiConverter. Elle fut créée par space2d le 24/04/2005.

Copyright

Copyright © 24/04/2005, space2d