mod_ldap.xml.fr revision e04d06603a7abd1090421cbc961685d5468f1039
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<?xml version="1.0"?>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<!-- English Revision: 1358946:1380533 (outdated) -->
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<!-- French translation : Lucien GENTIS -->
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<!-- Reviewed by : Vincent Deffontaines -->
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end<!--
5a58787efeb02a1c3f06569d019ad81fd2efa06end Licensed to the Apache Software Foundation (ASF) under one or more
5a58787efeb02a1c3f06569d019ad81fd2efa06end contributor license agreements. See the NOTICE file distributed with
5a58787efeb02a1c3f06569d019ad81fd2efa06end this work for additional information regarding copyright ownership.
5a58787efeb02a1c3f06569d019ad81fd2efa06end The ASF licenses this file to You under the Apache License, Version 2.0
5a58787efeb02a1c3f06569d019ad81fd2efa06end (the "License"); you may not use this file except in compliance with
3f08db06526d6901aa08c110b5bc7dde6bc39905nd the License. You may obtain a copy of the License at
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end http://www.apache.org/licenses/LICENSE-2.0
5a58787efeb02a1c3f06569d019ad81fd2efa06end
3f08db06526d6901aa08c110b5bc7dde6bc39905nd Unless required by applicable law or agreed to in writing, software
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd distributed under the License is distributed on an "AS IS" BASIS,
a78048ccbdb6256da15e6b0e7e95355e480c2301nd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
5e740829c3448285963d3882530669f0112cf690gryzor See the License for the specific language governing permissions and
aee1f193a276866212922ae5072e3014db28582frpluem limitations under the License.
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung-->
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<modulesynopsis metafile="mod_ldap.xml.meta">
aee1f193a276866212922ae5072e3014db28582frpluem
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele<name>mod_ldap</name>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<description>Conservation des connexions LDAP et services de mise en
5a58787efeb02a1c3f06569d019ad81fd2efa06endcache du r&eacute;sultat &agrave; destination des autres modules LDAP</description>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive<status>Extension</status>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<sourcefile>util_ldap.c</sourcefile>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<identifier>ldap_module</identifier>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<compatibility>Disponible &agrave; partir de la version 2.0.41
5a58787efeb02a1c3f06569d019ad81fd2efa06endd'Apache</compatibility>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end<summary>
df321386f1d9ed17a3e5e6468807996a12890d50gryzor <p>Ce module a &eacute;t&eacute; con&ccedil;u dans le but d'am&eacute;liorer les performances
5a58787efeb02a1c3f06569d019ad81fd2efa06end des sites web s'appuyant sur des connexions en arri&egrave;re-plan vers des
5a58787efeb02a1c3f06569d019ad81fd2efa06end serveurs LDAP. Il ajoute aux fonctions fournies par les
5a58787efeb02a1c3f06569d019ad81fd2efa06end biblioth&egrave;ques standards LDAP la conservation des connexions LDAP
5a58787efeb02a1c3f06569d019ad81fd2efa06end ainsi qu'un cache LDAP partag&eacute; en m&eacute;moire.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>Pour activer ce module, le support LDAP doit &ecirc;tre compil&eacute; dans
5a58787efeb02a1c3f06569d019ad81fd2efa06end apr-util. Pour ce faire, on ajoute l'option <code>--with-ldap</code>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive au script <program>configure</program> lorsqu'on construit
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive Apache.</p>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive <p>Le support SSL/TLS est conditionn&eacute; par le kit de d&eacute;veloppement
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive LDAP qui a &eacute;t&eacute; li&eacute; &agrave; <glossary>APR</glossary>. Au moment o&ugrave; ces
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive lignes sont &eacute;crites, APR-util supporte <a
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive href="http://www.openldap.org/">OpenLDAP SDK</a> (version 2.x ou
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive sup&eacute;rieure), <a
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive href="http://developer.novell.com/ndk/cldap.htm">Novell LDAP
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive SDK</a>, <a href="http://www.mozilla.org/directory/csdk.html">
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive Mozilla LDAP SDK</a>, le SDK LDAP propre &agrave; Solaris (bas&eacute; sur
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive Mozilla), le SDK LDAP propre &agrave; Microsoft, ou le SDK <a
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive href="http://www.iplanet.com/downloads/developer/">iPlanet
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive (Netscape)</a>. Voir le site web <a
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive href="http://apr.apache.org">APR</a> pour plus de d&eacute;tails.</p>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive</summary>
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive
5a58787efeb02a1c3f06569d019ad81fd2efa06end<section id="exampleconfig"><title>Exemple de configuration</title>
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>Ce qui suit est un exemple de configuration qui utilise
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <module>mod_ldap</module> pour am&eacute;liorer les performances de
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive l'authentification HTTP de base fournie par
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <module>mod_authnz_ldap</module>.</p>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive
06d77ae37da42a6f8bbea25b7d7f8b6629245629slive <highlight language="config">
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive# Active la conservation des connexions LDAP et le cache partag&eacute; en
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive# m&eacute;moire. Active le gestionnaire de statut du cache LDAP.
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive# N&eacute;cessite le chargement de mod_ldap et de mod_authnz_ldap.
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive# Remplacez "votre-domaine.example.com" par le nom de votre
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive# domaine.
c6f41bc69d643835804e7e831776d3d46c6f5962slive
c6f41bc69d643835804e7e831776d3d46c6f5962sliveLDAPSharedCacheSize 500000
c6f41bc69d643835804e7e831776d3d46c6f5962sliveLDAPCacheEntries 1024
c6f41bc69d643835804e7e831776d3d46c6f5962sliveLDAPCacheTTL 600
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluemLDAPOpCacheEntries 1024
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluemLDAPOpCacheTTL 600
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive&lt;Location /ldap-status&gt;
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive SetHandler ldap-status
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive Require host yourdomain.example.com
263168fdb45221efa79580de89bdde883b7561f7sf
263168fdb45221efa79580de89bdde883b7561f7sf Satisfy any
263168fdb45221efa79580de89bdde883b7561f7sf AuthType Basic
263168fdb45221efa79580de89bdde883b7561f7sf AuthName "LDAP Protected"
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive AuthBasicProvider ldap
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive AuthLDAPURL ldap://127.0.0.1/dc=example,dc=com?uid?one
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem Require valid-user
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem&lt;/Location&gt;
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem </highlight>
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem</section>
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem<section id="pool"><title>Conservation des connexions LDAP</title>
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem <p>Les connexions LDAP sont conserv&eacute;es de requ&ecirc;te en requ&ecirc;te. Ceci
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem permet de rester connect&eacute; et identifi&eacute; au serveur LDAP, ce dernier
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem &eacute;tant ainsi pr&ecirc;t pour la prochaine requ&ecirc;te, sans avoir &agrave; se
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem d&eacute;connecter, reconnecter et r&eacute;identifier. Le gain en performances
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem est similaire &agrave; celui des connexions persistantes (keepalives)
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem HTTP.</p>
c6f41bc69d643835804e7e831776d3d46c6f5962slive
aee1f193a276866212922ae5072e3014db28582frpluem <p>Sur un serveur tr&egrave;s sollicit&eacute;, il est possible que de nombreuses
c6f41bc69d643835804e7e831776d3d46c6f5962slive requ&ecirc;tes tentent d'acc&eacute;der simultan&eacute;ment &agrave; la m&ecirc;me connexion au
c6f41bc69d643835804e7e831776d3d46c6f5962slive serveur LDAP. Lorsqu'une connexion LDAP est utilis&eacute;e, Apache en cr&eacute;e
06d77ae37da42a6f8bbea25b7d7f8b6629245629slive une deuxi&egrave;me en parall&egrave;le &agrave; la premi&egrave;re, ce qui permet d'&eacute;viter que
c6f41bc69d643835804e7e831776d3d46c6f5962slive le syst&egrave;me de conservation des connexions ne devienne un goulot
c6f41bc69d643835804e7e831776d3d46c6f5962slive d'&eacute;tranglement.</p>
c6f41bc69d643835804e7e831776d3d46c6f5962slive
c6f41bc69d643835804e7e831776d3d46c6f5962slive <p>Il n'est pas n&eacute;cessaire d'activer explicitement la conservation
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive des connexions dans la configuration d'Apache. Tout module utilisant
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive le module ldap pour acc&eacute;der aux services LDAP partagera le jeu de
c6f41bc69d643835804e7e831776d3d46c6f5962slive connexions.</p>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <p>Les connexions LDAP peuvent garder la trace des donn&eacute;es
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive d'identification du client ldap utilis&eacute;es pour l'identification
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive aupr&egrave;s du serveur LDAP. Ces donn&eacute;es peuvent &ecirc;tre fournies aux
ffb01336be79c64046b636e59fa8ddca8ec029edsf serveurs LDAP qui ne permettent pas les connexions anonymes au cours
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive lors des tentatives de sauts vers des serveurs alternatifs. Pour
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive contr&ocirc;ler cette fonctionnalit&eacute;, voir les directives <directive
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive module="mod_ldap">LDAPReferrals</directive> et <directive
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive module="mod_ldap">LDAPReferralHopLimit</directive>. Cette
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive fonctionnalit&eacute; est activ&eacute;e par d&eacute;faut.</p>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive</section>
aee1f193a276866212922ae5072e3014db28582frpluem
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem<section id="cache"><title>Cache LDAP</title>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem <p>Pour am&eacute;liorer les performances, <module>mod_ldap</module> met en
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem oeuvre une strat&eacute;gie de mise en cache agressive visant &agrave; minimiser
aee1f193a276866212922ae5072e3014db28582frpluem le nombre de fois que le serveur LDAP doit &ecirc;tre contact&eacute;. La mise en
bf380c59be3f235bde21f1c00098e09e3cf7e7aerpluem cache peut facilement doubler et m&ecirc;me tripler le d&eacute;bit d'Apache
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive lorsqu'il sert des pages prot&eacute;g&eacute;es par mod_authnz_ldap. De plus, le
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive serveur LDAP verra lui-m&ecirc;me sa charge sensiblement diminu&eacute;e.</p>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <p><module>mod_ldap</module> supporte deux types de mise en cache
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive LDAP : un <em>cache recherche/identification</em> durant la phase
aee1f193a276866212922ae5072e3014db28582frpluem de recherche/identification et deux <em>caches d'op&eacute;rations</em>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive durant la phase de comparaison. Chaque URL LDAP utilis&eacute;e par le
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive serveur a son propre jeu d'instances dans ces trois caches.</p>
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive
aa8cf57195dfb7fa3d0baedf81f8be377946cea8slive <section id="search-bind"><title>Le cache
5a58787efeb02a1c3f06569d019ad81fd2efa06end recherche/identification</title>
aee1f193a276866212922ae5072e3014db28582frpluem <p>Les processus de recherche et d'identification sont les
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele op&eacute;rations LDAP les plus consommatrices en temps, en particulier
aee1f193a276866212922ae5072e3014db28582frpluem si l'annuaire est de grande taille. Le cache de
aee1f193a276866212922ae5072e3014db28582frpluem recherche/identification met en cache toutes les recherches qui
aee1f193a276866212922ae5072e3014db28582frpluem ont abouti &agrave; une identification positive. Les r&eacute;sultats n&eacute;gatifs
aee1f193a276866212922ae5072e3014db28582frpluem (c'est &agrave; dire les recherches sans succ&egrave;s, ou les recherches qui
aee1f193a276866212922ae5072e3014db28582frpluem n'ont pas abouti &agrave; une identification positive) ne sont pas mis en
aee1f193a276866212922ae5072e3014db28582frpluem cache. La raison de cette d&eacute;cision r&eacute;side dans le fait que les
aee1f193a276866212922ae5072e3014db28582frpluem connexions avec des donn&eacute;es d'identification invalides ne
aee1f193a276866212922ae5072e3014db28582frpluem repr&eacute;sentent qu'un faible pourcentage du nombre total de
aee1f193a276866212922ae5072e3014db28582frpluem connexions, et ainsi, le fait de ne pas mettre en cache les
aee1f193a276866212922ae5072e3014db28582frpluem donn&eacute;es d'identification invalides r&eacute;duira d'autant la taille du
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele cache.</p>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele <p><module>mod_ldap</module> met en cache le nom d'utilisateur, le
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele DN extrait, le mot de passe utilis&eacute; pour l'identification, ainsi
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele que l'heure de l'identification. Chaque fois qu'une nouvelle
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele connexion est initialis&eacute;e avec le m&ecirc;me nom d'utilisateur,
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele <module>mod_ldap</module> compare le mot de passe de la nouvelle
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele connexion avec le mot de passe enregistr&eacute; dans le cache. Si les
aee1f193a276866212922ae5072e3014db28582frpluem mots de passe correspondent, et si l'entr&eacute;e du cache n'est pas
aee1f193a276866212922ae5072e3014db28582frpluem trop ancienne, <module>mod_ldap</module> court-circuite la phase
aee1f193a276866212922ae5072e3014db28582frpluem de recherche/identification.</p>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <p>Le cache de recherche/identification est contr&ocirc;l&eacute; par les
aee1f193a276866212922ae5072e3014db28582frpluem directives <directive
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele module="mod_ldap">LDAPCacheEntries</directive> et <directive
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele module="mod_ldap">LDAPCacheTTL</directive>.</p>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele </section>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele <section id="opcaches"><title>Les caches d'op&eacute;rations</title>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele <p>Au cours des op&eacute;rations de comparaison d'attributs et de noms
aee1f193a276866212922ae5072e3014db28582frpluem distinctifs (DN), <module>mod_ldap</module> utilise deux caches
aee1f193a276866212922ae5072e3014db28582frpluem d'op&eacute;rations pour mettre en cache les op&eacute;rations de comparaison.
aee1f193a276866212922ae5072e3014db28582frpluem Le premier cache de comparaison sert &agrave; mettre en cache les
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele r&eacute;sultats de comparaisons effectu&eacute;es pour v&eacute;rifier l'appartenance
aee1f193a276866212922ae5072e3014db28582frpluem &agrave; un groupe LDAP. Le second cache de comparaison sert &agrave; mettre en
aee1f193a276866212922ae5072e3014db28582frpluem cache les r&eacute;sultats de comparaisons entre DNs.</p>
aee1f193a276866212922ae5072e3014db28582frpluem
9bcfc3697a91b5215893a7d0206865b13fc72148nd <p>Notez que, lorsque l'appartenance &agrave; un groupe est v&eacute;rifi&eacute;e,
9bcfc3697a91b5215893a7d0206865b13fc72148nd toute comparaison de sous-groupes est mise en cache afin
9bcfc3697a91b5215893a7d0206865b13fc72148nd d'acc&eacute;l&eacute;rer les comparaisons de sous-groupes ult&eacute;rieures.</p>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <p>Le comportement de ces deux caches est contr&ocirc;l&eacute; par les
aee1f193a276866212922ae5072e3014db28582frpluem directives <directive
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele module="mod_ldap">LDAPOpCacheEntries</directive> et <directive
aee1f193a276866212922ae5072e3014db28582frpluem module="mod_ldap">LDAPOpCacheTTL</directive>.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end </section>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end <section id="monitoring"><title>Superviser le cache</title>
aee1f193a276866212922ae5072e3014db28582frpluem <p><module>mod_ldap</module> poss&egrave;de un gestionnaire de contenu
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele qui permet aux administrateurs de superviser les performances du
aee1f193a276866212922ae5072e3014db28582frpluem cache. Le nom du gestionnaire de contenu est
aee1f193a276866212922ae5072e3014db28582frpluem <code>ldap-status</code>, et on peut utiliser les directives
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele suivantes pour acc&eacute;der aux informations du cache de
aee1f193a276866212922ae5072e3014db28582frpluem <module>mod_ldap</module> :</p>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <highlight language="config">
aee1f193a276866212922ae5072e3014db28582frpluem&lt;Location /server/cache-info&gt;
aee1f193a276866212922ae5072e3014db28582frpluem SetHandler ldap-status
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele&lt;/Location&gt;
aee1f193a276866212922ae5072e3014db28582frpluem </highlight>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <p>En se connectant &agrave; l'URL
aee1f193a276866212922ae5072e3014db28582frpluem <code>http://nom-serveur/infos-cache</code>, l'administrateur peut
aee1f193a276866212922ae5072e3014db28582frpluem obtenir un rapport sur le statut de chaque cache qu'utilise
aee1f193a276866212922ae5072e3014db28582frpluem <module>mod_ldap</module>. Notez que si Apache ne supporte pas la
aee1f193a276866212922ae5072e3014db28582frpluem m&eacute;moire partag&eacute;e, chaque instance de <program>httpd</program>
aee1f193a276866212922ae5072e3014db28582frpluem poss&egrave;dera son propre cache, et chaque fois que l'URL sera
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele recharg&eacute;e, un r&eacute;sultat diff&eacute;rent pourra &ecirc;tre affich&eacute;, en fonction
aee1f193a276866212922ae5072e3014db28582frpluem de l'instance de <program>httpd</program> qui traitera la
aee1f193a276866212922ae5072e3014db28582frpluem requ&ecirc;te.</p>
aee1f193a276866212922ae5072e3014db28582frpluem </section>
10a304fc5348d394375b98ae10ca9b137fd10cafkess</section>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem<section id="usingssltls"><title>Utiliser SSL/TLS</title>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <p>La possibilit&eacute; de cr&eacute;er des connexions SSL et TLS avec un serveur
aee1f193a276866212922ae5072e3014db28582frpluem LDAP est d&eacute;finie par les directives <directive module="mod_ldap">
aee1f193a276866212922ae5072e3014db28582frpluem LDAPTrustedGlobalCert</directive>, <directive module="mod_ldap">
aee1f193a276866212922ae5072e3014db28582frpluem LDAPTrustedClientCert</directive> et <directive module="mod_ldap">
aee1f193a276866212922ae5072e3014db28582frpluem LDAPTrustedMode</directive>. Ces directives permettent de sp&eacute;cifier
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele l'autorit&eacute; de certification (CA), les certificats clients &eacute;ventuels,
aee1f193a276866212922ae5072e3014db28582frpluem ainsi que le type de chiffrement &agrave; utiliser pour la connexion (none,
aee1f193a276866212922ae5072e3014db28582frpluem SSL ou TLS/STARTTLS).</p>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <highlight language="config">
5a58787efeb02a1c3f06569d019ad81fd2efa06end# Etablissement d'une connexion SSL LDAP sur le port 636.
5a58787efeb02a1c3f06569d019ad81fd2efa06end# N&eacute;cessite le chargement de mod_ldap et mod_authnz_ldap.
5a58787efeb02a1c3f06569d019ad81fd2efa06end# Remplacez "votre-domaine.example.com" par le nom de votre
aee1f193a276866212922ae5072e3014db28582frpluem# domaine.
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
aee1f193a276866212922ae5072e3014db28582frpluemLDAPTrustedGlobalCert CA_DER /certs/certfile.der
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem&lt;Location /ldap-status&gt;
aee1f193a276866212922ae5072e3014db28582frpluem SetHandler ldap-status
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem Require host yourdomain.example.com
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
aee1f193a276866212922ae5072e3014db28582frpluem Satisfy any
aee1f193a276866212922ae5072e3014db28582frpluem AuthType Basic
aee1f193a276866212922ae5072e3014db28582frpluem AuthName "LDAP Protected"
aee1f193a276866212922ae5072e3014db28582frpluem AuthBasicProvider ldap
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele AuthLDAPURL ldaps://127.0.0.1/dc=example,dc=com?uid?one
aee1f193a276866212922ae5072e3014db28582frpluem Require valid-user
aee1f193a276866212922ae5072e3014db28582frpluem&lt;/Location&gt;
aee1f193a276866212922ae5072e3014db28582frpluem </highlight>
8ba6e8ba8d8ad4d8228872d5526fa7295ff43149poirier
aee1f193a276866212922ae5072e3014db28582frpluem <highlight language="config">
5a58787efeb02a1c3f06569d019ad81fd2efa06end# Etablissement d'une connexion TLS LDAP sur le port 389.
5a58787efeb02a1c3f06569d019ad81fd2efa06end# N&eacute;cessite le chargement de mod_ldap et mod_authnz_ldap.
5a58787efeb02a1c3f06569d019ad81fd2efa06end# Remplacez "votre-domaine.example.com" par le nom de votre
aee1f193a276866212922ae5072e3014db28582frpluem# domaine.
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
aee1f193a276866212922ae5072e3014db28582frpluemLDAPTrustedGlobalCert CA_DER /certs/certfile.der
aee1f193a276866212922ae5072e3014db28582frpluem
5d7e5de2da57434c8e68c8fa49cbf6d70ee0f817slive&lt;Location /ldap-status&gt;
aee1f193a276866212922ae5072e3014db28582frpluem SetHandler ldap-status
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
aee1f193a276866212922ae5072e3014db28582frpluem Require host yourdomain.example.com
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
aee1f193a276866212922ae5072e3014db28582frpluem Satisfy any
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele AuthType Basic
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele AuthName "LDAP Protected"
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele AuthBasicProvider ldap
aee1f193a276866212922ae5072e3014db28582frpluem AuthLDAPURL ldap://127.0.0.1/dc=example,dc=com?uid?one TLS
5a58787efeb02a1c3f06569d019ad81fd2efa06end Require valid-user
5a58787efeb02a1c3f06569d019ad81fd2efa06end&lt;/Location&gt;
5a58787efeb02a1c3f06569d019ad81fd2efa06end </highlight>
aee1f193a276866212922ae5072e3014db28582frpluem
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele</section>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem<section id="settingcerts"><title>Certificats SSL/TLS</title>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <p>Les diff&eacute;rents SDKs LDAP disposent de nombreuses m&eacute;thodes pour
aee1f193a276866212922ae5072e3014db28582frpluem d&eacute;finir et g&eacute;rer les certificats des clients et des autorit&eacute;s de
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele certification (CA).</p>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <p>Si vous avez l'intention d'utiliser SSL ou TLS, lisez cette
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele section ATTENTIVEMENT de fa&ccedil;on &agrave; bien comprendre les diff&eacute;rences de
aee1f193a276866212922ae5072e3014db28582frpluem configurations entre les diff&eacute;rents SDKs LDAP support&eacute;s.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end <section id="settingcerts-netscape"><title>SDK Netscape/Mozilla/iPlanet</title>
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>Les certificat de CA sont enregistr&eacute;s dans un fichier nomm&eacute;
a3388213b2b4d46b356be205e38204e67b4304d8rbowen cert7.db. Le SDK ne dialoguera avec aucun serveur LDAP dont le
a3388213b2b4d46b356be205e38204e67b4304d8rbowen certificat n'a pas &eacute;t&eacute; sign&eacute; par une CA sp&eacute;cifi&eacute;e dans ce
a3388213b2b4d46b356be205e38204e67b4304d8rbowen fichier. Si des certificats clients sont requis, un fichier
aee1f193a276866212922ae5072e3014db28582frpluem key3.db ainsi qu'un mot de passe optionnels peuvent &ecirc;tre
aee1f193a276866212922ae5072e3014db28582frpluem sp&eacute;cifi&eacute;s. On peut aussi sp&eacute;cifier le fichier secmod si
aee1f193a276866212922ae5072e3014db28582frpluem n&eacute;cessaire. Ces fichiers sont du m&ecirc;me format que celui utilis&eacute;
aee1f193a276866212922ae5072e3014db28582frpluem par les navigateurs web Netscape Communicator ou Mozilla. Le
aee1f193a276866212922ae5072e3014db28582frpluem moyen le plus simple pour obtenir ces fichiers consiste &agrave; les
aee1f193a276866212922ae5072e3014db28582frpluem extraire de l'installation de votre navigateur.</p>
a3388213b2b4d46b356be205e38204e67b4304d8rbowen
a3388213b2b4d46b356be205e38204e67b4304d8rbowen <p>Les certificats clients sont sp&eacute;cifi&eacute;s pour chaque connexion
5a58787efeb02a1c3f06569d019ad81fd2efa06end en utilisant la directive LDAPTrustedClientCert et en se
5a58787efeb02a1c3f06569d019ad81fd2efa06end r&eacute;f&eacute;rant au certificat "nickname". On peut &eacute;ventuellement
df321386f1d9ed17a3e5e6468807996a12890d50gryzor sp&eacute;cifier un mot de passe pour d&eacute;verrouiller la cl&eacute; priv&eacute;e du
df321386f1d9ed17a3e5e6468807996a12890d50gryzor certificat.</p>
df321386f1d9ed17a3e5e6468807996a12890d50gryzor
df321386f1d9ed17a3e5e6468807996a12890d50gryzor <p>Le SDK supporte seulement SSL. Toute tentative d'utilisation
df321386f1d9ed17a3e5e6468807996a12890d50gryzor de STARTTLS engendrera une erreur lors des tentatives de
df321386f1d9ed17a3e5e6468807996a12890d50gryzor contacter le serveur LDAP pendant l'ex&eacute;cution.</p>
df321386f1d9ed17a3e5e6468807996a12890d50gryzor
df321386f1d9ed17a3e5e6468807996a12890d50gryzor <highlight language="config">
df321386f1d9ed17a3e5e6468807996a12890d50gryzor# Sp&eacute;cifie un fichier de certificats de CA Netscape
df321386f1d9ed17a3e5e6468807996a12890d50gryzorLDAPTrustedGlobalCert CA_CERT7_DB /certs/cert7.db
df321386f1d9ed17a3e5e6468807996a12890d50gryzor# Sp&eacute;cifie un fichier key3db optionnel pour le support des
df321386f1d9ed17a3e5e6468807996a12890d50gryzor# certificats clients
df321386f1d9ed17a3e5e6468807996a12890d50gryzorLDAPTrustedGlobalCert CERT_KEY3_DB /certs/key3.db
df321386f1d9ed17a3e5e6468807996a12890d50gryzor# Sp&eacute;cifie le fichier secmod si n&eacute;cessaire
df321386f1d9ed17a3e5e6468807996a12890d50gryzorLDAPTrustedGlobalCert CA_SECMOD /certs/secmod
df321386f1d9ed17a3e5e6468807996a12890d50gryzor&lt;Location /ldap-status&gt;
df321386f1d9ed17a3e5e6468807996a12890d50gryzor SetHandler ldap-status
df321386f1d9ed17a3e5e6468807996a12890d50gryzor
5a58787efeb02a1c3f06569d019ad81fd2efa06end Require host yourdomain.example.com
aee1f193a276866212922ae5072e3014db28582frpluem
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele Satisfy any
aee1f193a276866212922ae5072e3014db28582frpluem AuthType Basic
aee1f193a276866212922ae5072e3014db28582frpluem AuthName "LDAP Protected"
aee1f193a276866212922ae5072e3014db28582frpluem AuthBasicProvider ldap
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele LDAPTrustedClientCert CERT_NICKNAME &lt;nickname&gt; [password]
aee1f193a276866212922ae5072e3014db28582frpluem AuthLDAPURL ldaps://127.0.0.1/dc=example,dc=com?uid?one
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele Require valid-user
aee1f193a276866212922ae5072e3014db28582frpluem&lt;/Location&gt;
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele </highlight>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele </section>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele <section id="settingcerts-novell"><title>SDK Novell</title>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <p>Un ou plusieurs certificats de CA doivent &ecirc;tre sp&eacute;cifi&eacute;s pour
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele que le SDK Novell fonctionne correctement. Ces certificats
aee1f193a276866212922ae5072e3014db28582frpluem peuvent &ecirc;tre sp&eacute;cifi&eacute;s sous forme de fichiers au format binaire
5a58787efeb02a1c3f06569d019ad81fd2efa06end DER ou cod&eacute;s en Base64 (PEM).</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>Note: Les certificats clients sont sp&eacute;cifi&eacute;s globalement
aee1f193a276866212922ae5072e3014db28582frpluem plut&ocirc;t qu'&agrave; chaque connexion, et doivent &ecirc;tre sp&eacute;cifi&eacute;s &agrave; l'aide
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele de la directive LDAPTrustedGlobalCert comme ci-dessous. D&eacute;finir
aee1f193a276866212922ae5072e3014db28582frpluem des certificats clients via la directive LDAPTrustedClientCert
aee1f193a276866212922ae5072e3014db28582frpluem engendrera une erreur qui sera journalis&eacute;e, au moment de la
aee1f193a276866212922ae5072e3014db28582frpluem tentative de connexion avec le serveur LDAP.</p>
aee1f193a276866212922ae5072e3014db28582frpluem
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele <p>Le SDK supporte SSL et STARTTLS, le choix &eacute;tant d&eacute;fini par le
aee1f193a276866212922ae5072e3014db28582frpluem param&egrave;tre de la directive LDAPTrustedMode. Si une URL de type
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele ldaps:// est sp&eacute;cifi&eacute;e, le mode SSL est forc&eacute;, et l'emporte sur
aee1f193a276866212922ae5072e3014db28582frpluem cette directive.</p>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele <highlight language="config">
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele# Sp&eacute;cifie deux fichiers contenant des certificats de CA
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabeleLDAPTrustedGlobalCert CA_DER /certs/cacert1.der
aee1f193a276866212922ae5072e3014db28582frpluemLDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem
aee1f193a276866212922ae5072e3014db28582frpluem# Sp&eacute;cifie un fichier contenant des certificats clients
aee1f193a276866212922ae5072e3014db28582frpluem# ainsi qu'une cl&eacute;
4ab980a06412fd86f52a6d054fb7e26de155c530erikabeleLDAPTrustedGlobalCert CERT_BASE64 /certs/cert1.pem
aee1f193a276866212922ae5072e3014db28582frpluemLDAPTrustedGlobalCert KEY_BASE64 /certs/key1.pem [password]
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele# N'utilisez pas cette directive, sous peine de provoquer
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele# une erreur
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele#LDAPTrustedClientCert CERT_BASE64 /certs/cert1.pem
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele </highlight>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele </section>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <section id="settingcerts-openldap"><title>SDK OpenLDAP</title>
aee1f193a276866212922ae5072e3014db28582frpluem
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele <p>Un ou plusieurs certificats de CA doivent &ecirc;tre sp&eacute;cifi&eacute;s pour
aee1f193a276866212922ae5072e3014db28582frpluem que le SDK OpenLDAP fonctionne correctement. Ces certificats
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele peuvent &ecirc;tre sp&eacute;cifi&eacute;s sous forme de fichiers au format binaire
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele DER ou cod&eacute;s en Base64 (PEM).</p>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele <p>Les certificats clients sont sp&eacute;cifi&eacute;s pour chaque connexion
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele &agrave; l'aide de la directive LDAPTrustedClientCert.</p>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele <p>La documentation du SDK pr&eacute;tend que SSL et STARTTLS sont
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele support&eacute;s ; cependant, STARTTLS semble ne pas fonctionner avec
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele toutes les versions du SDK. Le mode SSL/TLS peut &ecirc;tre d&eacute;fini en
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele utilisant le param&egrave;tre de la directive LDAPTrustedMode. Si une
aee1f193a276866212922ae5072e3014db28582frpluem URL de type
aee1f193a276866212922ae5072e3014db28582frpluem ldaps:// est sp&eacute;cifi&eacute;e, le mode SSL est forc&eacute;. La documentation
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele OpenLDAP indique que le support SSL (ldaps://) tend &agrave; &ecirc;tre
10a304fc5348d394375b98ae10ca9b137fd10cafkess remplac&eacute; par TLS, bien que le mode SSL fonctionne toujours.</p>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <highlight language="config">
aee1f193a276866212922ae5072e3014db28582frpluem# Sp&eacute;cifie deux fichiers contenant des certificats de CA
13dd6a45ad3051c84a03bfbc88f0e314a5322ed6rbowenLDAPTrustedGlobalCert CA_DER /certs/cacert1.der
aee1f193a276866212922ae5072e3014db28582frpluemLDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele&lt;Location /ldap-status&gt;
aee1f193a276866212922ae5072e3014db28582frpluem SetHandler ldap-status
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele Require host yourdomain.example.com
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
aee1f193a276866212922ae5072e3014db28582frpluem LDAPTrustedClientCert CERT_BASE64 /certs/cert1.pem
5a58787efeb02a1c3f06569d019ad81fd2efa06end LDAPTrustedClientCert KEY_BASE64 /certs/key1.pem
5a58787efeb02a1c3f06569d019ad81fd2efa06end # CA certs respecified due to per-directory client certs
5a58787efeb02a1c3f06569d019ad81fd2efa06end LDAPTrustedClientCert CA_DER /certs/cacert1.der
aee1f193a276866212922ae5072e3014db28582frpluem LDAPTrustedClientCert CA_BASE64 /certs/cacert2.pem
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele Satisfy any
aee1f193a276866212922ae5072e3014db28582frpluem AuthType Basic
aee1f193a276866212922ae5072e3014db28582frpluem AuthName "LDAP Protected"
aee1f193a276866212922ae5072e3014db28582frpluem AuthBasicProvider ldap
aee1f193a276866212922ae5072e3014db28582frpluem AuthLDAPURL ldaps://127.0.0.1/dc=example,dc=com?uid?one
aee1f193a276866212922ae5072e3014db28582frpluem Require valid-user
22cebd88e14c30aedd5dd95323ba66e4887dc94bkess&lt;/Location&gt;
aee1f193a276866212922ae5072e3014db28582frpluem </highlight>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
aee1f193a276866212922ae5072e3014db28582frpluem </section>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele <section id="settingcerts-solaris"><title>SDK Solaris</title>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele <p>SSL/TLS pour les biblioth&egrave;ques LDAP propres &agrave; Solaris n'est
aee1f193a276866212922ae5072e3014db28582frpluem pas encore support&eacute;. Si n&eacute;cessaire, installez et utilisez plut&ocirc;t
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele les biblioth&egrave;ques OpenLDAP.</p>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem </section>
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele
aee1f193a276866212922ae5072e3014db28582frpluem <section id="settingcerts-microsoft"><title>SDK Microsoft</title>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
aee1f193a276866212922ae5072e3014db28582frpluem <p>La configuration des certificats SSL/TLS pour les
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele biblioth&egrave;ques LDAP propres &agrave; Microsoft s'effectue &agrave; l'int&eacute;rieur
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele du registre syst&egrave;me, et aucune directive de configuration n'est
aee1f193a276866212922ae5072e3014db28582frpluem requise.</p>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem <p>SSL et TLS sont tous deux support&eacute;s en utilisant des URLs de
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele type ldaps://, ou en d&eacute;finissant la directive LDAPTrustedMode &agrave;
aee1f193a276866212922ae5072e3014db28582frpluem cet effet.</p>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele
82178a3043043b8813c0d7288a06ca1b7d110d4atakashi <p>Note: L'&eacute;tat du support des certificats clients n'est pas
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele encore connu pour ce SDK.</p>
aee1f193a276866212922ae5072e3014db28582frpluem
aee1f193a276866212922ae5072e3014db28582frpluem </section>
aee1f193a276866212922ae5072e3014db28582frpluem
4ab980a06412fd86f52a6d054fb7e26de155c530erikabele</section>
aee1f193a276866212922ae5072e3014db28582frpluem
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<directivesynopsis>
d972e4a0688f66b1402473dd9dacfecefa2132a8rbowen<name>LDAPSharedCacheSize</name>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<description>Taille en octets du cache en m&eacute;moire partag&eacute;e</description>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<syntax>LDAPSharedCacheSize <var>octets</var></syntax>
da9c9e3054d61706acdecf79cdf7aab3908a76fbnd<default>LDAPSharedCacheSize 500000</default>
ea49840bfe8467a7d7bd4db27b1d4880a85511aberikabele<contextlist><context>server config</context></contextlist>
aee1f193a276866212922ae5072e3014db28582frpluem
5a58787efeb02a1c3f06569d019ad81fd2efa06end<usage>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <p>Cette directive permet de sp&eacute;cifier le nombre d'octets &agrave; allouer
a78048ccbdb6256da15e6b0e7e95355e480c2301nd pour le cache en m&eacute;moire partag&eacute;e. La valeur par
5e740829c3448285963d3882530669f0112cf690gryzor d&eacute;faut est 500kb.
aee1f193a276866212922ae5072e3014db28582frpluem Si elle est d&eacute;finie &agrave; 0, le cache en m&eacute;moire partag&eacute;e ne sera pas
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung utilis&eacute; et chaque processus HTTPD va cr&eacute;er son propre cache.</p>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd</usage>
9c1260efa52c82c2a58e5b5f20cd6902563d95f5rbowen</directivesynopsis>
5a58787efeb02a1c3f06569d019ad81fd2efa06end
5a58787efeb02a1c3f06569d019ad81fd2efa06end<directivesynopsis>
<name>LDAPSharedCacheFile</name>
<description>D&eacute;finit le fichier du cache en m&eacute;moire
partag&eacute;e</description>
<syntax>LDAPSharedCacheFile <var>chemin/nom-fichier</var></syntax>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Cette directive permet de sp&eacute;cifier le chemin et le nom du
fichier du cache en m&eacute;moire partag&eacute;e. Si elle n'est pas d&eacute;finie, la
m&eacute;moire partag&eacute;e anonyme sera utilis&eacute;e si la plate-forme la
supporte.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPCacheEntries</name>
<description>Nombre maximum d'entr&eacute;es dans le cache LDAP
primaire</description>
<syntax>LDAPCacheEntries <var>nombre</var></syntax>
<default>LDAPCacheEntries 1024</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Cette directive permet de sp&eacute;cifier la taille maximale du cache
LDAP primaire. Ce cache contient les r&eacute;sultats de
recherche/identification positifs. D&eacute;finissez-la &agrave; 0 pour d&eacute;sactiver
la mise en cache des r&eacute;sultats de recherche/identification positifs.
La taille par d&eacute;faut est de 1024 recherches en cache.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPCacheTTL</name>
<description>Dur&eacute;e pendant laquelle les entr&eacute;es du cache restent
valides.</description>
<syntax>LDAPCacheTTL <var>secondes</var></syntax>
<default>LDAPCacheTTL 600</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Cette directive permet de sp&eacute;cifier la dur&eacute;e (en secondes)
pendant laquelle une entr&eacute;e du cache de recherche/identification
reste valide. La valeur par d&eacute;faut est de 600 secondes (10
minutes).</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPOpCacheEntries</name>
<description>Nombre d'entr&eacute;es utilis&eacute;es pour mettre en cache les
op&eacute;rations de comparaison LDAP</description>
<syntax>LDAPOpCacheEntries <var>nombre</var></syntax>
<default>LDAPOpCacheEntries 1024</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Cette directive permet de sp&eacute;cifier le nombre d'entr&eacute;es que
<module>mod_ldap</module> va utiliser pour mettre en cache les
op&eacute;rations de comparaison LDAP. La valeur par d&eacute;faut est de 1024
entr&eacute;es. Si elle est d&eacute;finie &agrave; 0, la mise en cache des op&eacute;rations de
comparaison LDAP est d&eacute;sactiv&eacute;e.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPOpCacheTTL</name>
<description>Dur&eacute;e pendant laquelle les entr&eacute;es du cache d'op&eacute;rations
restent valides</description>
<syntax>LDAPOpCacheTTL <var>secondes</var></syntax>
<default>LDAPOpCacheTTL 600</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Cette directive permet de sp&eacute;cifier la dur&eacute;e (en secondes)
pendant laquelle les entr&eacute;es du cache d'op&eacute;rations restent valides.
La valeur par d&eacute;faut est de 600 secondes.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPReferralHopLimit</name>
<description>Le nombre maximum de redirections vers des serveurs
alternatifs (referrals) avant l'abandon de la requ&ecirc;te
LDAP.</description>
<syntax>LDAPReferralHopLimit <var>nombre</var></syntax>
<default>D&eacute;pend du SDK, en g&eacute;n&eacute;ral entre 5 et 10</default>
<contextlist><context>directory</context><context>.htaccess</context></contextlist>
<override>AuthConfig</override>
<usage>
<p>Si elle est activ&eacute;e par la directive <code>LDAPReferrals</code>,
cette directive permet de d&eacute;finir le nombre maximum de sauts vers
des serveurs alternatifs (referrals) avant l'abandon de la requ&ecirc;te
LDAP.</p>
<note type="warning">
<p>L'ajustement de ce param&egrave;tre n'est pas commun &agrave; tous les SDKs LDAP.</p>
</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPReferrals</name>
<description>Active la redirection vers des serveurs alternatifs au
cours des requ&ecirc;tes vers le serveur LDAP.</description>
<syntax>LDAPReferrals <var>On|Off</var></syntax>
<default>LDAPReferrals On</default>
<contextlist><context>directory</context><context>.htaccess</context></contextlist>
<override>AuthConfig</override>
<usage>
<p>Certains serveurs LDAP partagent leur annuaire en plusieurs
domaines et utilisent le syst&egrave;me des redirections (referrals) pour
aiguiller un client lorsque les limites d'un domaine doivent &ecirc;tre
franchies. En d&eacute;finissant <code>LDAPReferrals On</code>, les
redirections seront prises en compte (et bien entendu, en
d&eacute;finissant <code>LDAPReferrals Off</code>, les redirections seront
ignor&eacute;es). La directive <code>LDAPReferralHopLimit</code> compl&egrave;te
cette directive en d&eacute;finissant le nombre maximum de redirections &agrave;
suivre avant l'abandon de la requ&ecirc;te LDAP. Lorsque le traitement des
redirections est activ&eacute;, les donn&eacute;es d'identification du client
seront fournies, via un appel (callback) de r&eacute;identification, &agrave; tout
serveur LDAP qui en fera la demande.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPRetryDelay</name>
<description>D&eacute;finit le temps d'attente avant un autre essai de connexion au
serveur LDAP.</description>
<syntax>LDAPRetryDelay <var>secondes</var></syntax>
<default>LDAPRetryDelay 0</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Si la directive <directive>LDAPRetryDelay</directive> est d&eacute;finie
&agrave; une valeur diff&eacute;rente de 0, le serveur attendra pendant la dur&eacute;e
sp&eacute;cifi&eacute;e pour envoyer &agrave; nouveau sa requ&ecirc;te LDAP. Une valeur de 0
implique une absence de d&eacute;lai pour les essais successifs.</p>
<p>Il est possible d'effectuer une autre tentative de connexion en
cas d'erreurs LDAP du type d&eacute;lai d&eacute;pass&eacute; ou connexion refus&eacute;e. </p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPRetries</name>
<description>D&eacute;finit le nombre maximum de tentatives de connexions au
serveur LDAP.</description>
<syntax>LDAPRetries <var>nombre d'essais</var></syntax>
<default>LDAPRetries 3</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Suite &agrave; des &eacute;checs de connexion au serveur LDAP, le serveur
tentera de se connecter autant de fois qu'indiqu&eacute; par la directive
<directive>LDAPRetries</directive>. Si cette directive est d&eacute;finie &agrave;
0, le serveur ne tentera pas d'autre connexion apr&egrave;s un &eacute;chec.</p>
<p>Il est possible d'effectuer une autre tentative de connexion en
cas d'erreurs LDAP du type d&eacute;lai d&eacute;pass&eacute; ou connexion refus&eacute;e. </p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPTrustedGlobalCert</name>
<description>D&eacute;finit le nom de fichier ou la base de donn&eacute;es contenant
les Autorit&eacute;s de Certification de confiance globales ou les certificats
clients globaux</description>
<syntax>LDAPTrustedGlobalCert <var>type</var>
<var>chemin/nom-fichier</var> <var>[mot de passe]</var></syntax>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Cette directive permet de sp&eacute;cifier le chemin et le nom du
fichier contenant les certificats des CA de confiance et/ou les
certificats clients du syst&egrave;me global que <module>mod_ldap</module>
utilisera pour &eacute;tablir une connexion SSL ou TLS avec un serveur
LDAP. Notez que toute information relative aux certificats sp&eacute;cifi&eacute;e
en utilisant cette directive s'applique globalement &agrave; l'ensemble de
l'installation du serveur. Certains SDK LDAP (en particulier Novell)
n&eacute;cessitent la d&eacute;finition globale de tous les certificats clients en
utilisant cette directive. La plupart des autres SDK n&eacute;cessitent la
d&eacute;finition des certificats clients dans une section Directory ou
Location en utilisant la directive LDAPTrustedClientCert. Si vous ne
d&eacute;finissez pas ces directives correctement, une erreur sera g&eacute;n&eacute;r&eacute;e
lors des tentatives de contact avec un serveur LDAP, ou la connexion
&eacute;chouera silencieusement (Voir plus haut le guide des certificats
SSL/TLS pour plus de d&eacute;tails). Le param&egrave;tre type sp&eacute;cifie le type de
certificat en cours de d&eacute;finition, en fonction du SDK LDAP utilis&eacute;.
Les types support&eacute;s sont :</p>
<ul>
<li>CA_DER - certificat de CA cod&eacute; en binaire DER</li>
<li>CA_BASE64 - certificat de CA cod&eacute; en PEM</li>
<li>CA_CERT7_DB - fichier de base de donn&eacute;es des certificats de CA
de Netscape cert7.db</li>
<li>CA_SECMOD - fichier de base de donn&eacute;es secmod de Netscape</li>
<li>CERT_DER - certificat client cod&eacute; en binaire DER</li>
<li>CERT_BASE64 - certificat client cod&eacute; en PEM</li>
<li>CERT_KEY3_DB - fichier de base de donn&eacute;es des certificats
clients de Netscape key3.db</li>
<li>CERT_NICKNAME - certificat client "nickname" (SDK Netscape)</li>
<li>CERT_PFX - certificat client cod&eacute; en PKCS#12 (SDK Novell)</li>
<li>KEY_DER - cl&eacute; priv&eacute;e cod&eacute;e en binaire DER</li>
<li>KEY_BASE64 - cl&eacute; priv&eacute;e cod&eacute;e en PEM</li>
<li>KEY_PFX - cl&eacute; priv&eacute;e cod&eacute;e en PKCS#12 (SDK Novell)</li>
</ul>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPTrustedClientCert</name>
<description>D&eacute;finit le nom de fichier contenant un certificat client ou
un alias renvoyant vers un certificat client sp&eacute;cifique &agrave; une connexion.
Tous les SDK LDAP ne supportent pas les certificats clients par
connexion.</description>
<syntax>LDAPTrustedClientCert <var>type</var>
<var>chemin/nom-fichier/alias</var> <var>[mot de passe]</var></syntax>
<contextlist><context>server config</context><context>virtual
host</context><context>directory</context><context>.htaccess</context></contextlist>
<usage>
<p>Cette directive permet de sp&eacute;cifier le chemin et le nom de
fichier ou l'alias d'un certificat client par connexion utilis&eacute; lors
de l'&eacute;tablissement d'une connexion SSL ou TLS avec un serveur LDAP.
Les sections directory ou location peuvent poss&eacute;der leurs propres
configurations de certificats clients. Certains SDK LDAP (en
particulier Novell) ne supportent pas les certificats clients par
connexion, et renvoient une erreur lors de la connexion au serveur
LDAP si vous tenter d'utiliser cette directive (Utilisez &agrave; la place
la directive LDAPTrustedGlobalCert pour les certificats clients sous
Novell - Voir plus haut le guide des certificats SSL/TLS pour plus
de d&eacute;tails). Le param&egrave;tre type sp&eacute;cifie le type du certificat en
cours de d&eacute;finition, en fonction du SDK LDAP utilis&eacute;. Les types
support&eacute;s sont :</p>
<ul>
<li>CA_DER - certificat de CA cod&eacute; en binaire DER</li>
<li>CA_BASE64 - certificat de CA cod&eacute; en PEM</li>
<li>CERT_DER - certificat client cod&eacute; en binaire DER</li>
<li>CERT_BASE64 - certificat client cod&eacute; en PEM</li>
<li>CERT_NICKNAME - certificat client "nickname" (SDK Netscape)</li>
<li>KEY_DER - cl&eacute; priv&eacute;e cod&eacute;e en binaire DER</li>
<li>KEY_BASE64 - cl&eacute; priv&eacute;e cod&eacute;e en PEM</li>
</ul>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPTrustedMode</name>
<description>Sp&eacute;cifie le mode (SSL ou TLS) &agrave; utiliser lors de la
connexion &agrave; un serveur LDAP.</description>
<syntax>LDAPTrustedMode <var>type</var></syntax>
<contextlist><context>server config</context><context>virtual
host</context></contextlist>
<usage>
<p>Les modes suivants sont support&eacute;s :</p>
<ul>
<li>NONE - aucun chiffrement</li>
<li>SSL - chiffrement ldaps:// sur le port par d&eacute;faut 636</li>
<li>TLS - chiffrement STARTTLS sur le port par d&eacute;faut 389</li>
</ul>
<p>Les modes ci-dessus ne sont pas support&eacute;s par tous les SDK LDAP.
Un message d'erreur sera g&eacute;n&eacute;r&eacute; &agrave; l'ex&eacute;cution si un mode n'est pas
support&eacute;, et la connexion au serveur LDAP &eacute;chouera.
</p>
<p>Si une URL de type ldaps:// est sp&eacute;cifi&eacute;e, le mode est forc&eacute; &agrave;
SSL et la d&eacute;finition de LDAPTrustedMode est ignor&eacute;e.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPConnectionTimeout</name>
<description>Sp&eacute;cifie le d&eacute;lai d'attente en secondes de la socket de
connexion</description>
<syntax>LDAPConnectionTimeout <var>secondes</var></syntax>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Cette directive configure l'option LDAP_OPT_NETWORK_TIMEOUT (ou
LDAP_OPT_CONNECT_TIMEOUT) dans la biblioth&egrave;que client LDAP
sous-jacente, si elle est disponible. Cette valeur repr&eacute;sente la
dur&eacute;e pendant laquelle la biblioth&egrave;que client LDAP va attendre que
le processus de connexion TCP au serveur LDAP soit achev&eacute;.</p>
<p>Si la connexion n'a pas r&eacute;ussi avant ce d&eacute;lai, une erreur sera
renvoy&eacute;e, ou la biblioth&egrave;que client LDAP tentera de se connecter &agrave;
un second serveur LDAP, s'il en a &eacute;t&eacute; d&eacute;fini un (via une liste de
noms d'h&ocirc;tes s&eacute;par&eacute;s par des espaces dans la directive <directive
module="mod_authnz_ldap">AuthLDAPURL</directive>).</p>
<p>La valeur par d&eacute;faut est 10 secondes, si la biblioth&egrave;que client
LDAP li&eacute;e avec le serveur supporte l'option
LDAP_OPT_NETWORK_TIMEOUT.</p>
<note>LDAPConnectionTimeout n'est disponible que si la biblioth&egrave;que client
LDAP li&eacute;e avec le serveur supporte l'option
LDAP_OPT_NETWORK_TIMEOUT (ou LDAP_OPT_CONNECT_TIMEOUT), et le
comportement final est enti&egrave;rement dict&eacute; par la biblioth&egrave;que client
LDAP.
</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPTimeout</name>
<description>Sp&eacute;cifie le d&eacute;lai d'attente pour les op&eacute;rations de
recherche et d'identification LDAP en secondes</description>
<syntax>LDAPTimeout <var>secondes</var></syntax>
<default>LDAPTimeout 60</default>
<contextlist><context>server config</context></contextlist>
<compatibility>Disponible &agrave; partir de la version 2.3.5 du serveur HTTP
Apache</compatibility>
<usage>
<p>Cette directive permet de sp&eacute;cifier le d&eacute;lai d'attente pour les
op&eacute;rations de recherche et d'identification, ainsi que l'option
LDAP_OPT_TIMEOUT dans la biblioth&egrave;que LDAP client sous-jacente,
lorsqu'elle est disponible.</p>
<p>Lorsque le d&eacute;lai est atteint, httpd va refaire un essai dans le
cas o&ugrave; une connexion existante a &eacute;t&eacute; silencieusement ferm&eacute;e par un
pare-feu. Les performances seront cependant bien meilleures si le
pare-feu est configur&eacute; pour envoyer des paquets TCP RST au lieu de
rejeter silencieusement les paquets.</p>
<note>
<p>Les d&eacute;lais pour les op&eacute;rations de comparaison LDAP n&eacute;cessitent un
SDK avec LDAP_OPT_TIMEOUT, comme OpenLDAP &gt;= 2.4.4.</p>
</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPVerifyServerCert</name>
<description>Force la v&eacute;rification du certificat du
serveur</description>
<syntax>LDAPVerifyServerCert <var>On|Off</var></syntax>
<default>LDAPVerifyServerCert On</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Cette directive permet de sp&eacute;cifier s'il faut forcer la
v&eacute;rification d'un certificat de serveur lors de l'&eacute;tablissement
d'une connexion SSL avec un serveur LDAP.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPConnectionPoolTTL</name>
<description>D&eacute;sactive les connexions d'arri&egrave;re-plan qui sont rest&eacute;es
inactives trop longtemps au sein du jeu de connexions.</description>
<syntax>LDAPConnectionPoolTTL <var>n</var></syntax>
<default>LDAPConnectionPoolTTL -1</default>
<contextlist><context>server config</context><context>virtual host</context></contextlist>
<compatibility>Disponible &agrave; partir de la version 2.3.12 du serveur HTTP
Apache</compatibility>
<usage>
<p>Cette directive permet de sp&eacute;cifier la dur&eacute;e maximale, en
secondes, pendant laquelle une connexion LDAP du jeu de connexions
peut demeurer inactive, mais rester quand-m&ecirc;me disponible pour une
utilisation &eacute;ventuelle. Le jeu de connexions est nettoy&eacute; au fur et &agrave;
mesure des besoins, de mani&egrave;re non asynchrone.</p>
<p>Si cette directive est d&eacute;finie &agrave; 0, les connexions ne sont jamais
sauvegard&eacute;es dans le jeu de connexions d'arri&egrave;re-plan. Avec la
valeur par d&eacute;faut -1, ou toute autre valeur n&eacute;gative, les connexions
peuvent &ecirc;tre r&eacute;utilis&eacute;es sans limite de dur&eacute;e.</p>
<note><p>Cette dur&eacute;e de vie s'exprime par d&eacute;faut en secondes, mais
il est possible d'utiliser d'autres unit&eacute;s en ajoutant un suffixe :
millisecondes (ms), minutes (min), ou heures (h).
</p></note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>LDAPLibraryDebug</name>
<description>Active le d&eacute;bogage dans le SDK LDAP</description>
<syntax>LDAPLibraryDebug <var>7</var></syntax>
<default>disabled</default>
<contextlist><context>server config</context></contextlist>
<usage>
<p>Active les options de d&eacute;bogage LDAP sp&eacute;cifiques au SDK, qui
entra&icirc;nent en g&eacute;n&eacute;ral une journalisation d'informations verbeuses du
SDK LDAP dans le journal principal des erreurs d'Apache. Les
messages de traces en provenance du SDK LDAP fournissent des
informations tr&egrave;s d&eacute;taill&eacute;es qui peuvent s'av&eacute;rer utiles lors du
d&eacute;bogage des probl&egrave;mes de connexion avec des serveurs LDAP
d'arri&egrave;re-plan.</p>
<p>Cette option n'est configurable que lorsque le serveur HTTP
Apache est li&eacute; avec un SDK LDAP qui impl&eacute;mente
<code>LDAP_OPT_DEBUG</code> ou <code>LDAP_OPT_DEBUG_LEVEL</code>,
comme OpenLDAP (une valeur de 7 est verbeuse) ou Tivoli Directory
Server (une valeur de 65535 est verbeuse).</p>
<note type="warning">
<p>Les informations journalis&eacute;es peuvent contenir des donn&eacute;es
d'authentification en clair utilis&eacute;es ou valid&eacute;es lors de
l'authentification LDAP ; vous devez donc prendre soin de prot&eacute;ger
et de purger le journal des erreurs lorsque cette directive est
utilis&eacute;e.</p>
</note>
</usage>
</directivesynopsis>
</modulesynopsis>