1<?xml version="1.0" encoding="ISO-8859-1"?> 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 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>mod_ldap - Serveur Apache HTTP</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<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" /> 12<script src="/style/scripts/prettify.min.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.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> 19<p class="apache">Serveur Apache HTTP Version 2.4</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<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.4</a> > <a href="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Module Apache mod_ldap</h1> 26<div class="toplang"> 27<p><span>Langues Disponibles: </span><a href="/en/mod/mod_ldap.html" hreflang="en" rel="alternate" title="English"> en </a> | 28<a href="/fr/mod/mod_ldap.html" title="Fran�ais"> fr </a></p> 29</div> 30<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Conservation des connexions LDAP et services de mise en 31cache du r�sultat � destination des autres modules LDAP</td></tr> 32<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 33<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>ldap_module</td></tr> 34<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>util_ldap.c</td></tr></table> 35<h3>Sommaire</h3> 36 37 <p>Ce module a �t� con�u dans le but d'am�liorer les performances 38 des sites web s'appuyant sur des connexions en arri�re-plan vers des 39 serveurs LDAP. Il ajoute aux fonctions fournies par les 40 biblioth�ques standards LDAP la conservation des connexions LDAP 41 ainsi qu'un cache LDAP partag� en m�moire.</p> 42 43 <p>Pour activer ce module, le support LDAP doit �tre compil� dans 44 apr-util. Pour ce faire, on ajoute l'option <code>--with-ldap</code> 45 au script <code class="program"><a href="/programs/configure.html">configure</a></code> lorsqu'on construit 46 Apache.</p> 47 48 <p>Le support SSL/TLS est conditionn� par le kit de d�veloppement 49 LDAP qui a �t� li� � <a class="glossarylink" href="/glossary.html#apr" title="voir glossaire">APR</a>. Au moment o� ces 50 lignes sont �crites, APR-util supporte <a href="http://www.openldap.org/">OpenLDAP SDK</a> (version 2.x ou 51 sup�rieure), <a href="http://developer.novell.com/ndk/cldap.htm">Novell LDAP 52 SDK</a>, <a href="https://wiki.mozilla.org/LDAP_C_SDK"> 53 Mozilla LDAP SDK</a>, le SDK LDAP Solaris natif (bas� sur Mozilla) 54 ou le SDK LDAP Microsoft natif. Voir le site web <a href="http://apr.apache.org">APR</a> pour plus de d�tails.</p> 55 56</div> 57<div id="quickview"><h3 class="directives">Directives</h3> 58<ul id="toc"> 59<li><img alt="" src="/images/down.gif" /> <a href="#ldapcacheentries">LDAPCacheEntries</a></li> 60<li><img alt="" src="/images/down.gif" /> <a href="#ldapcachettl">LDAPCacheTTL</a></li> 61<li><img alt="" src="/images/down.gif" /> <a href="#ldapconnectionpoolttl">LDAPConnectionPoolTTL</a></li> 62<li><img alt="" src="/images/down.gif" /> <a href="#ldapconnectiontimeout">LDAPConnectionTimeout</a></li> 63<li><img alt="" src="/images/down.gif" /> <a href="#ldaplibrarydebug">LDAPLibraryDebug</a></li> 64<li><img alt="" src="/images/down.gif" /> <a href="#ldapopcacheentries">LDAPOpCacheEntries</a></li> 65<li><img alt="" src="/images/down.gif" /> <a href="#ldapopcachettl">LDAPOpCacheTTL</a></li> 66<li><img alt="" src="/images/down.gif" /> <a href="#ldapreferralhoplimit">LDAPReferralHopLimit</a></li> 67<li><img alt="" src="/images/down.gif" /> <a href="#ldapreferrals">LDAPReferrals</a></li> 68<li><img alt="" src="/images/down.gif" /> <a href="#ldapretries">LDAPRetries</a></li> 69<li><img alt="" src="/images/down.gif" /> <a href="#ldapretrydelay">LDAPRetryDelay</a></li> 70<li><img alt="" src="/images/down.gif" /> <a href="#ldapsharedcachefile">LDAPSharedCacheFile</a></li> 71<li><img alt="" src="/images/down.gif" /> <a href="#ldapsharedcachesize">LDAPSharedCacheSize</a></li> 72<li><img alt="" src="/images/down.gif" /> <a href="#ldaptimeout">LDAPTimeout</a></li> 73<li><img alt="" src="/images/down.gif" /> <a href="#ldaptrustedclientcert">LDAPTrustedClientCert</a></li> 74<li><img alt="" src="/images/down.gif" /> <a href="#ldaptrustedglobalcert">LDAPTrustedGlobalCert</a></li> 75<li><img alt="" src="/images/down.gif" /> <a href="#ldaptrustedmode">LDAPTrustedMode</a></li> 76<li><img alt="" src="/images/down.gif" /> <a href="#ldapverifyservercert">LDAPVerifyServerCert</a></li> 77</ul> 78<h3>Sujets</h3> 79<ul id="topics"> 80<li><img alt="" src="/images/down.gif" /> <a href="#exampleconfig">Exemple de configuration</a></li> 81<li><img alt="" src="/images/down.gif" /> <a href="#pool">Conservation des connexions LDAP</a></li> 82<li><img alt="" src="/images/down.gif" /> <a href="#cache">Cache LDAP</a></li> 83<li><img alt="" src="/images/down.gif" /> <a href="#usingssltls">Utiliser SSL/TLS</a></li> 84<li><img alt="" src="/images/down.gif" /> <a href="#settingcerts">Certificats SSL/TLS</a></li> 85</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> 86<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 87<div class="section"> 88<h2><a name="exampleconfig" id="exampleconfig">Exemple de configuration</a></h2> 89 <p>Ce qui suit est un exemple de configuration qui utilise 90 <code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> pour am�liorer les performances de 91 l'authentification HTTP de base fournie par 92 <code class="module"><a href="/mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>.</p> 93 94 <pre class="prettyprint lang-config"># Active la conservation des connexions LDAP et le cache partag� en 95# m�moire. Active le gestionnaire de statut du cache LDAP. 96# N�cessite le chargement de mod_ldap et de mod_authnz_ldap. 97# Remplacez "votre-domaine.example.com" par le nom de votre 98# domaine. 99 100LDAPSharedCacheSize 500000 101LDAPCacheEntries 1024 102LDAPCacheTTL 600 103LDAPOpCacheEntries 1024 104LDAPOpCacheTTL 600 105 106<Location /ldap-status> 107 SetHandler ldap-status 108 109 Require host yourdomain.example.com 110 111 Satisfy any 112 AuthType Basic 113 AuthName "LDAP Protected" 114 AuthBasicProvider ldap 115 AuthLDAPURL ldap://127.0.0.1/dc=example,dc=com?uid?one 116 Require valid-user 117</Location></pre> 118 119</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 120<div class="section"> 121<h2><a name="pool" id="pool">Conservation des connexions LDAP</a></h2> 122 123 <p>Les connexions LDAP sont conserv�es de requ�te en requ�te. Ceci 124 permet de rester connect� et identifi� au serveur LDAP, ce dernier 125 �tant ainsi pr�t pour la prochaine requ�te, sans avoir � se 126 d�connecter, reconnecter et r�identifier. Le gain en performances 127 est similaire � celui des connexions persistantes (keepalives) 128 HTTP.</p> 129 130 <p>Sur un serveur tr�s sollicit�, il est possible que de nombreuses 131 requ�tes tentent d'acc�der simultan�ment � la m�me connexion au 132 serveur LDAP. Lorsqu'une connexion LDAP est utilis�e, Apache en cr�e 133 une deuxi�me en parall�le � la premi�re, ce qui permet d'�viter que 134 le syst�me de conservation des connexions ne devienne un goulot 135 d'�tranglement.</p> 136 137 <p>Il n'est pas n�cessaire d'activer explicitement la conservation 138 des connexions dans la configuration d'Apache. Tout module utilisant 139 le module ldap pour acc�der aux services LDAP partagera le jeu de 140 connexions.</p> 141 142 <p>Les connexions LDAP peuvent garder la trace des donn�es 143 d'identification du client ldap utilis�es pour l'identification 144 aupr�s du serveur LDAP. Ces donn�es peuvent �tre fournies aux 145 serveurs LDAP qui ne permettent pas les connexions anonymes au cours 146 lors des tentatives de sauts vers des serveurs alternatifs. Pour 147 contr�ler cette fonctionnalit�, voir les directives <code class="directive"><a href="#ldapreferrals">LDAPReferrals</a></code> et <code class="directive"><a href="#ldapreferralhoplimit">LDAPReferralHopLimit</a></code>. Cette 148 fonctionnalit� est activ�e par d�faut.</p> 149</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 150<div class="section"> 151<h2><a name="cache" id="cache">Cache LDAP</a></h2> 152 153 <p>Pour am�liorer les performances, <code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> met en 154 oeuvre une strat�gie de mise en cache agressive visant � minimiser 155 le nombre de fois que le serveur LDAP doit �tre contact�. La mise en 156 cache peut facilement doubler et m�me tripler le d�bit d'Apache 157 lorsqu'il sert des pages prot�g�es par mod_authnz_ldap. De plus, le 158 serveur LDAP verra lui-m�me sa charge sensiblement diminu�e.</p> 159 160 <p><code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> supporte deux types de mise en cache 161 LDAP : un <em>cache recherche/identification</em> durant la phase 162 de recherche/identification et deux <em>caches d'op�rations</em> 163 durant la phase de comparaison. Chaque URL LDAP utilis�e par le 164 serveur a son propre jeu d'instances dans ces trois caches.</p> 165 166 <h3><a name="search-bind" id="search-bind">Le cache 167 recherche/identification</a></h3> 168 <p>Les processus de recherche et d'identification sont les 169 op�rations LDAP les plus consommatrices en temps, en particulier 170 si l'annuaire est de grande taille. Le cache de 171 recherche/identification met en cache toutes les recherches qui 172 ont abouti � une identification positive. Les r�sultats n�gatifs 173 (c'est � dire les recherches sans succ�s, ou les recherches qui 174 n'ont pas abouti � une identification positive) ne sont pas mis en 175 cache. La raison de cette d�cision r�side dans le fait que les 176 connexions avec des donn�es d'identification invalides ne 177 repr�sentent qu'un faible pourcentage du nombre total de 178 connexions, et ainsi, le fait de ne pas mettre en cache les 179 donn�es d'identification invalides r�duira d'autant la taille du 180 cache.</p> 181 182 <p><code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> met en cache le nom d'utilisateur, le 183 DN extrait, le mot de passe utilis� pour l'identification, ainsi 184 que l'heure de l'identification. Chaque fois qu'une nouvelle 185 connexion est initialis�e avec le m�me nom d'utilisateur, 186 <code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> compare le mot de passe de la nouvelle 187 connexion avec le mot de passe enregistr� dans le cache. Si les 188 mots de passe correspondent, et si l'entr�e du cache n'est pas 189 trop ancienne, <code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> court-circuite la phase 190 de recherche/identification.</p> 191 192 <p>Le cache de recherche/identification est contr�l� par les 193 directives <code class="directive"><a href="#ldapcacheentries">LDAPCacheEntries</a></code> et <code class="directive"><a href="#ldapcachettl">LDAPCacheTTL</a></code>.</p> 194 195 196 <h3><a name="opcaches" id="opcaches">Les caches d'op�rations</a></h3> 197 <p>Au cours des op�rations de comparaison d'attributs et de noms 198 distinctifs (DN), <code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> utilise deux caches 199 d'op�rations pour mettre en cache les op�rations de comparaison. 200 Le premier cache de comparaison sert � mettre en cache les 201 r�sultats de comparaisons effectu�es pour v�rifier l'appartenance 202 � un groupe LDAP. Le second cache de comparaison sert � mettre en 203 cache les r�sultats de comparaisons entre DNs.</p> 204 205 <p>Notez que, lorsque l'appartenance � un groupe est v�rifi�e, 206 toute comparaison de sous-groupes est mise en cache afin 207 d'acc�l�rer les comparaisons de sous-groupes ult�rieures.</p> 208 209 <p>Le comportement de ces deux caches est contr�l� par les 210 directives <code class="directive"><a href="#ldapopcacheentries">LDAPOpCacheEntries</a></code> et <code class="directive"><a href="#ldapopcachettl">LDAPOpCacheTTL</a></code>.</p> 211 212 213 <h3><a name="monitoring" id="monitoring">Superviser le cache</a></h3> 214 <p><code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> poss�de un gestionnaire de contenu 215 qui permet aux administrateurs de superviser les performances du 216 cache. Le nom du gestionnaire de contenu est 217 <code>ldap-status</code>, et on peut utiliser les directives 218 suivantes pour acc�der aux informations du cache de 219 <code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> :</p> 220 221 <pre class="prettyprint lang-config"><Location /server/cache-info> 222 SetHandler ldap-status 223</Location></pre> 224 225 226 <p>En se connectant � l'URL 227 <code>http://nom-serveur/infos-cache</code>, l'administrateur peut 228 obtenir un rapport sur le statut de chaque cache qu'utilise 229 <code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code>. Notez que si Apache ne supporte pas la 230 m�moire partag�e, chaque instance de <code class="program"><a href="/programs/httpd.html">httpd</a></code> 231 poss�dera son propre cache, et chaque fois que l'URL sera 232 recharg�e, un r�sultat diff�rent pourra �tre affich�, en fonction 233 de l'instance de <code class="program"><a href="/programs/httpd.html">httpd</a></code> qui traitera la 234 requ�te.</p> 235 236</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 237<div class="section"> 238<h2><a name="usingssltls" id="usingssltls">Utiliser SSL/TLS</a></h2> 239 240 <p>La possibilit� de cr�er des connexions SSL et TLS avec un serveur 241 LDAP est d�finie par les directives <code class="directive"><a href="#ldaptrustedglobalcert"> 242 LDAPTrustedGlobalCert</a></code>, <code class="directive"><a href="#ldaptrustedclientcert"> 243 LDAPTrustedClientCert</a></code> et <code class="directive"><a href="#ldaptrustedmode"> 244 LDAPTrustedMode</a></code>. Ces directives permettent de sp�cifier 245 l'autorit� de certification (CA), les certificats clients �ventuels, 246 ainsi que le type de chiffrement � utiliser pour la connexion (none, 247 SSL ou TLS/STARTTLS).</p> 248 249 <pre class="prettyprint lang-config"># Etablissement d'une connexion SSL LDAP sur le port 636. 250# N�cessite le chargement de mod_ldap et mod_authnz_ldap. 251# Remplacez "votre-domaine.example.com" par le nom de votre 252# domaine. 253 254LDAPTrustedGlobalCert CA_DER /certs/certfile.der 255 256<Location /ldap-status> 257 SetHandler ldap-status 258 259 Require host yourdomain.example.com 260 261 Satisfy any 262 AuthType Basic 263 AuthName "LDAP Protected" 264 AuthBasicProvider ldap 265 AuthLDAPURL ldaps://127.0.0.1/dc=example,dc=com?uid?one 266 Require valid-user 267</Location></pre> 268 269 270 <pre class="prettyprint lang-config"># Etablissement d'une connexion TLS LDAP sur le port 389. 271# N�cessite le chargement de mod_ldap et mod_authnz_ldap. 272# Remplacez "votre-domaine.example.com" par le nom de votre 273# domaine. 274 275LDAPTrustedGlobalCert CA_DER /certs/certfile.der 276 277<Location /ldap-status> 278 SetHandler ldap-status 279 280 Require host yourdomain.example.com 281 282 Satisfy any 283 AuthType Basic 284 AuthName "LDAP Protected" 285 AuthBasicProvider ldap 286 AuthLDAPURL ldap://127.0.0.1/dc=example,dc=com?uid?one TLS 287 Require valid-user 288</Location></pre> 289 290 291</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 292<div class="section"> 293<h2><a name="settingcerts" id="settingcerts">Certificats SSL/TLS</a></h2> 294 295 <p>Les diff�rents SDKs LDAP disposent de nombreuses m�thodes pour 296 d�finir et g�rer les certificats des clients et des autorit�s de 297 certification (CA).</p> 298 299 <p>Si vous avez l'intention d'utiliser SSL ou TLS, lisez cette 300 section ATTENTIVEMENT de fa�on � bien comprendre les diff�rences de 301 configurations entre les diff�rents SDKs LDAP support�s.</p> 302 303 <h3><a name="settingcerts-netscape" id="settingcerts-netscape">SDK Netscape/Mozilla/iPlanet</a></h3> 304 <p>Les certificat de CA sont enregistr�s dans un fichier nomm� 305 cert7.db. Le SDK ne dialoguera avec aucun serveur LDAP dont le 306 certificat n'a pas �t� sign� par une CA sp�cifi�e dans ce 307 fichier. Si des certificats clients sont requis, un fichier 308 key3.db ainsi qu'un mot de passe optionnels peuvent �tre 309 sp�cifi�s. On peut aussi sp�cifier le fichier secmod si 310 n�cessaire. Ces fichiers sont du m�me format que celui utilis� 311 par les navigateurs web Netscape Communicator ou Mozilla. Le 312 moyen le plus simple pour obtenir ces fichiers consiste � les 313 extraire de l'installation de votre navigateur.</p> 314 315 <p>Les certificats clients sont sp�cifi�s pour chaque connexion 316 en utilisant la directive LDAPTrustedClientCert et en se 317 r�f�rant au certificat "nickname". On peut �ventuellement 318 sp�cifier un mot de passe pour d�verrouiller la cl� priv�e du 319 certificat.</p> 320 321 <p>Le SDK supporte seulement SSL. Toute tentative d'utilisation 322 de STARTTLS engendrera une erreur lors des tentatives de 323 contacter le serveur LDAP pendant l'ex�cution.</p> 324 325 <pre class="prettyprint lang-config"># Sp�cifie un fichier de certificats de CA Netscape 326LDAPTrustedGlobalCert CA_CERT7_DB /certs/cert7.db 327# Sp�cifie un fichier key3db optionnel pour le support des 328# certificats clients 329LDAPTrustedGlobalCert CERT_KEY3_DB /certs/key3.db 330# Sp�cifie le fichier secmod si n�cessaire 331LDAPTrustedGlobalCert CA_SECMOD /certs/secmod 332<Location /ldap-status> 333 SetHandler ldap-status 334 335 Require host yourdomain.example.com 336 337 Satisfy any 338 AuthType Basic 339 AuthName "LDAP Protected" 340 AuthBasicProvider ldap 341 LDAPTrustedClientCert CERT_NICKNAME <nickname> [password] 342 AuthLDAPURL ldaps://127.0.0.1/dc=example,dc=com?uid?one 343 Require valid-user 344</Location></pre> 345 346 347 348 349 <h3><a name="settingcerts-novell" id="settingcerts-novell">SDK Novell</a></h3> 350 351 <p>Un ou plusieurs certificats de CA doivent �tre sp�cifi�s pour 352 que le SDK Novell fonctionne correctement. Ces certificats 353 peuvent �tre sp�cifi�s sous forme de fichiers au format binaire 354 DER ou cod�s en Base64 (PEM).</p> 355 356 <p>Note: Les certificats clients sont sp�cifi�s globalement 357 plut�t qu'� chaque connexion, et doivent �tre sp�cifi�s � l'aide 358 de la directive LDAPTrustedGlobalCert comme ci-dessous. D�finir 359 des certificats clients via la directive LDAPTrustedClientCert 360 engendrera une erreur qui sera journalis�e, au moment de la 361 tentative de connexion avec le serveur LDAP.</p> 362 363 <p>Le SDK supporte SSL et STARTTLS, le choix �tant d�fini par le 364 param�tre de la directive LDAPTrustedMode. Si une URL de type 365 ldaps:// est sp�cifi�e, le mode SSL est forc�, et l'emporte sur 366 cette directive.</p> 367 368 <pre class="prettyprint lang-config"># Sp�cifie deux fichiers contenant des certificats de CA 369LDAPTrustedGlobalCert CA_DER /certs/cacert1.der 370LDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem 371# Sp�cifie un fichier contenant des certificats clients 372# ainsi qu'une cl� 373LDAPTrustedGlobalCert CERT_BASE64 /certs/cert1.pem 374LDAPTrustedGlobalCert KEY_BASE64 /certs/key1.pem [password] 375# N'utilisez pas cette directive, sous peine de provoquer 376# une erreur 377#LDAPTrustedClientCert CERT_BASE64 /certs/cert1.pem</pre> 378 379 380 381 382 <h3><a name="settingcerts-openldap" id="settingcerts-openldap">SDK OpenLDAP</a></h3> 383 384 <p>Un ou plusieurs certificats de CA doivent �tre sp�cifi�s pour 385 que le SDK OpenLDAP fonctionne correctement. Ces certificats 386 peuvent �tre sp�cifi�s sous forme de fichiers au format binaire 387 DER ou cod�s en Base64 (PEM).</p> 388 389 <p>Les certificats clients sont sp�cifi�s pour chaque connexion 390 � l'aide de la directive LDAPTrustedClientCert.</p> 391 392 <p>La documentation du SDK pr�tend que SSL et STARTTLS sont 393 support�s ; cependant, STARTTLS semble ne pas fonctionner avec 394 toutes les versions du SDK. Le mode SSL/TLS peut �tre d�fini en 395 utilisant le param�tre de la directive LDAPTrustedMode. Si une 396 URL de type 397 ldaps:// est sp�cifi�e, le mode SSL est forc�. La documentation 398 OpenLDAP indique que le support SSL (ldaps://) tend � �tre 399 remplac� par TLS, bien que le mode SSL fonctionne toujours.</p> 400 401 <pre class="prettyprint lang-config"># Sp�cifie deux fichiers contenant des certificats de CA 402LDAPTrustedGlobalCert CA_DER /certs/cacert1.der 403LDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem 404<Location /ldap-status> 405 SetHandler ldap-status 406 407 Require host yourdomain.example.com 408 409 LDAPTrustedClientCert CERT_BASE64 /certs/cert1.pem 410 LDAPTrustedClientCert KEY_BASE64 /certs/key1.pem 411 # CA certs respecified due to per-directory client certs 412 LDAPTrustedClientCert CA_DER /certs/cacert1.der 413 LDAPTrustedClientCert CA_BASE64 /certs/cacert2.pem 414 Satisfy any 415 AuthType Basic 416 AuthName "LDAP Protected" 417 AuthBasicProvider ldap 418 AuthLDAPURL ldaps://127.0.0.1/dc=example,dc=com?uid?one 419 Require valid-user 420</Location></pre> 421 422 423 424 425 <h3><a name="settingcerts-solaris" id="settingcerts-solaris">SDK Solaris</a></h3> 426 427 <p>SSL/TLS pour les biblioth�ques LDAP propres � Solaris n'est 428 pas encore support�. Si n�cessaire, installez et utilisez plut�t 429 les biblioth�ques OpenLDAP.</p> 430 431 432 433 <h3><a name="settingcerts-microsoft" id="settingcerts-microsoft">SDK Microsoft</a></h3> 434 435 <p>La configuration des certificats SSL/TLS pour les 436 biblioth�ques LDAP propres � Microsoft s'effectue � l'int�rieur 437 du registre syst�me, et aucune directive de configuration n'est 438 requise.</p> 439 440 <p>SSL et TLS sont tous deux support�s en utilisant des URLs de 441 type ldaps://, ou en d�finissant la directive LDAPTrustedMode � 442 cet effet.</p> 443 444 <p>Note: L'�tat du support des certificats clients n'est pas 445 encore connu pour ce SDK.</p> 446 447 448 449</div> 450<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 451<div class="directive-section"><h2><a name="LDAPCacheEntries" id="LDAPCacheEntries">LDAPCacheEntries</a> <a name="ldapcacheentries" id="ldapcacheentries">Directive</a></h2> 452<table class="directive"> 453<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum d'entr�es dans le cache LDAP 454primaire</td></tr> 455<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPCacheEntries <var>nombre</var></code></td></tr> 456<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPCacheEntries 1024</code></td></tr> 457<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 458<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 459<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 460</table> 461 <p>Cette directive permet de sp�cifier la taille maximale du cache 462 LDAP primaire. Ce cache contient les r�sultats de 463 recherche/identification positifs. D�finissez-la � 0 pour d�sactiver 464 la mise en cache des r�sultats de recherche/identification positifs. 465 La taille par d�faut est de 1024 recherches en cache.</p> 466 467</div> 468<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 469<div class="directive-section"><h2><a name="LDAPCacheTTL" id="LDAPCacheTTL">LDAPCacheTTL</a> <a name="ldapcachettl" id="ldapcachettl">Directive</a></h2> 470<table class="directive"> 471<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dur�e pendant laquelle les entr�es du cache restent 472valides.</td></tr> 473<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPCacheTTL <var>secondes</var></code></td></tr> 474<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPCacheTTL 600</code></td></tr> 475<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 476<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 477<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 478</table> 479 <p>Cette directive permet de sp�cifier la dur�e (en secondes) 480 pendant laquelle une entr�e du cache de recherche/identification 481 reste valide. La valeur par d�faut est de 600 secondes (10 482 minutes).</p> 483 484</div> 485<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 486<div class="directive-section"><h2><a name="LDAPConnectionPoolTTL" id="LDAPConnectionPoolTTL">LDAPConnectionPoolTTL</a> <a name="ldapconnectionpoolttl" id="ldapconnectionpoolttl">Directive</a></h2> 487<table class="directive"> 488<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�sactive les connexions d'arri�re-plan qui sont rest�es 489inactives trop longtemps au sein du jeu de connexions.</td></tr> 490<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPConnectionPoolTTL <var>n</var></code></td></tr> 491<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPConnectionPoolTTL -1</code></td></tr> 492<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 493<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 494<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 495<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible � partir de la version 2.3.12 du serveur HTTP 496Apache</td></tr> 497</table> 498 <p>Cette directive permet de sp�cifier la dur�e maximale, en 499 secondes, pendant laquelle une connexion LDAP du jeu de connexions 500 peut demeurer inactive, mais rester quand-m�me disponible pour une 501 utilisation �ventuelle. Le jeu de connexions est nettoy� au fur et � 502 mesure des besoins, de mani�re non asynchrone.</p> 503 504 <p>Si cette directive est d�finie � 0, les connexions ne sont jamais 505 sauvegard�es dans le jeu de connexions d'arri�re-plan. Avec la 506 valeur par d�faut -1, ou toute autre valeur n�gative, les connexions 507 peuvent �tre r�utilis�es sans limite de dur�e.</p> 508 509 <p>La dur�e de vie est bas�e sur le moment o� la connexion LDAP est 510 remise en attente dans le jeu de connexions , et non sur la derni�re 511 entr�e/sortie effectu�e sur le serveur d'arri�re-plan. Si 512 l'information est mise en cache, la dur�e d'inactivit� apparente 513 peut exc�der la valeur de la directive 514 <code class="directive">LDAPConnectionPoolTTL</code>.</p> 515 516 <div class="note"><p>Cette dur�e de vie s'exprime par d�faut en secondes, mais 517 il est possible d'utiliser d'autres unit�s en ajoutant un suffixe : 518 millisecondes (ms), minutes (min), ou heures (h). 519 </p></div> 520 521</div> 522<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 523<div class="directive-section"><h2><a name="LDAPConnectionTimeout" id="LDAPConnectionTimeout">LDAPConnectionTimeout</a> <a name="ldapconnectiontimeout" id="ldapconnectiontimeout">Directive</a></h2> 524<table class="directive"> 525<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp�cifie le d�lai d'attente en secondes de la socket de 526connexion</td></tr> 527<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPConnectionTimeout <var>secondes</var></code></td></tr> 528<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 529<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 530<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 531</table> 532 <p>Cette directive configure l'option LDAP_OPT_NETWORK_TIMEOUT (ou 533 LDAP_OPT_CONNECT_TIMEOUT) dans la biblioth�que client LDAP 534 sous-jacente, si elle est disponible. Cette valeur repr�sente la 535 dur�e pendant laquelle la biblioth�que client LDAP va attendre que 536 le processus de connexion TCP au serveur LDAP soit achev�.</p> 537 538 <p>Si la connexion n'a pas r�ussi avant ce d�lai, une erreur sera 539 renvoy�e, ou la biblioth�que client LDAP tentera de se connecter � 540 un second serveur LDAP, s'il en a �t� d�fini un (via une liste de 541 noms d'h�tes s�par�s par des espaces dans la directive <code class="directive"><a href="/mod/mod_authnz_ldap.html#authldapurl">AuthLDAPURL</a></code>).</p> 542 543 <p>La valeur par d�faut est 10 secondes, si la biblioth�que client 544 LDAP li�e avec le serveur supporte l'option 545 LDAP_OPT_NETWORK_TIMEOUT.</p> 546 547 <div class="note">LDAPConnectionTimeout n'est disponible que si la biblioth�que client 548 LDAP li�e avec le serveur supporte l'option 549 LDAP_OPT_NETWORK_TIMEOUT (ou LDAP_OPT_CONNECT_TIMEOUT), et le 550 comportement final est enti�rement dict� par la biblioth�que client 551 LDAP. 552 </div> 553 554</div> 555<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 556<div class="directive-section"><h2><a name="LDAPLibraryDebug" id="LDAPLibraryDebug">LDAPLibraryDebug</a> <a name="ldaplibrarydebug" id="ldaplibrarydebug">Directive</a></h2> 557<table class="directive"> 558<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le d�bogage dans le SDK LDAP</td></tr> 559<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPLibraryDebug <var>7</var></code></td></tr> 560<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>disabled</code></td></tr> 561<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 562<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 563<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 564</table> 565 <p>Active les options de d�bogage LDAP sp�cifiques au SDK, qui 566 entra�nent en g�n�ral une journalisation d'informations verbeuses du 567 SDK LDAP dans le journal principal des erreurs d'Apache. Les 568 messages de traces en provenance du SDK LDAP fournissent des 569 informations tr�s d�taill�es qui peuvent s'av�rer utiles lors du 570 d�bogage des probl�mes de connexion avec des serveurs LDAP 571 d'arri�re-plan.</p> 572 573 <p>Cette option n'est configurable que lorsque le serveur HTTP 574 Apache est li� avec un SDK LDAP qui impl�mente 575 <code>LDAP_OPT_DEBUG</code> ou <code>LDAP_OPT_DEBUG_LEVEL</code>, 576 comme OpenLDAP (une valeur de 7 est verbeuse) ou Tivoli Directory 577 Server (une valeur de 65535 est verbeuse).</p> 578 579 <div class="warning"> 580 <p>Les informations journalis�es peuvent contenir des donn�es 581 d'authentification en clair utilis�es ou valid�es lors de 582 l'authentification LDAP ; vous devez donc prendre soin de prot�ger 583 et de purger le journal des erreurs lorsque cette directive est 584 utilis�e.</p> 585 </div> 586 587 588</div> 589<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 590<div class="directive-section"><h2><a name="LDAPOpCacheEntries" id="LDAPOpCacheEntries">LDAPOpCacheEntries</a> <a name="ldapopcacheentries" id="ldapopcacheentries">Directive</a></h2> 591<table class="directive"> 592<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre d'entr�es utilis�es pour mettre en cache les 593op�rations de comparaison LDAP</td></tr> 594<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPOpCacheEntries <var>nombre</var></code></td></tr> 595<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPOpCacheEntries 1024</code></td></tr> 596<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 597<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 598<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 599</table> 600 <p>Cette directive permet de sp�cifier le nombre d'entr�es que 601 <code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> va utiliser pour mettre en cache les 602 op�rations de comparaison LDAP. La valeur par d�faut est de 1024 603 entr�es. Si elle est d�finie � 0, la mise en cache des op�rations de 604 comparaison LDAP est d�sactiv�e.</p> 605 606</div> 607<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 608<div class="directive-section"><h2><a name="LDAPOpCacheTTL" id="LDAPOpCacheTTL">LDAPOpCacheTTL</a> <a name="ldapopcachettl" id="ldapopcachettl">Directive</a></h2> 609<table class="directive"> 610<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dur�e pendant laquelle les entr�es du cache d'op�rations 611restent valides</td></tr> 612<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPOpCacheTTL <var>secondes</var></code></td></tr> 613<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPOpCacheTTL 600</code></td></tr> 614<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 615<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 616<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 617</table> 618 <p>Cette directive permet de sp�cifier la dur�e (en secondes) 619 pendant laquelle les entr�es du cache d'op�rations restent valides. 620 La valeur par d�faut est de 600 secondes.</p> 621 622</div> 623<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 624<div class="directive-section"><h2><a name="LDAPReferralHopLimit" id="LDAPReferralHopLimit">LDAPReferralHopLimit</a> <a name="ldapreferralhoplimit" id="ldapreferralhoplimit">Directive</a></h2> 625<table class="directive"> 626<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre maximum de redirections vers des serveurs 627alternatifs (referrals) avant l'abandon de la requ�te 628LDAP.</td></tr> 629<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPReferralHopLimit <var>nombre</var></code></td></tr> 630<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>D�pend du SDK, en g�n�ral entre 5 et 10</code></td></tr> 631<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 632<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr> 633<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 634<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 635</table> 636 <p>Si elle est activ�e par la directive <code>LDAPReferrals</code>, 637 cette directive permet de d�finir le nombre maximum de sauts vers 638 des serveurs alternatifs (referrals) avant l'abandon de la requ�te 639 LDAP.</p> 640 641<div class="warning"> 642<p>L'ajustement de ce param�tre n'est pas commun � tous les SDKs LDAP.</p> 643</div> 644 645</div> 646<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 647<div class="directive-section"><h2><a name="LDAPReferrals" id="LDAPReferrals">LDAPReferrals</a> <a name="ldapreferrals" id="ldapreferrals">Directive</a></h2> 648<table class="directive"> 649<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la redirection vers des serveurs alternatifs au 650cours des requ�tes vers le serveur LDAP.</td></tr> 651<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPReferrals <var>On|Off|default</var></code></td></tr> 652<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPReferrals On</code></td></tr> 653<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 654<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr> 655<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 656<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 657</table> 658 <p>Certains serveurs LDAP partagent leur annuaire en plusieurs 659 domaines et utilisent le syst�me des redirections (referrals) pour 660 aiguiller un client lorsque les limites d'un domaine doivent �tre 661 franchies. Ce processus est similaire � une redirection HTTP. Les 662 biblioth�ques client LDAP ne respectent pas forc�ment ces 663 redirections par d�faut. Cette directive permet de configurer 664 explicitement les redirections LDAP dans le SDK sous-jacent.</p> 665 666 <p>La directive <code class="directive">LDAPReferrals</code> accepte les 667 valeurs suivantes :</p> 668 669 <dl> 670 <dt>"on"</dt> 671 <dd> <p>Avec la valeur "on", la prise en compte des redirections 672 LDAP par le SDK sous-jacent est activ�e, la directive 673 <code class="directive">LDAPReferralHopLimit</code> permet de surcharger la 674 "hop limit" du SDK, et un "LDAP rebind callback" est enregistr�.</p></dd> 675 <dt>"off"</dt> 676 <dd> <p>Avec la valeur "off", la prise en compte des redirections 677 LDAP par le SDK sous-jacent est compl�tement d�sactiv�e.</p></dd> 678 <dt>"default"</dt> 679 <dd> <p>Avec la valeur "default", la prise en compte des redirections 680 LDAP par le SDK sous-jacent n'est pas modifi�e, la directive 681 <code class="directive">LDAPReferralHopLimit</code> ne permet pas de surcharger la 682 "hop limit" du SDK, et aucun "LDAP rebind callback" n'est enregistr�.</p></dd> 683 </dl> 684 685 <p>La directive <code>LDAPReferralHopLimit</code> travaille en 686 conjonction avec cette directive pour limiter le nombre de 687 redirections � suivre pour achever le traitement de la requ�te LDAP. 688 Lorsque le processus de redirection est activ� par la valeur "On", 689 les donn�es d'authentification du client sont transmises via un 690 "rebind callback" � tout serveur LDAP qui en fait la demande.</p> 691 692</div> 693<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 694<div class="directive-section"><h2><a name="LDAPRetries" id="LDAPRetries">LDAPRetries</a> <a name="ldapretries" id="ldapretries">Directive</a></h2> 695<table class="directive"> 696<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le nombre maximum de tentatives de connexions au 697serveur LDAP.</td></tr> 698<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPRetries <var>nombre d'essais</var></code></td></tr> 699<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPRetries 3</code></td></tr> 700<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 701<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 702<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 703</table> 704 <p>Suite � des �checs de connexion au serveur LDAP, le serveur 705 tentera de se connecter autant de fois qu'indiqu� par la directive 706 <code class="directive">LDAPRetries</code>. Si cette directive est d�finie � 707 0, le serveur ne tentera pas d'autre connexion apr�s un �chec.</p> 708 <p>Il est possible d'effectuer une autre tentative de connexion en 709 cas d'erreurs LDAP du type d�lai d�pass� ou connexion refus�e. </p> 710 711</div> 712<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 713<div class="directive-section"><h2><a name="LDAPRetryDelay" id="LDAPRetryDelay">LDAPRetryDelay</a> <a name="ldapretrydelay" id="ldapretrydelay">Directive</a></h2> 714<table class="directive"> 715<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le temps d'attente avant un autre essai de connexion au 716serveur LDAP.</td></tr> 717<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPRetryDelay <var>secondes</var></code></td></tr> 718<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPRetryDelay 0</code></td></tr> 719<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 720<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 721<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 722</table> 723 <p>Si la directive <code class="directive">LDAPRetryDelay</code> est d�finie 724 � une valeur diff�rente de 0, le serveur attendra pendant la dur�e 725 sp�cifi�e pour envoyer � nouveau sa requ�te LDAP. Une valeur de 0 726 implique une absence de d�lai pour les essais successifs.</p> 727 728 <p>Il est possible d'effectuer une autre tentative de connexion en 729 cas d'erreurs LDAP du type d�lai d�pass� ou connexion refus�e. </p> 730 731</div> 732<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 733<div class="directive-section"><h2><a name="LDAPSharedCacheFile" id="LDAPSharedCacheFile">LDAPSharedCacheFile</a> <a name="ldapsharedcachefile" id="ldapsharedcachefile">Directive</a></h2> 734<table class="directive"> 735<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le fichier du cache en m�moire 736partag�e</td></tr> 737<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPSharedCacheFile <var>chemin/fichier</var></code></td></tr> 738<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 739<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 740<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 741</table> 742 <p>Cette directive permet de sp�cifier le chemin du 743 fichier du cache en m�moire partag�e. Si elle n'est pas d�finie, la 744 m�moire partag�e anonyme sera utilis�e si la plate-forme la 745 supporte.</p> 746 747 748</div> 749<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 750<div class="directive-section"><h2><a name="LDAPSharedCacheSize" id="LDAPSharedCacheSize">LDAPSharedCacheSize</a> <a name="ldapsharedcachesize" id="ldapsharedcachesize">Directive</a></h2> 751<table class="directive"> 752<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille en octets du cache en m�moire partag�e</td></tr> 753<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPSharedCacheSize <var>octets</var></code></td></tr> 754<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPSharedCacheSize 500000</code></td></tr> 755<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 756<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 757<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 758</table> 759 <p>Cette directive permet de sp�cifier le nombre d'octets � allouer 760 pour le cache en m�moire partag�e. La valeur par 761 d�faut est 500kb. 762 Si elle est d�finie � 0, le cache en m�moire partag�e ne sera pas 763 utilis� et chaque processus HTTPD va cr�er son propre cache.</p> 764 765</div> 766<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 767<div class="directive-section"><h2><a name="LDAPTimeout" id="LDAPTimeout">LDAPTimeout</a> <a name="ldaptimeout" id="ldaptimeout">Directive</a></h2> 768<table class="directive"> 769<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp�cifie le d�lai d'attente pour les op�rations de 770recherche et d'identification LDAP en secondes</td></tr> 771<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTimeout <var>secondes</var></code></td></tr> 772<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPTimeout 60</code></td></tr> 773<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 774<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 775<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 776<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible � partir de la version 2.3.5 du serveur HTTP 777Apache</td></tr> 778</table> 779 <p>Cette directive permet de sp�cifier le d�lai d'attente pour les 780 op�rations de recherche et d'identification, ainsi que l'option 781 LDAP_OPT_TIMEOUT dans la biblioth�que LDAP client sous-jacente, 782 lorsqu'elle est disponible.</p> 783 784 <p>Lorsque le d�lai est atteint, httpd va refaire un essai dans le 785 cas o� une connexion existante a �t� silencieusement ferm�e par un 786 pare-feu. Les performances seront cependant bien meilleures si le 787 pare-feu est configur� pour envoyer des paquets TCP RST au lieu de 788 rejeter silencieusement les paquets.</p> 789 790 <div class="note"> 791 <p>Les d�lais pour les op�rations de comparaison LDAP n�cessitent un 792 SDK avec LDAP_OPT_TIMEOUT, comme OpenLDAP >= 2.4.4.</p> 793 </div> 794 795 796</div> 797<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 798<div class="directive-section"><h2><a name="LDAPTrustedClientCert" id="LDAPTrustedClientCert">LDAPTrustedClientCert</a> <a name="ldaptrustedclientcert" id="ldaptrustedclientcert">Directive</a></h2> 799<table class="directive"> 800<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le nom de fichier contenant un certificat client ou 801un alias renvoyant vers un certificat client sp�cifique � une connexion. 802Tous les SDK LDAP ne supportent pas les certificats clients par 803connexion.</td></tr> 804<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTrustedClientCert <var>type</var> 805<var>chemin/nom-fichier/alias</var> <var>[mot de passe]</var></code></td></tr> 806<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 807<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 808<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 809</table> 810 <p>Cette directive permet de sp�cifier le chemin et le nom de 811 fichier ou l'alias d'un certificat client par connexion utilis� lors 812 de l'�tablissement d'une connexion SSL ou TLS avec un serveur LDAP. 813 Les sections directory ou location peuvent poss�der leurs propres 814 configurations de certificats clients. Certains SDK LDAP (en 815 particulier Novell) ne supportent pas les certificats clients par 816 connexion, et renvoient une erreur lors de la connexion au serveur 817 LDAP si vous tenter d'utiliser cette directive (Utilisez � la place 818 la directive LDAPTrustedGlobalCert pour les certificats clients sous 819 Novell - Voir plus haut le guide des certificats SSL/TLS pour plus 820 de d�tails). Le param�tre type sp�cifie le type du certificat en 821 cours de d�finition, en fonction du SDK LDAP utilis�. Les types 822 support�s sont :</p> 823 <ul> 824 <li>CA_DER - certificat de CA cod� en binaire DER</li> 825 <li>CA_BASE64 - certificat de CA cod� en PEM</li> 826 <li>CERT_DER - certificat client cod� en binaire DER</li> 827 <li>CERT_BASE64 - certificat client cod� en PEM</li> 828 <li>CERT_NICKNAME - certificat client "nickname" (SDK Netscape)</li> 829 <li>KEY_DER - cl� priv�e cod�e en binaire DER</li> 830 <li>KEY_BASE64 - cl� priv�e cod�e en PEM</li> 831 </ul> 832 833</div> 834<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 835<div class="directive-section"><h2><a name="LDAPTrustedGlobalCert" id="LDAPTrustedGlobalCert">LDAPTrustedGlobalCert</a> <a name="ldaptrustedglobalcert" id="ldaptrustedglobalcert">Directive</a></h2> 836<table class="directive"> 837<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le nom de fichier ou la base de donn�es contenant 838les Autorit�s de Certification de confiance globales ou les certificats 839clients globaux</td></tr> 840<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTrustedGlobalCert <var>type</var> 841<var>chemin/nom-fichier</var> <var>[mot de passe]</var></code></td></tr> 842<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 843<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 844<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 845</table> 846 <p>Cette directive permet de sp�cifier le chemin et le nom du 847 fichier contenant les certificats des CA de confiance et/ou les 848 certificats clients du syst�me global que <code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code> 849 utilisera pour �tablir une connexion SSL ou TLS avec un serveur 850 LDAP. Notez que toute information relative aux certificats sp�cifi�e 851 en utilisant cette directive s'applique globalement � l'ensemble de 852 l'installation du serveur. Certains SDK LDAP (en particulier Novell) 853 n�cessitent la d�finition globale de tous les certificats clients en 854 utilisant cette directive. La plupart des autres SDK n�cessitent la 855 d�finition des certificats clients dans une section Directory ou 856 Location en utilisant la directive LDAPTrustedClientCert. Si vous ne 857 d�finissez pas ces directives correctement, une erreur sera g�n�r�e 858 lors des tentatives de contact avec un serveur LDAP, ou la connexion 859 �chouera silencieusement (Voir plus haut le guide des certificats 860 SSL/TLS pour plus de d�tails). Le param�tre type sp�cifie le type de 861 certificat en cours de d�finition, en fonction du SDK LDAP utilis�. 862 Les types support�s sont :</p> 863 <ul> 864 <li>CA_DER - certificat de CA cod� en binaire DER</li> 865 <li>CA_BASE64 - certificat de CA cod� en PEM</li> 866 <li>CA_CERT7_DB - fichier de base de donn�es des certificats de CA 867 de Netscape cert7.db</li> 868 <li>CA_SECMOD - fichier de base de donn�es secmod de Netscape</li> 869 <li>CERT_DER - certificat client cod� en binaire DER</li> 870 <li>CERT_BASE64 - certificat client cod� en PEM</li> 871 <li>CERT_KEY3_DB - fichier de base de donn�es des certificats 872 clients de Netscape key3.db</li> 873 <li>CERT_NICKNAME - certificat client "nickname" (SDK Netscape)</li> 874 <li>CERT_PFX - certificat client cod� en PKCS#12 (SDK Novell)</li> 875 <li>KEY_DER - cl� priv�e cod�e en binaire DER</li> 876 <li>KEY_BASE64 - cl� priv�e cod�e en PEM</li> 877 <li>KEY_PFX - cl� priv�e cod�e en PKCS#12 (SDK Novell)</li> 878 </ul> 879 880</div> 881<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 882<div class="directive-section"><h2><a name="LDAPTrustedMode" id="LDAPTrustedMode">LDAPTrustedMode</a> <a name="ldaptrustedmode" id="ldaptrustedmode">Directive</a></h2> 883<table class="directive"> 884<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp�cifie le mode (SSL ou TLS) � utiliser lors de la 885connexion � un serveur LDAP.</td></tr> 886<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPTrustedMode <var>type</var></code></td></tr> 887<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 888<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 889<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 890</table> 891 <p>Les modes suivants sont support�s :</p> 892 <ul> 893 <li>NONE - aucun chiffrement</li> 894 <li>SSL - chiffrement ldaps:// sur le port par d�faut 636</li> 895 <li>TLS - chiffrement STARTTLS sur le port par d�faut 389</li> 896 </ul> 897 898 <p>Les modes ci-dessus ne sont pas support�s par tous les SDK LDAP. 899 Un message d'erreur sera g�n�r� � l'ex�cution si un mode n'est pas 900 support�, et la connexion au serveur LDAP �chouera. 901 </p> 902 903 <p>Si une URL de type ldaps:// est sp�cifi�e, le mode est forc� � 904 SSL et la d�finition de LDAPTrustedMode est ignor�e.</p> 905 906</div> 907<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 908<div class="directive-section"><h2><a name="LDAPVerifyServerCert" id="LDAPVerifyServerCert">LDAPVerifyServerCert</a> <a name="ldapverifyservercert" id="ldapverifyservercert">Directive</a></h2> 909<table class="directive"> 910<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force la v�rification du certificat du 911serveur</td></tr> 912<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LDAPVerifyServerCert <var>On|Off</var></code></td></tr> 913<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LDAPVerifyServerCert On</code></td></tr> 914<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 915<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> 916<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ldap</td></tr> 917</table> 918 <p>Cette directive permet de sp�cifier s'il faut forcer la 919 v�rification d'un certificat de serveur lors de l'�tablissement 920 d'une connexion SSL avec un serveur LDAP.</p> 921 922</div> 923</div> 924<div class="bottomlang"> 925<p><span>Langues Disponibles: </span><a href="/en/mod/mod_ldap.html" hreflang="en" rel="alternate" title="English"> en </a> | 926<a href="/fr/mod/mod_ldap.html" title="Fran�ais"> fr </a></p> 927</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> 928<script type="text/javascript"><!--//--><![CDATA[//><!-- 929var comments_shortname = 'httpd'; 930var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_ldap.html'; 931(function(w, d) { 932 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 933 d.write('<div id="comments_thread"><\/div>'); 934 var s = d.createElement('script'); 935 s.type = 'text/javascript'; 936 s.async = true; 937 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 938 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 939 } 940 else { 941 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 942 } 943})(window, document); 944//--><!]]></script></div><div id="footer"> 945<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 946<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.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[//><!-- 947if (typeof(prettyPrint) !== 'undefined') { 948 prettyPrint(); 949} 950//--><!]]></script> 951</body></html>