1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
4 <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>mod_authz_dbd - Serveur HTTP Apache Version 2.5</title>
11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
19 <div id="page-header">
20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
21 <p class="apache">Serveur HTTP Apache Version 2.5</p>
22 <img alt="" src="../images/feather.png" /></div>
23 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
25 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
26 <div id="page-content">
27 <div id="preamble"><h1>Module Apache mod_authz_dbd</h1>
29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_dbd.html" hreflang="en" rel="alternate" title="English"> en </a> |
30 <a href="../fr/mod/mod_authz_dbd.html" title="Français"> fr </a></p>
32 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation par groupe ou par identifiant via SQL</td></tr>
33 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
34 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_dbd_module</td></tr>
35 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_dbd.c</td></tr>
36 <tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans les version 2.4 et supérieures
37 d'Apache</td></tr></table>
40 <p>Ce module fournit des fonctionnalités d'autorisation permettant
41 d'accorder ou de refuser aux utilisateurs authentifiés l'accès à
42 certaines zones du site web en fonction de leur appartenance à tel
43 ou tel groupe. Les modules <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> et
44 <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code> fournissent une fonctionnalité
45 similaire, mais ici le module interroge une base de données SQL pour
46 déterminer si un utilisateur appartient ou non à tel ou tel groupe.</p>
47 <p>Ce module peut aussi fournir des fonctionnalités de connexion
48 utilisateur s'appuyant sur une base de données. Ceci prend le plus souvent
49 sens lorsque le module est utilisé conjointement avec
50 <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.</p>
51 <p>Ce module s'appuie sur <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> pour spécifier le
52 pilote de la base de données sous-jacente et les paramètres de
53 connexion, et gérer les connexions à la base de données.</p>
55 <div id="quickview"><h3>Sujets</h3>
57 <li><img alt="" src="../images/down.gif" /> <a href="#requiredirectives">Les directives Require</a></li>
58 <li><img alt="" src="../images/down.gif" /> <a href="#login">Connexion s'appuyant sur une base de données</a></li>
59 <li><img alt="" src="../images/down.gif" /> <a href="#client">Intégration des ouvertures de sessions côté client</a></li>
60 <li><img alt="" src="../images/down.gif" /> <a href="#example">Exemple de configuration</a></li>
61 <li><img alt="" src="../images/down.gif" /> <a href="#security">Prévention contre les injections SQL</a></li>
62 </ul><h3 class="directives">Directives</h3>
64 <li><img alt="" src="../images/down.gif" /> <a href="#authzdbdlogintoreferer">AuthzDBDLoginToReferer</a></li>
65 <li><img alt="" src="../images/down.gif" /> <a href="#authzdbdquery">AuthzDBDQuery</a></li>
66 <li><img alt="" src="../images/down.gif" /> <a href="#authzdbdredirectquery">AuthzDBDRedirectQuery</a></li>
68 <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_authz_dbd">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_authz_dbd">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
70 <li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li>
72 <code class="directive"><a href="../mod/mod_authn_dbd.html#authdbduserpwquery">AuthDBDUserPWQuery</a></code>
74 <li><code class="directive"><a href="../mod/mod_dbd.html#dbdriver">DBDriver</a></code></li>
75 <li><code class="directive"><a href="../mod/mod_dbd.html#dbdparams">DBDParams</a></code></li>
76 <li><a href="#comments_section">Commentaires</a></li></ul></div>
77 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
79 <h2><a name="requiredirectives" id="requiredirectives">Les directives Require</a><a title="Lien permanent" href="#requiredirectives" class="permalink">¶</a></h2>
81 <p>Les directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> d'Apache permettent,
82 au cours de la phase d'autorisation, de s'assurer qu'un utilisateur
83 est bien autorisé à accéder à une ressource. mod_authz_dbd ajoute
84 les types d'autorisation <code>dbd-group</code>,
85 <code>dbd-login</code> et <code>dbd-logout</code>.</p>
87 <p>A partir de la version 2.4.8, les directives require DBD
88 supportent les <a href="../expr.html">expressions</a>.</p>
90 <h3><a name="reqgroup" id="reqgroup">Require dbd-group</a></h3>
92 <p>Cette directive permet de spécifier à quel groupe un utilisateur
93 doit appartenir pour obtenir l'autorisation d'accès.</p>
95 <pre class="prettyprint lang-config">Require dbd-group team
96 AuthzDBDQuery "SELECT group FROM authz WHERE user = %s"</pre>
101 <h3><a name="reqlogin" id="reqlogin">Require dbd-login</a></h3>
103 <p>Cette directive permet de spécifier une requête à exécuter pour
104 indiquer que l'utilisateur s'est authentifié.</p>
106 <pre class="prettyprint lang-config">Require dbd-login
107 AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"</pre>
112 <h3><a name="reqlogout" id="reqlogout">Require dbd-logout</a></h3>
114 <p>Cette directive permet de spécifier une requête à exécuter pour
115 indiquer que l'utilisateur s'est déconnecté.</p>
117 <pre class="prettyprint lang-config">Require dbd-logout
118 AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"</pre>
123 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
124 <div class="section">
125 <h2><a name="login" id="login">Connexion s'appuyant sur une base de données</a><a title="Lien permanent" href="#login" class="permalink">¶</a></h2>
128 Outre sa fonction d'autorisation standard consistant à vérifier
129 l'appartenance à des groupes, ce module permet également de gérer des
130 sessions utilisateur côté serveur grâce à sa fonctionnalité de gestion de login/logout
131 via base de données. En particulier, il peut mettre à
132 jour le statut de session de l'utilisateur dans la base de données
133 chaque fois que celui-ci visite certaines URLs (sous réserve bien
134 entendu que l'utilisateur fournisse les informations de connexion
136 <p>Pour cela, il faut definir deux directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> spéciales : <code>Require
137 dbd-login</code> et <code>Require dbd-logout</code>. Pour les détails de
138 leur utilisation, voir l'exemple de configuration ci-dessous.</p>
139 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
140 <div class="section">
141 <h2><a name="client" id="client">Intégration des ouvertures de sessions côté client</a><a title="Lien permanent" href="#client" class="permalink">¶</a></h2>
143 <p>Pour les administrateurs qui désirent implémenter une gestion de
144 session côté client fonctionnant de concert avec les fonctionnalités de
145 connexion/déconnexion côté serveur offertes par ce module, il est possible
146 de définir ou en d'annuler par exemple un cookie HTTP ou un jeton
147 de connextion lorsqu'un utilisateur se connecte ou se déconnecte.</p>
148 <p> Pour supporter une telle intégration, <code class="module"><a href="../mod/mod_authz_dbd.html">mod_authz_dbd</a></code> exporte
149 un déclenchement optionnel (hook) qui sera lancé chaque fois
150 que le statut d'un utilisateur sera mis à jour dans la base de données.
151 D'autres modules de gestion de session pourront alors utiliser ce
152 déclencheur pour utiliser des fonctions d'ouverture et de
153 fermeture de sessions côté client.</p>
154 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
155 <div class="section">
156 <h2><a name="example" id="example">Exemple de configuration</a><a title="Lien permanent" href="#example" class="permalink">¶</a></h2>
158 <pre class="prettyprint lang-config"># configuration de mod_dbd
160 DBDParams "dbname=apacheauth user=apache pass=xxxxxx"
167 <Directory "/usr/www/mon.site/team-private/">
168 # configuration de mod_authn_core et mod_auth_basic
172 AuthBasicProvider dbd
174 # requête SQL de mod_authn_dbd pour authentifier un utilisateur qui se
177 "SELECT password FROM authn WHERE user = %s AND login = 'true'"
179 # configuration de mod_authz_core pour mod_authz_dbd
180 Require dbd-group team
182 # configuration de mod_authz_dbd
183 AuthzDBDQuery "SELECT group FROM authz WHERE user = %s"
185 # lorsqu'un utilisateur échoue dans sa tentative d'authentification ou
186 # d'autorisation, on l'invite à se connecter ; cette page doit
187 # contenir un lien vers /team-private/login.html
188 ErrorDocument 401 /login-info.html
190 <Files "login.html">
191 # il n'est pas nécessaire que l'utilisateur soit déjà connecté !
192 AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
194 # le processus de connexion dbd exécute une requête pour enregistrer
195 # la connexion de l'utilisateur
197 AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"
199 # redirige l'utilisateur vers la page d'origine (si elle existe)
200 # après une connexion réussie
201 AuthzDBDLoginToReferer On
204 <Files "logout.html">
205 # le processus de déconnexion dbd exécute une requête pour
206 # enregistrer la déconnexion de l'utilisateur
208 AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"
210 </Directory></pre>
212 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
213 <div class="section">
214 <h2><a name="security" id="security">Prévention contre les injections SQL</a><a title="Lien permanent" href="#security" class="permalink">¶</a></h2>
216 <p>Selon le pilote DBD choisi et le serveur d'arrière-plan que vous utilisez,
217 vous devrez prendre garde à la sécurité dans le domaine SQL.
218 Avec la plupart des pilotes, vous n'avez rien à faire : la
219 requête est préparée par la base de données au démarrage, et l'entrée
220 utilisateur n'est utilisée qu'en tant que donnée. Mais vous aurez
221 peut-être à nettoyer cette entrée. Au moment où ces lignes sont
222 écrites, le seul pilote DBD qui peut nécessiter le nettoyage de l'entrée
224 <p>Veuillez vous référez à la documentation de
225 <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> pour plus d'informations à propos de la
226 sécurité dans ce domaine.</p>
228 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
229 <div class="directive-section"><h2><a name="authzdbdlogintoreferer" id="authzdbdlogintoreferer">Directive</a> <a name="AuthzDBDLoginToReferer" id="AuthzDBDLoginToReferer">AuthzDBDLoginToReferer</a><a title="Lien permanent" href="#authzdbdlogintoreferer" class="permalink">¶</a></h2>
230 <table class="directive">
231 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit si le client doit être redirigé vers la page
232 d'origine en cas de connexion ou de déconnexion réussie si une en-tête
233 de requête <code>Referer</code> est présente</td></tr>
234 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzDBDLoginToReferer On|Off</code></td></tr>
235 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthzDBDLoginToReferer Off</code></td></tr>
236 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
237 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
238 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_dbd</td></tr>
240 <p>Utilisée en conjonction avec <code>Require dbd-login</code> ou
241 <code>Require dbd-logout</code>, cette directive permet de rediriger
242 le client vers la page d'origine (l'URL contenue dans l'en-tête
243 de requête HTTP <code>Referer</code>, s'il est présent). En
244 l'absence d'en-tête <code>Referer</code>, la définition
245 <code>AuthzDBDLoginToReferer On</code> sera ignorée.</p>
248 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
249 <div class="directive-section"><h2><a name="authzdbdquery" id="authzdbdquery">Directive</a> <a name="AuthzDBDQuery" id="AuthzDBDQuery">AuthzDBDQuery</a><a title="Lien permanent" href="#authzdbdquery" class="permalink">¶</a></h2>
250 <table class="directive">
251 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la requête SQL pour l'opération
253 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzDBDQuery <var>requête</var></code></td></tr>
254 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
255 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
256 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_dbd</td></tr>
258 <p>La directive <code class="directive">AuthzDBDQuery</code> permet de
259 spécifier une requête SQL à exécuter. Le but de cette requête dépend
260 de la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> en cours de
263 <li>Avec la directive <code>Require dbd-group</code>, elle spécifie
264 une requête permettant de rechercher les groupes d'appartenance de
265 l'utilisateur courant. Ceci correspond à la fonctionnalité standard
266 d'autres modules d'autorisation comme
267 <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> et
268 <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code>.
269 La première colonne de chaque enregistrement renvoyé par la requête
270 doit contenir une chaîne de caractères correspondant à un nom de
271 groupe. La requête peut renvoyer zéro, un ou plusieurs
273 <pre class="prettyprint lang-config">Require dbd-group
274 AuthzDBDQuery "SELECT group FROM groups WHERE user = %s"</pre>
277 <li>Avec la directive <code>Require dbd-login</code> ou
278 <code>Require dbd-logout</code>, elle ne refusera jamais l'accès,
279 mais au contraire exécutera une requête SQL permettant d'enregistrer
280 la connexion ou la déconnexion de l'utilisateur. Ce dernier doit
281 être déjà authentifié avec <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.
282 <pre class="prettyprint lang-config">Require dbd-login
283 AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"</pre>
287 <p>Dans tous les cas, l'identifiant utilisateur sera transmis comme
288 paramètre sous la forme d'une simple chaîne lorsque la requête SQL
289 sera exécutée. Il y sera fait référence dans la requête en utilisant
290 le spécificateur de format <code>%s</code>.</p>
293 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
294 <div class="directive-section"><h2><a name="authzdbdredirectquery" id="authzdbdredirectquery">Directive</a> <a name="AuthzDBDRedirectQuery" id="AuthzDBDRedirectQuery">AuthzDBDRedirectQuery</a><a title="Lien permanent" href="#authzdbdredirectquery" class="permalink">¶</a></h2>
295 <table class="directive">
296 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une requête pour rechercher une page vers laquelle
297 rediriger l'utilisateur après une connexion réussie</td></tr>
298 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzDBDRedirectQuery <var>requête</var></code></td></tr>
299 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
300 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
301 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_dbd</td></tr>
303 <p>Spécifie une requête SQL optionnelle à utiliser après une
304 connexion (ou une déconnexion) réussie pour rediriger l'utilisateur
305 vers une URL, qui peut être spécifique à l'utilisateur.
306 L'identifiant utilisateur sera transmis comme paramètre sous la
307 forme d'une simple chaîne lorsque la requête SQL sera exécutée. Il y
308 sera fait référence dans la requête en utilisant le spécificateur de
309 format <code>%s</code>.</p>
310 <pre class="prettyprint lang-config">AuthzDBDRedirectQuery "SELECT userpage FROM userpages WHERE user = %s"</pre>
312 <p>La première colonne du premier enregistrement renvoyé par la
313 requête doit contenir une chaîne de caractères correspondant à une
314 URL vers laquelle rediriger le client. Les enregistrements suivants
315 sont ignorés. Si aucun enregistrement n'est renvoyé, le client ne
316 sera pas redirigé.</p>
317 <p>Notez que <code class="directive">AuthzDBDLoginToReferer</code> l'emporte
318 sur cette directive si les deux sont définies.</p>
322 <div class="bottomlang">
323 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_dbd.html" hreflang="en" rel="alternate" title="English"> en </a> |
324 <a href="../fr/mod/mod_authz_dbd.html" title="Français"> fr </a></p>
325 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
326 <script type="text/javascript"><!--//--><![CDATA[//><!--
327 var comments_shortname = 'httpd';
328 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authz_dbd.html';
330 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
331 d.write('<div id="comments_thread"><\/div>');
332 var s = d.createElement('script');
333 s.type = 'text/javascript';
335 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
336 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
339 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
341 })(window, document);
342 //--><!]]></script></div><div id="footer">
343 <p class="apache">Copyright 2018 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
344 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
345 if (typeof(prettyPrint) !== 'undefined') {