Module Apache mod_dbd

Regroupement des connexions

Ce module g�re de mani�re optimis�e en fonction de la plate-forme les connexions aux bases de donn�es. Sur les plates-formes non thread�es, il maintient une connexion persistente � la mani�re d'un LAMP classique (Linux, Apache, Mysql, Perl/PHP/Python). Sur les plates-formes thread�es, il maintient un groupe de connexions � la fois plus �volutif et plus efficace, comme d�crit dans cet article d'ApacheTutor. Notez que mod_dbd remplace les modules pr�sent�s dans cet article.

API DBD d'Apache

mod_dbd exporte cinq fonctions que d'autres modules pourront utiliser. L'API se pr�sente comme suit :

typedef struct {
    apr_dbd_t *handle;
    apr_dbd_driver_t *driver;
    apr_hash_t *prepared;
} ap_dbd_t;

/* Fonctions export�es pour acc�der � la base de donn�es */

/* ouvre une connexion qui DOIT avoir �t� explicitement ferm�e.
 * Renvoie NULL en cas d'erreur
 */
AP_DECLARE(ap_dbd_t*) ap_dbd_open(apr_pool_t*, server_rec*);

/* ferme une connexion ouverte avec ap_dbd_open */
AP_DECLARE(void) ap_dbd_close(server_rec*, ap_dbd_t*);

/* acquiert une connexion qui aura la dur�e de vie de la requ�te et qui
 * NE DOIT PAS avoir �t� explicitement ferm�e. Renvoie NULL en cas
 * d'erreur. C'est la fonction recommand�e pour la plupart des
 * applications.
 */
AP_DECLARE(ap_dbd_t*) ap_dbd_acquire(request_rec*);

/* acquiert une connexion qui aura la dur�e de vie d'une connexion et
 * qui NE DOIT PAS avoir �t� explicitement ferm�e. Renvoie NULL en cas
 * d'erreur.
 */
AP_DECLARE(ap_dbd_t*) ap_dbd_cacquire(conn_rec*);

/* Pr�pare une requ�te qu'un module client pourra utiliser */
AP_DECLARE(void) ap_dbd_prepare(server_rec*, const char*, const char*);

/* Exporte aussi ces fonctions � titre optionnel mour les modules qui
 * p�f�reraient les utiliser */
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_open, (apr_pool_t*, server_rec*));
APR_DECLARE_OPTIONAL_FN(void, ap_dbd_close, (server_rec*, ap_dbd_t*));
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_acquire, (request_rec*));
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_cacquire, (conn_rec*));
APR_DECLARE_OPTIONAL_FN(void, ap_dbd_prepare, (server_rec*, const char*, const char*));

Requ�tes SQL pr�par�es

mod_dbd supporte les requ�tes SQL pr�par�es � destination des modules qui pourraient les utiliser. Chaque requ�te pr�par�e doit poss�der un nom (�tiquette), et est stock�e dans un condens� (hash) : les condens�s sont du type apr_dbd_prepared_t et s'utilisent dans toute requ�te SQL ou commande select pr�par�e par apr_dbd.

Il est du ressort des modules utilisateurs de dbd d'utiliser les requ�tes pr�par�es et de pr�ciser quelles requ�tes doivent �tre sp�cifi�es dans apache2.conf, ou de fournir leurs propres directives et d'utiliser ap_dbd_prepare.

AVERTISSEMENT DE SECURITE

Toute application web impliquant une base de donn�es doit se prot�ger elle-m�me contre les attaques de type injection SQL. Dans la plupart des cas Apache DBD est s�r, car les applications utilisent des requ�tes pr�par�es, et les entr�es non sures ne seront utilis�es qu'� titre de donn�es. Bien entendu, si vous l'utilisez via un module tiers, vous devez �tre au fait des pr�cautions � prendre.

Cependant, le pilote FreeTDS est non s�r de par sa nature-m�me. Comme la biblioth�que sous-jacente ne supporte pas les requ�tes pr�par�es, le pilote en effectue une �mulation, et les entr�es non s�res sont fusionn�es avec la requ�te SQL.

Il peut �tre s�curis� en d�contaminant toutes les entr�es : un processus inspir� de la recherche de contaminations (taint mode) de Perl. Chaque entr�e est compar�e � une expression rationnelle, et seules les entr�es qui correspondent sont utilis�es, en accord avec le langage Perl :

  $untrusted =~ /([a-z]+)/;
  $trusted = $1;

Pour utiliser ceci, les expressions rationnelles de d�contamination doivent �tre incluses dans les requ�tes pr�par�es. L'expression rationnelle doit se situer imm�diatement apr�s le caract�re % dans la requ�te pr�par�e, et doit �tre entour�e d'accolades {}. Par exemple, si votre application attend une entr�e alphanum�rique, vous pouvez utiliser :

avec d'autres pilotes, et ne risquer au pire qu'une requ�te �chou�e. Mais avec FreeTDS, vous devez utiliser :

tout ce qui ne correspond pas � l'expression rationnelle est alors rejet�, et la requ�te est maintenant s�re.

Alternativement, vous pouvez utiliser le pilote ODBC tiers, qui offre la s�curit� des requ�tes pr�par�es authentiques.