granicus.if.org Git - apache/blob - docs/manual/mod/mod_authn_socache.html.fr.utf8

   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" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>mod_authn_socache - 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">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body>
  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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
  26 <div id="page-content">
  27 <div id="preamble"><h1>Module Apache mod_authn_socache</h1>
  28 <div class="toplang">
  29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_socache.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  30 <a href="../fr/mod/mod_authn_socache.html" title="Français">&nbsp;fr&nbsp;</a></p>
  31 </div>
  32 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Gère un cache des données d'authentification pour diminuer
  33 la charge des serveurs d'arrière-plan</td></tr>
  34 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
  35 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authn_socache_module</td></tr>
  36 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_socache.c</td></tr>
  37 <tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Versions 2.3 et ultérieures</td></tr></table>
  38 <h3>Sommaire</h3>
  39
  40     <p>Maintient un cache des données d'authentification pour limiter
  41     les sollicitations du serveur d'arrière-plan.</p>
  42 </div>
  43 <div id="quickview"><h3>Sujets</h3>
  44 <ul id="topics">
  45 <li><img alt="" src="../images/down.gif" /> <a href="#intro">Mise en cache des données d'authentification</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#usage">Utilisation</a></li>
  47 <li><img alt="" src="../images/down.gif" /> <a href="#dev">La mise en cache avec les modules tiers</a></li>
  48 </ul><h3 class="directives">Directives</h3>
  49 <ul id="toc">
  50 <li><img alt="" src="../images/down.gif" /> <a href="#authncachecontext">AuthnCacheContext</a></li>
  51 <li><img alt="" src="../images/down.gif" /> <a href="#authncacheenable">AuthnCacheEnable</a></li>
  52 <li><img alt="" src="../images/down.gif" /> <a href="#authncacheprovidefor">AuthnCacheProvideFor</a></li>
  53 <li><img alt="" src="../images/down.gif" /> <a href="#authncachesocache">AuthnCacheSOCache</a></li>
  54 <li><img alt="" src="../images/down.gif" /> <a href="#authncachetimeout">AuthnCacheTimeout</a></li>
  55 </ul>
  56 <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__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_authn_socache">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_authn_socache">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
  57 <ul class="seealso">
  58 <li><a href="#comments_section">Commentaires</a></li></ul></div>
  59 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  60 <div class="section">
  61 <h2><a name="intro" id="intro">Mise en cache des données d'authentification</a><a title="Lien permanent" href="#intro" class="permalink">&para;</a></h2>
  62     <p>Certains utilisateurs qui mettent en oeuvre une authentification
  63     lourde s'appuyant par exemple sur des requêtes SQL
  64     (<code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>) ont signalé une charge induite
  65     inacceptable sur leur fournisseur d'authentification. Cela se
  66     produit typiquement dans le cas où une page HTML contient des
  67     centaines d'objets (images, scripts, pages de styles, media,
  68     etc...), et où une requête pour cette page génère des centaines de
  69     sous-requêtes à effet immédiat pour des contenus supplémentaires
  70     authentifiés.</p>
  71     <p>Pour résoudre ce problème, mod_authn_socache fournit une solution
  72     qui permet de maintenir un cache des données d'authentification.</p>
  73 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  74 <div class="section">
  75 <h2><a name="usage" id="usage">Utilisation</a><a title="Lien permanent" href="#usage" class="permalink">&para;</a></h2>
  76     <p>Le cache d'authentification doit être utilisé lorsque les
  77     requêtes d'authentification induisent une charge significative sur le
  78     serveur, le serveur d'arrière-plan ou le réseau. Cette mise en cache
  79     n'apportera probablement aucune amélioration dans le cas d'une
  80     authentification à base de fichier (<code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>)
  81     ou de base de données dbm (<code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>) car ces
  82     méthodes sont de par leur conception rapides et légères (la mise en
  83     cache peut cependant s'avérer utile dans le cas où le fichier est
  84     situé sur un montage réseau). Les fournisseurs d'authentification
  85     basés sur SQL ou LDAP ont plus de chances de tirer parti de cette
  86     mise en cache, en particulier lorsqu'un problème de performances est
  87     détecté. <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> gérant son propre cache,
  88     seul <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> est concerné par notre sujet.</p>
  89     <p>Les principales règles à appliquer pour la mise en cache sont :</p>
  90     <ol><li>Inclure le fournisseur pour lequel vous voulez effectuer une
  91     mise en cache dans une directive
  92     <code class="directive">AuthnCacheProvideFor</code>.</li>
  93         <li>Mettre <var>socache</var> avant le fournisseur pour lequel
  94         vous voulez effectuer une mise en cache dans votre directive
  95         <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code>
  96         ou <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code>.</li>
  97     </ol>
  98     <p>Voici un exemple simple permettant d'accélérer
  99     <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> et utilisant dbm comme moteur de la
 100     mise en cache :</p>
 101     <pre class="prettyprint lang-config">    #AuthnCacheSOCache est optionnel. S'il est défini, il l'est pour
 102     #l'ensemble du serveur
 103 AuthnCacheSOCache dbm
 104 &lt;Directory "/usr/www/myhost/private"&gt;
 105     AuthType Basic
 106     AuthName "Cached Authentication Example"
 107     AuthBasicProvider socache dbd
 108     AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
 109     AuthnCacheProvideFor dbd
 110     Require valid-user
 111     #Optionnel
 112     AuthnCacheContext dbd-authn-example
 113 &lt;/Directory&gt;</pre>
 114
 115 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 116 <div class="section">
 117 <h2><a name="dev" id="dev">La mise en cache avec les modules tiers</a><a title="Lien permanent" href="#dev" class="permalink">&para;</a></h2>
 118     <p>Les développeurs de modules doivent savoir que la mise en cache
 119     avec mod_authn_socache doit être activée dans leurs modules. La
 120     fonction de l'API <var>ap_authn_cache_store</var> permet de
 121     mettre en cache les données d'authentification qu'un fournisseur
 122     vient de rechercher ou de générer. Vous trouverez des exemples
 123     d'utilisation à <a href="http://svn.eu.apache.org/viewvc?view=revision&amp;revision=957072">r957072</a>, où trois fournisseurs authn sont activés pour la mise
 124     en cache.</p>
 125 </div>
 126 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 127 <div class="directive-section"><h2><a name="authncachecontext" id="authncachecontext">Directive</a> <a name="AuthnCacheContext" id="AuthnCacheContext">AuthnCacheContext</a><a title="Lien permanent" href="#authncachecontext" class="permalink">&para;</a></h2>
 128 <table class="directive">
 129 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie une chaîne de contexte à utiliser dans la clé du
 130 cache</td></tr>
 131 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheContext <var>directory|server|chaîne-personnalisée</var></code></td></tr>
 132 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>directory</code></td></tr>
 133 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 134 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 135 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_socache</td></tr>
 136 </table>
 137     <p>Cette directive permet de spécifier une chaîne à utiliser avec le
 138     nom d'utilisateur fourni (et le domaine d'authentification - realm -
 139     dans le cas d'une authentification à base de condensés) lors de la
 140     construction d'une clé de cache. Ceci permet de lever l'ambiguïté
 141     entre plusieurs noms d'utilisateurs identiques servant différentes
 142     zones d'authentification sur le serveur.</p>
 143     <p>Il y a deux valeurs spéciales pour le paramètre : <var>directory</var>,
 144     qui utilise le contexte de répertoire de la requête comme chaîne, et
 145     <var>server</var>, qui utilise le nom du serveur virtuel.</p>
 146     <p>La valeur par défaut est <var>directory</var>, qui est aussi la
 147     définition la plus courante. Ceci est cependant loin d'être optimal,
 148     car par exemple, <var>$app-base</var>, <var>$app-base/images</var>,
 149     <var>$app-base/scripts</var> et <var>$app-base/media</var>
 150     possèderont chacun leur propre clé de cache. Il est préférable
 151     d'utiliser le fournisseur de mot de passe : par exemple un fichier
 152     <var>htpasswd</var> ou une table de base de données.</p>
 153     <p>Les contextes peuvent être partagés entre différentes zones du
 154     serveur, où les données d'authentification sont partagées. Ceci est
 155     cependant susceptible de créer des trous de sécurité de type
 156     cross-site ou cross-application, et cette directive n'est donc pas
 157     disponible dans les contextes <var>.htaccess</var>.</p>
 158
 159 </div>
 160 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 161 <div class="directive-section"><h2><a name="authncacheenable" id="authncacheenable">Directive</a> <a name="AuthnCacheEnable" id="AuthnCacheEnable">AuthnCacheEnable</a><a title="Lien permanent" href="#authncacheenable" class="permalink">&para;</a></h2>
 162 <table class="directive">
 163 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la mise en cache de l'authentification en tout
 164 endroit</td></tr>
 165 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheEnable</code></td></tr>
 166 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
 167 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 168 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_socache</td></tr>
 169 </table>
 170     <p>Normalement, cette directive n'est pas nécessaire : l'activation
 171     est implicite si la mise en cache de l'authentification a été
 172     activée en tout autre endroit du fichier <var>httpd.conf</var>. Par
 173     contre, si cette mise en cache n'a pas été activée, par défaut, elle
 174     ne sera pas initialisée, et ne sera donc pas disponible dans un
 175     contexte de fichier <var>.htaccess</var>. Cette directive permet
 176     d'être sûr que la mise en cache a bien été activée et pourra
 177     donc être utilisée dans les fichiers <var>.htaccess</var>.</p>
 178
 179 </div>
 180 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 181 <div class="directive-section"><h2><a name="authncacheprovidefor" id="authncacheprovidefor">Directive</a> <a name="AuthnCacheProvideFor" id="AuthnCacheProvideFor">AuthnCacheProvideFor</a><a title="Lien permanent" href="#authncacheprovidefor" class="permalink">&para;</a></h2>
 182 <table class="directive">
 183 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécifie le fournisseur pour lequel on veut effectuer une
 184 mise en cache</td></tr>
 185 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheProvideFor <var>fournisseur-authn</var> [...]</code></td></tr>
 186 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>None</code></td></tr>
 187 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
 188 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>AuthConfig</td></tr>
 189 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 190 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_socache</td></tr>
 191 </table>
 192     <p>Cette directive permet de spécifier un ou plusieurs fournisseurs
 193     pour le(s)quel(s) on veut effectuer une mise en cache. Les données
 194     d'authentification trouvées par un fournisseur non spécifié dans une
 195     directive AuthnCacheProvideFor ne seront pas mises en cache.</p>
 196
 197     <p>Par exemple, pour mettre en cache les données d'authentification
 198     trouvées par <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> ou par un fournisseur
 199     personnalisé <var>mon-fournisseur</var>, et ne pas mettre en cache
 200     celles trouvées par les fournisseurs légers comme file ou dbm :</p>
 201     <pre class="prettyprint lang-config">AuthnCacheProvideFor dbd mon-fournisseur</pre>
 202
 203
 204 </div>
 205 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 206 <div class="directive-section"><h2><a name="authncachesocache" id="authncachesocache">Directive</a> <a name="AuthnCacheSOCache" id="AuthnCacheSOCache">AuthnCacheSOCache</a><a title="Lien permanent" href="#authncachesocache" class="permalink">&para;</a></h2>
 207 <table class="directive">
 208 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sélectionne le fournisseur socache d'arrière-plan à
 209 utiliser</td></tr>
 210 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheSOCache <var>nom-fournisseur[:arguments-fournisseur]</var></code></td></tr>
 211 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
 212 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 213 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_socache</td></tr>
 214 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les arguments optionnels du fournisseur sont disponibles
 215 à partir de la version 2.4.7 du serveur HTTP Apache</td></tr>
 216 </table>
 217     <p>Cette définition s'applique à l'ensemble du serveur et permet de
 218     sélectionner un fournisseur pour le <a href="../socache.html">cache
 219     d'objets partagés</a>, ainsi que des arguments éventuels pour ce
 220     fournisseur. Les fournisseurs disponibles sont, entre autres, "dbm",
 221     "dc", "memcache", ou "shmcb", chacun d'entre eux nécessitant le chargement
 222     du module approprié. Si elle est
 223     absente, c'est la valeur par défaut pour votre plate-forme qui sera
 224     utilisée.</p>
 225
 226 </div>
 227 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 228 <div class="directive-section"><h2><a name="authncachetimeout" id="authncachetimeout">Directive</a> <a name="AuthnCacheTimeout" id="AuthnCacheTimeout">AuthnCacheTimeout</a><a title="Lien permanent" href="#authncachetimeout" class="permalink">&para;</a></h2>
 229 <table class="directive">
 230 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une durée de vie pour les entrées du cache</td></tr>
 231 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthnCacheTimeout <var>durée-de-vie</var> (secondes)</code></td></tr>
 232 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>300 (5 minutes)</code></td></tr>
 233 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
 234 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>AuthConfig</td></tr>
 235 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 236 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_socache</td></tr>
 237 </table>
 238     <p>La mise en cache des données d'authentification peut constituer
 239     un trou de sécurité, bien qu'un mise en cache de courte durée ne
 240     posera probablement pas de problème. En général, il est conseillé de
 241     conserver les entrées du cache de façon à ce que la charge du serveur
 242     d'arrière-plan reste normale, mais pas plus longtemps ;
 243     une durée de vie plus longue peut être paramétrée si les
 244     changements d'utilisateurs et de mots de passe sont peu fréquents.
 245     La durée de vie par défaut de 300 secondes (5 minutes) est à la fois
 246     raisonnable et suffisamment importante pour réduire la charge d'un
 247     serveur d'arrière-plan comme dbd (requêtes SQL).</p>
 248     <p>Cette durée de vie ne doit pas être confondue avec la durée de
 249     vie de session qui est un tout autre sujet. Cependant, vous devez
 250     utiliser votre logiciel de gestion de session pour vérifier si les
 251     données d'authentification mises en cache peuvent allonger
 252     accidentellement une session, et en tenir compte lorsque vous
 253     définissez la durée de vie.</p>
 254
 255 </div>
 256 </div>
 257 <div class="bottomlang">
 258 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_socache.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 259 <a href="../fr/mod/mod_authn_socache.html" title="Français">&nbsp;fr&nbsp;</a></p>
 260 </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&amp;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>
 261 <script type="text/javascript"><!--//--><![CDATA[//><!--
 262 var comments_shortname = 'httpd';
 263 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authn_socache.html';
 264 (function(w, d) {
 265     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 266         d.write('<div id="comments_thread"><\/div>');
 267         var s = d.createElement('script');
 268         s.type = 'text/javascript';
 269         s.async = true;
 270         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 271         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 272     }
 273     else {
 274         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 275     }
 276 })(window, document);
 277 //--><!]]></script></div><div id="footer">
 278 <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>
 279 <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[//><!--
 280 if (typeof(prettyPrint) !== 'undefined') {
 281     prettyPrint();
 282 }
 283 //--><!]]></script>
 284 </body></html>