diff options
| author | Lucien Gentis <lgentis@apache.org> | 2017-01-28 17:32:18 +0100 |
|---|---|---|
| committer | Lucien Gentis <lgentis@apache.org> | 2017-01-28 17:32:18 +0100 |
| commit | b2c3aae3707da6883c12db9bcf5c66f33e99167c (patch) | |
| tree | f10ffc6457c75b7dd299a32e26ba0bf9a08f917c /docs | |
| parent | On the trunk: (diff) | |
| download | apache2-b2c3aae3707da6883c12db9bcf5c66f33e99167c.tar.xz apache2-b2c3aae3707da6883c12db9bcf5c66f33e99167c.zip | |
XML updates.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1780715 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/manual/expr.xml.fr | 2 | ||||
| -rw-r--r-- | docs/manual/glossary.xml.fr | 456 | ||||
| -rw-r--r-- | docs/manual/index.xml.fr | 3 | ||||
| -rw-r--r-- | docs/manual/mod/core.xml.fr | 65 | ||||
| -rw-r--r-- | docs/manual/mod/mod_authnz_ldap.xml.fr | 2 | ||||
| -rw-r--r-- | docs/manual/mod/mod_cache.xml.fr | 820 | ||||
| -rw-r--r-- | docs/manual/mod/mod_ldap.xml.fr | 622 | ||||
| -rw-r--r-- | docs/manual/mod/mod_lua.xml.fr | 2 | ||||
| -rw-r--r-- | docs/manual/mod/mod_proxy_connect.xml.fr | 6 | ||||
| -rw-r--r-- | docs/manual/mod/mod_proxy_html.xml.fr | 2 | ||||
| -rw-r--r-- | docs/manual/mod/mod_proxy_scgi.xml.fr | 8 | ||||
| -rw-r--r-- | docs/manual/mod/mod_rewrite.xml.fr | 2 | ||||
| -rw-r--r-- | docs/manual/mod/mod_ssl.xml.fr | 3 | ||||
| -rw-r--r-- | docs/manual/sitemap.xml.fr | 3 | ||||
| -rw-r--r-- | docs/manual/socache.xml.fr | 3 | ||||
| -rw-r--r-- | docs/manual/ssl/ssl_intro.xml.fr | 4 |
16 files changed, 1023 insertions, 980 deletions
diff --git a/docs/manual/expr.xml.fr b/docs/manual/expr.xml.fr index 8831a2000c..2e682d9075 100644 --- a/docs/manual/expr.xml.fr +++ b/docs/manual/expr.xml.fr @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?> -<!-- English Revision: 1776459:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> diff --git a/docs/manual/glossary.xml.fr b/docs/manual/glossary.xml.fr index 1e1dc6eb9c..e00f722e3e 100644 --- a/docs/manual/glossary.xml.fr +++ b/docs/manual/glossary.xml.fr @@ -1,9 +1,9 @@ -<?xml version="1.0" ?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> -<!-- English Revision: 1673947:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- Licensed to the Apache Software Foundation (ASF) under one or more @@ -27,174 +27,174 @@ <title>Glossaire</title> <summary> - <p>Ce glossaire définit la terminologie courante relative à Apache en - particulier, et aux serveurs web en général. Vous trouverez plus + <p>Ce glossaire définit la terminologie courante relative à Apache en + particulier, et aux serveurs web en général. Vous trouverez plus d'informations sur chaque concept dans les liens fournis.</p> </summary> -<section id="definitions"><title>Définitions</title> +<section id="definitions"><title>Définitions</title> <dl> <dt><a name="algorithm" id="algorithm">Algorithme</a></dt> - <dd>Une formule sans ambiguité ou un jeu de règles destinées à - résoudre un problème en un nombre fini d'étapes. Les algorithmes de - chiffrement sont en général appelés + <dd>Une formule sans ambiguité ou un jeu de règles destinées à + résoudre un problème en un nombre fini d'étapes. Les algorithmes de + chiffrement sont en général appelés <dfn>Ciphers</dfn>. </dd> <dt><a name="cipher" id="cipher">Algorithme de chiffrement (Cipher)</a></dt> - <dd>Un algorithme ou un système de chiffrement des données. + <dd>Un algorithme ou un système de chiffrement des données. Quelques exemples : DES, IDEA, RC4, etc.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="apr" id="APR">APR</a></dt> - <dd>Voir "Bibliothèques pour la portabilité d'Apache" + <dd>Voir "Bibliothèques pour la portabilité d'Apache" </dd> <dt><a name="tarball" id="tarball">Archive Tar (Tarball)</a></dt> - <dd>Un paquetage de fichiers rassemblés dans une archive - à l'aide de l'utilitaire <code>tar</code>. - Les distributions d'Apache sont stockées dans des Archives Tar compressées + <dd>Un paquetage de fichiers rassemblés dans une archive + à l'aide de l'utilitaire <code>tar</code>. + Les distributions d'Apache sont stockées dans des Archives Tar compressées ou en utilisant pkzip. </dd> <dt><a name="authentication" id="authentication">Authentification </a></dt> - <dd>L'identification formelle d'une entité du réseau comme un serveur, un + <dd>L'identification formelle d'une entité du réseau comme un serveur, un client, ou un utilisateur.<br /> Voir : <a href="howto/auth.html">Authentification, Autorisation, et - contrôle d'accès</a> + contrôle d'accès</a> </dd> <dt><a name="certificationauthority" - id="certificationauthority">Autorité de Certification + id="certificationauthority">Autorité de Certification (Certification Authority)</a> <a name="ca" id="ca">(CA)</a></dt> - <dd>Un tiers de confiance habilité à signer des certificats pour des entités - du réseau qu'il a authentifiées selon des critères basés sur la sécurité. - Les autres entités du réseau peuvent alors utiliser la signature pour - vérifier qu'une CA a authentifié le porteur du certificat.<br /> + <dd>Un tiers de confiance habilité à signer des certificats pour des entités + du réseau qu'il a authentifiées selon des critères basés sur la sécurité. + Les autres entités du réseau peuvent alors utiliser la signature pour + vérifier qu'une CA a authentifié le porteur du certificat.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="apacheportableruntime" - id="apacheportableruntime">Bibliothèques pour la portabilité d'Apache + id="apacheportableruntime">Bibliothèques pour la portabilité d'Apache (Apache Portable Runtime)</a> <a name="apr" id="apr">(APR)</a></dt> - <dd>Un jeu de bibliothèques qui fournit la plupart des interfaces de base - entre le serveur et le système d'exploitation. APR est développé - parallèlement au serveur HTTP Apache comme projet indépendant.<br /> + <dd>Un jeu de bibliothèques qui fournit la plupart des interfaces de base + entre le serveur et le système d'exploitation. APR est développé + parallèlement au serveur HTTP Apache comme projet indépendant.<br /> Voir : <a href="http://apr.apache.org/">Apache Portable Runtime Project</a> </dd> <dt><a name="certificate" id="certificate">Certificat (Certificate)</a></dt> - <dd>Un ensemble de données servant à authentifier des entités du - réseau comme un serveur ou un client. Un certificat contient des ensembles - d'informations X509 à propos de son propriétaire (appelé sujet/subject) + <dd>Un ensemble de données servant à authentifier des entités du + réseau comme un serveur ou un client. Un certificat contient des ensembles + d'informations X509 à propos de son propriétaire (appelé sujet/subject) et de l'<glossary - ref="certificationauthority">Autorité de Certification - (Certification Authority) ou CA</glossary> signataire (appelée + ref="certificationauthority">Autorité de Certification + (Certification Authority) ou CA</glossary> signataire (appelée le fournisseur/issuer), ainsi que la - <glossary ref="publickey">clé publique (public - key)</glossary> du propriétaire et la - signature de la CA. Les entités du réseau vérifient ces signatures - en utilisant les certificats des Autorités de Certification.<br /> + <glossary ref="publickey">clé publique (public + key)</glossary> du propriétaire et la + signature de la CA. Les entités du réseau vérifient ces signatures + en utilisant les certificats des Autorités de Certification.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="publickeycryptography" - id="publickeycryptography">Chiffrement à Clé Publique + id="publickeycryptography">Chiffrement à Clé Publique (Public Key Cryptography)</a></dt> - <dd>L'étude et l'application des systèmes de chiffrement asymétriques, - qui utilisent une clé pour le chiffrement et une autre pour le - déchiffrement. Les deux clés correspondantes constituent une paire de clés. - Appelé aussi chiffrement asymétrique. + <dd>L'étude et l'application des systèmes de chiffrement asymétriques, + qui utilisent une clé pour le chiffrement et une autre pour le + déchiffrement. Les deux clés correspondantes constituent une paire de clés. + Appelé aussi chiffrement asymétrique. <br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> - <dt><a name="privatekey" id="privatekey">Clé Privée (Private Key)</a></dt> - <dd>La clé secrète dans un système de - <glossary ref="publickeycryptography">chiffrement à clé publique</glossary>, - utilisée pour déchiffrer les messages entrants et signer + <dt><a name="privatekey" id="privatekey">Clé Privée (Private Key)</a></dt> + <dd>La clé secrète dans un système de + <glossary ref="publickeycryptography">chiffrement à clé publique</glossary>, + utilisée pour déchiffrer les messages entrants et signer les messages sortants.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> -<dt><a name="publickey" id="publickey">Clé Publique (Public Key)</a></dt> - <dd>La clé accessible au public dans un système de <glossary - ref="publickeycryptography">Chiffrement à clé publique</glossary>, - utilisée pour chiffrer les messages destinés uniquement à son - propriétaire et déchiffrer les signatures - faites par son propriétaire.<br /> +<dt><a name="publickey" id="publickey">Clé Publique (Public Key)</a></dt> + <dd>La clé accessible au public dans un système de <glossary + ref="publickeycryptography">Chiffrement à clé publique</glossary>, + utilisée pour chiffrer les messages destinés uniquement à son + propriétaire et déchiffrer les signatures + faites par son propriétaire.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="connect" id="connect">CONNECT</a></dt> - <dd>Une <glossary ref="method">méthode</glossary> HTTP pour encapsuler - des données brutes dans HTTP. Elle peut aussi être utilisée pour encapsuler + <dd>Une <glossary ref="method">méthode</glossary> HTTP pour encapsuler + des données brutes dans HTTP. Elle peut aussi être utilisée pour encapsuler d'autres protocoles, comme le protocole SSL. </dd> <dt><a name="context" id="context">Contexte (Context)</a></dt> <dd>Une portion des <glossary ref="configurationfile"> fichiers de configuration</glossary> dans laquelle certains types de - <glossary ref="directive">directives</glossary> sont autorisés.<br /> - Voir : <a href="mod/directive-dict.html#Context">Termes utilisés - pour décrire les directives d'Apache</a> + <glossary ref="directive">directives</glossary> sont autorisés.<br /> + Voir : <a href="mod/directive-dict.html#Context">Termes utilisés + pour décrire les directives d'Apache</a> </dd> - <dt><a name="accesscontrol" id="accesscontrol">Contrôle d'accès + <dt><a name="accesscontrol" id="accesscontrol">Contrôle d'accès (Access Control)</a></dt> - <dd>La restriction d'accès à des zones du réseau. Habituellement + <dd>La restriction d'accès à des zones du réseau. Habituellement dans un contexte Apache, - la restriction d'accès à certaines <em>URLs</em>.<br /> + la restriction d'accès à certaines <em>URLs</em>.<br /> Voir : <a href="howto/auth.html">Authentification, Autorisation et - Contrôle d'accès</a> + Contrôle d'accès</a> </dd> <dt><a name="securesocketslayer" id="securesocketslayer"> - Couche des Points de connexion Sécurisés + Couche des Points de connexion Sécurisés (Secure Sockets Layer) </a> <a name="ssl" id="ssl">(SSL)</a></dt> - <dd>Un protocole créé par Netscape Communications Corporation pour - l'authentification et le chiffrement généraux des communications dans les - réseaux TCP/IP. L'utilisation la plus connue est <em>HTTPS</em>, autrement dit + <dd>Un protocole créé par Netscape Communications Corporation pour + l'authentification et le chiffrement généraux des communications dans les + réseaux TCP/IP. L'utilisation la plus connue est <em>HTTPS</em>, autrement dit le Protocole de Transfert Hypertexte (HTTP) au dessus de SSL.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> - <dt><a name="subrequest" id="subrequest">Sous-requête</a></dt> - <dd>Apache possède une API des sous-requêtes pour les modules qui - permettent l'évaluation complète ou partielle par le serveur de - chemins d'autres systèmes de fichiers ou d'URL. Par exemple, la + <dt><a name="subrequest" id="subrequest">Sous-requête</a></dt> + <dd>Apache possède une API des sous-requêtes pour les modules qui + permettent l'évaluation complète ou partielle par le serveur de + chemins d'autres systèmes de fichiers ou d'URL. Par exemple, la directive <directive module="mod_dir">DirectoryIndex</directive>, les modules <module>mod_autoindex</module> et <module>mod_include</module> utilisent cette API. </dd> <dt><a name="symmetriccryptophraphy" id="symmetriccryptophraphy"> - Cryptographie Symétrique (Symmetric Cryptography)</a></dt> - <dd>L'étude et l'application des <em>Algorithmes de chiffrement</em> qui - utilisent une clé secrète unique pour les opérations de chiffrement et de - déchiffrement.<br /> + Cryptographie Symétrique (Symmetric Cryptography)</a></dt> + <dd>L'étude et l'application des <em>Algorithmes de chiffrement</em> qui + utilisent une clé secrète unique pour les opérations de chiffrement et de + déchiffrement.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="export-crippled" id="export-crippled"> - Dégradé pour l'exportation + Dégradé pour l'exportation (Export-Crippled)</a></dt> - <dd>Diminué en terme de puissance cryptographique (et de sécurité) - afin de respecter les Règles de l'Administration des Exportations + <dd>Diminué en terme de puissance cryptographique (et de sécurité) + afin de respecter les Règles de l'Administration des Exportations des Etats-Unis (Export Administration Regulations ou EAR). - Les logiciels de cryptographie dégradés pour l'exportation sont limités - à une clé de petite taille, et produisent un - <em>Texte crypté</em> qui peut en général être décrypté + Les logiciels de cryptographie dégradés pour l'exportation sont limités + à une clé de petite taille, et produisent un + <em>Texte crypté</em> qui peut en général être décrypté par force brute.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> @@ -205,17 +205,17 @@ (Certificate Signing Request)</a> <a name="csr" id="csr">(CSR)</a></dt> <dd>La soumission d'un <glossary ref="certificate">certificat</glossary> - non signé à une <glossary ref="certificationauthority">Autorité de + non signé à une <glossary ref="certificationauthority">Autorité de certification</glossary>, qui le signe avec la <glossary - ref="privatekey">Clé privée</glossary> de leur - <em>Certificat</em> de CA. Une fois le CSR signé, il devient un vrai + ref="privatekey">Clé privée</glossary> de leur + <em>Certificat</em> de CA. Une fois le CSR signé, il devient un vrai certificat.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="directive" id="directive">Directive</a></dt> - <dd>Une commande de configuration qui contrôle un ou plusieurs aspects du - comportement d'Apache. Les directives sont placées dans le <glossary + <dd>Une commande de configuration qui contrôle un ou plusieurs aspects du + comportement d'Apache. Les directives sont placées dans le <glossary ref="configurationfile">Fichier de configuration</glossary><br /> Voir : <a href="mod/directives.html">Index des directives</a> </dd> @@ -225,37 +225,37 @@ (Configuration Directive)</a></dt> <dd>Voir : <glossary ref="directive">Directive</glossary></dd> - <dt><a name="header" id="header">En-tête (Header)</a></dt> - <dd>La partie de la requête et de la réponse - <glossary ref="http">HTTP</glossary> qui est envoyée avant le contenu - proprement dit, et contient des méta-informations décrivant le contenu. + <dt><a name="header" id="header">En-tête (Header)</a></dt> + <dd>La partie de la requête et de la réponse + <glossary ref="http">HTTP</glossary> qui est envoyée avant le contenu + proprement dit, et contient des méta-informations décrivant le contenu. </dd> - <dt><a name="regularexpresion" id="regularexpresion">Expression Rationnelle + <dt><a name="regularexpression" id="regularexpression">Expression Rationnelle (Regular Expression)</a> <a name="regex" id="regex">(Regex)</a></dt> - <dd>Une méthode pour décrire un modèle sous forme de texte - par exemple, - "tous les mots qui commencent par la lettre A" ou "tous les numéros de - téléphone à 10 chiffres" ou encore "Toutes les phrases contenant 2 virgules, - et aucun Q majuscule". Les expressions rationnelles sont très utiles dans - Apache car elles vous permettent d'appliquer certains attributs à des - ensembles de fichiers ou ressources avec une grande flexibilité - - par exemple, tous les fichiers .gif et .jpg situés dans tout répertoire - nommé "images", pourraient être enregistrés comme + <dd>Une méthode pour décrire un modèle sous forme de texte - par exemple, + "tous les mots qui commencent par la lettre A" ou "tous les numéros de + téléphone à 10 chiffres" ou encore "Toutes les phrases contenant 2 virgules, + et aucun Q majuscule". Les expressions rationnelles sont très utiles dans + Apache car elles vous permettent d'appliquer certains attributs à des + ensembles de fichiers ou ressources avec une grande flexibilité + - par exemple, tous les fichiers .gif et .jpg situés dans tout répertoire + nommé "images", pourraient être enregistrés comme "<code>/images/.*(jpg|gif)$</code>". Lorsque l'on utilise des - expressions rationnelles pour la substitution de chaînes, les - variables spéciales $1 ... $9 contiennent des références arrières - vers les parties regroupées (entre parenthèses) de l'expression - qui correspond. La variable spéciale $0 contient une référence - arrière vers l'ensemble de l'expression qui correspond. Pour - insérer un caractère littéral "dollar" dans la chaîne de - remplacement, il faut l'échapper avec un anti-slash. Pour des - raisons historiques, la variable & peut être utilisée en tant + expressions rationnelles pour la substitution de chaînes, les + variables spéciales $1 ... $9 contiennent des références arrières + vers les parties regroupées (entre parenthèses) de l'expression + qui correspond. La variable spéciale $0 contient une référence + arrière vers l'ensemble de l'expression qui correspond. Pour + insérer un caractère littéral "dollar" dans la chaîne de + remplacement, il faut l'échapper avec un anti-slash. Pour des + raisons historiques, la variable & peut être utilisée en tant qu'alias de $0 dans certains cas, mais ceci n'est plus possible depuis la version 2.3.6. Apache utilise les Expressions Rationnelles Compatibles avec Perl fournies par la librairie <a href="http://www.pcre.org/">PCRE</a>. Vous trouverez plus - d'information à propos de la syntaxe des expressions rationnelles + d'information à propos de la syntaxe des expressions rationnelles PCRE sur ce site, ou dans le <a href="http://en.wikipedia.org/wiki/PCRE">Wikipedia de la PCRE</a>. </dd> @@ -265,109 +265,109 @@ (Configuration File)</a></dt> <dd>Un fichier texte contenant des <glossary ref="directive">Directives</glossary> - qui contrôlent la configuration d'Apache.<br /> + qui contrôlent la configuration d'Apache.<br /> Voir : <a href="configuring.html">Fichiers de configuration</a> </dd> <dt><a name="filter" id="filter">Filtre (Filter)</a></dt> - <dd>Un traitement appliqué aux données envoyées ou reçues par le serveur. - Les filtres en entrée traitent les données envoyées au serveur par le + <dd>Un traitement appliqué aux données envoyées ou reçues par le serveur. + Les filtres en entrée traitent les données envoyées au serveur par le client, alors que les filtres en sortie traitent les documents sur le - serveur avant qu'ils soient envoyés au client. + serveur avant qu'ils soient envoyés au client. Par exemple, le filtre en sortie <code>INCLUDES</code> traite les documents pour les - <glossary ref="ssi">Server Side Includes (Inclusions côté Serveur) + <glossary ref="ssi">Server Side Includes (Inclusions côté Serveur) </glossary>.<br /> Voir : <a href="filter.html">Filtres</a> </dd> <dt><a name="handler" id="handler">Gestionnaire (Handler)</a></dt> - <dd>Une représentation interne à Apache de l'action à entreprendre - quand un fichier est appelé. En général, les fichiers ont des gestionnaires - implicites, basés sur le type de fichier. Normalement, tous les + <dd>Une représentation interne à Apache de l'action à entreprendre + quand un fichier est appelé. En général, les fichiers ont des gestionnaires + implicites, basés sur le type de fichier. Normalement, tous les fichiers sont directement servis par le serveur, mais certains - types de fichiers sont "gérés" séparément. Par exemple, le gestionnaire - <code>cgi-script</code> désigne les fichiers qui doivent être traités + types de fichiers sont "gérés" séparément. Par exemple, le gestionnaire + <code>cgi-script</code> désigne les fichiers qui doivent être traités comme <glossary ref="cgi">CGIs</glossary>.<br /> Voir : <a href="handler.html">Utilisation des gestionnaires d'Apache</a> </dd> <dt><a name="hash" id="hash">Hachage (Hash)</a></dt> - <dd>Un algorithme mathématique à sens unique, irréversible, générant une - chaîne de longueur fixe à partir d'une autre chaîne de longueur quelconque. - Des chaînes différentes en entrée vont normalement produire des chaînes - différentes en sortie (selon la fonction de hachage). + <dd>Un algorithme mathématique à sens unique, irréversible, générant une + chaîne de longueur fixe à partir d'une autre chaîne de longueur quelconque. + Des chaînes différentes en entrée vont normalement produire des chaînes + différentes en sortie (selon la fonction de hachage). </dd> - <dt><a name="virtualhosting" id="virtualhosting">Hébergement Virtuel + <dt><a name="virtualhosting" id="virtualhosting">Hébergement Virtuel (Virtual Hosting)</a></dt> <dd>Servir des sites web multiples en utilisant une seule instance d'Apache. - Les <em>Hôtes virtuels basés sur IP</em> différencient les sites web en se + Les <em>Hôtes virtuels basés sur IP</em> différencient les sites web en se basant sur leur adresse IP, alors que les - <em>Hôtes virtuels basés sur le nom</em> utilisent uniquement le nom d'hôte - et peuvent en conséquence héberger de nombreux sites avec la même + <em>Hôtes virtuels basés sur le nom</em> utilisent uniquement le nom d'hôte + et peuvent en conséquence héberger de nombreux sites avec la même adresse IP.<br /> - Voir la <a href="vhosts/">Documentation des Hôtes Virtuels d'Apache</a> + Voir la <a href="vhosts/">Documentation des Hôtes Virtuels d'Apache</a> </dd> <dt><a name="htaccess" id="htaccess">.htaccess</a></dt> <dd>Un <glossary ref="configurationfile">fichier de configuration</glossary> - placé à un certain niveau de l'arborescence du site web, et appliquant des + placé à un certain niveau de l'arborescence du site web, et appliquant des <glossary ref="directive">directives</glossary> de configuration au - répertoire dans lequel il est placé, ainsi qu'à tous ses sous-répertoires. - En dépit de son nom, ce fichier peut contenir pratiquement tout type de - directive, et pas seulement des directives de contrôle d'accès.<br /> + répertoire dans lequel il est placé, ainsi qu'à tous ses sous-répertoires. + En dépit de son nom, ce fichier peut contenir pratiquement tout type de + directive, et pas seulement des directives de contrôle d'accès.<br /> Voir : <a href="configuring.html">Fichiers de configuration</a> </dd> <dt><a name="httpd.conf" id="httpd.conf">httpd.conf</a></dt> <dd>Le <glossary ref="configurationfile">fichier de configuration - </glossary> principal d'Apache. Sa localisation par défaut est - <code>/usr/local/apache2/conf/httpd.conf</code>, mais ceci peut être - changé en utilisant des options de compilation ou d'exécution.<br /> + </glossary> principal d'Apache. Sa localisation par défaut est + <code>/usr/local/apache2/conf/httpd.conf</code>, mais ceci peut être + changé en utilisant des options de compilation ou d'exécution.<br /> Voir : <a href="configuring.html">Fichiers de configuration</a> </dd> <dt><a name="https" id="https">HTTPS</a></dt> - <dd>Le Protocole de Transfert Hypertexte (Sécurisé), le mécanisme de - communication cryptée standard sur le World Wide Web. + <dd>Le Protocole de Transfert Hypertexte (Sécurisé), le mécanisme de + communication cryptée standard sur le World Wide Web. Il s'agit en fait de HTTP au dessus de <glossary ref="ssl">SSL</glossary>.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="uniformresourceidentifier" - id="uniformresourceidentifier">Identificateur de Ressource Uniformisé + id="uniformresourceidentifier">Identificateur de Ressource Uniformisé (Uniform Resource Identifier)</a> <a name="URI" id="URI">(URI)</a></dt> - <dd>Une chaîne de caractères compacte servant à identifier une ressource - abstraite ou physique. Elle est formellement définie par la <a + <dd>Une chaîne de caractères compacte servant à identifier une ressource + abstraite ou physique. Elle est formellement définie par la <a href="http://www.ietf.org/rfc/rfc2396.txt">RFC 2396</a>. Les URIs - utilisées sur le world-wide web sont souvent appelées <glossary + utilisées sur le world-wide web sont souvent appelées <glossary ref="url">URLs</glossary>. </dd> <dt><a name="serversideincludes" id="serversideincludes"> - Inclusions Côté Serveur + Inclusions Côté Serveur (Server Side Includes)</a> <a name="ssi" id="ssi">(SSI) </a></dt> <dd>Une technique permettant d'englober des directives de traitement dans des fichiers HTML.<br /> - Voir : <a href="howto/ssi.html">Introduction aux Inclusions Côté Serveur</a> + Voir : <a href="howto/ssi.html">Introduction aux Inclusions Côté Serveur</a> </dd> <dt><a name="servernameindication" id="servernameindication">Indication du nom du serveur</a> <a name="sni" id="sni">(SNI)</a></dt> - <dd>Une fonctionnalité SSL permettant de spécifier le - nom du serveur désiré dans le message initial de la - négociation SSL, de façon à ce que le serveur web - puisse choisir la bonne configuration de serveur virtuel à - utiliser pendant le déroulement de la négociation SSL. - Cette fonctionnalité a été ajoutée - à SSL lorsque sont apparues les extensions TLS, RFC 3546.<br /> + <dd>Une fonctionnalité SSL permettant de spécifier le + nom du serveur désiré dans le message initial de la + négociation SSL, de façon à ce que le serveur web + puisse choisir la bonne configuration de serveur virtuel à + utiliser pendant le déroulement de la négociation SSL. + Cette fonctionnalité a été ajoutée + à SSL lorsque sont apparues les extensions TLS, RFC 3546.<br /> Voir <a href="ssl/ssl_faq.html">la FAQ SSL</a> et <a href="http://www.ietf.org/rfc/rfc3546.txt">la RFC 3546</a> </dd> @@ -378,115 +378,115 @@ Interface commune avec les programmes externes (Common Gateway Interface)</a> <a name="cgi" id="cgi">(CGI)</a></dt> - <dd>La définition standard d'une interface entre un serveur web et un - programme externe pour permettre à ce dernier de traiter des requêtes. + <dd>La définition standard d'une interface entre un serveur web et un + programme externe pour permettre à ce dernier de traiter des requêtes. Il existe une <a href="http://www.ietf.org/rfc/rfc3875">RFC - informationnelle</a> qui en couvre les spécificités.<br /> + informationnelle</a> qui en couvre les spécificités.<br /> Voir : <a href="howto/cgi.html">Contenu dynamique avec CGI</a> </dd> <dt><a name="uniformresourcelocator" id="uniformresourcelocator"> -Localisation de Ressource Uniformisée +Localisation de Ressource Uniformisée (Uniform Resource Locator) </a> <a name="url" id="url">(URL)</a></dt> <dd>Le nom/adresse d'une ressource sur l'Internet. Il s'agit du terme - informel commun pour ce qui est formellement défini comme <glossary + informel commun pour ce qui est formellement défini comme <glossary ref="uniformresourceidentifier"> - Identificateur de Ressource Uniformisé</glossary>. - Les URLs sont généralement construites selon un schéma, comme + Identificateur de Ressource Uniformisé</glossary>. + Les URLs sont généralement construites selon un schéma, comme <code>http</code> ou - <code>https</code>, un nom d'hôte, et un chemin. Une URL pour cette page - pourrait être + <code>https</code>, un nom d'hôte, et un chemin. Une URL pour cette page + pourrait être <code>http://httpd.apache.org/docs/&httpd.docs;/glossary.html</code>. </dd> <dt><a name="proxy" id="proxy">Mandataire (Proxy)</a></dt> - <dd>Un serveur intermédiaire qui se situe entre le client et le + <dd>Un serveur intermédiaire qui se situe entre le client et le <em>serveur d'origine</em>. - Il prend en compte les requêtes des clients, les transmet au serveur - d'origine, puis renvoie la réponse du serveur d'origine au client. - Si plusieurs clients demandent le même contenu, le mandataire peut l'extraire - de son cache, plutôt que le demander au serveur d'origine - à chaque fois, ce qui réduit le temps de réponse.<br /> + Il prend en compte les requêtes des clients, les transmet au serveur + d'origine, puis renvoie la réponse du serveur d'origine au client. + Si plusieurs clients demandent le même contenu, le mandataire peut l'extraire + de son cache, plutôt que le demander au serveur d'origine + à chaque fois, ce qui réduit le temps de réponse.<br /> Voir : <a href="mod/mod_proxy.html">mod_proxy</a> </dd> <dt><a name="reverseproxy" id="reverseproxy">Mandataire inverse (Reverse Proxy)</a></dt> <dd>Un serveur <glossary ref="proxy">mandataire</glossary> qui est vu du client - comme un <em>serveur d'origine</em>. Ceci peut s'avérer utile pour - dissimuler le serveur d'origine réel au client pour des raisons de sécurité, - ou pour répartir la charge. + comme un <em>serveur d'origine</em>. Ceci peut s'avérer utile pour + dissimuler le serveur d'origine réel au client pour des raisons de sécurité, + ou pour répartir la charge. </dd> - <dt><a name="method" id="method">Méthode (Method)</a></dt> - <dd>Dans le contexte <glossary ref="http">HTTP</glossary>, une action à - effectuer sur une ressource spécifiée dans la ligne de requête - par le client. Parmi les méthodes disponibles dans HTTP, on trouve + <dt><a name="method" id="method">Méthode (Method)</a></dt> + <dd>Dans le contexte <glossary ref="http">HTTP</glossary>, une action à + effectuer sur une ressource spécifiée dans la ligne de requête + par le client. Parmi les méthodes disponibles dans HTTP, on trouve <code>GET</code>, <code>POST</code>, et <code>PUT</code>. </dd> <dt><a name="module" id="module">Module</a></dt> - <dd>Une partie indépendante d'un programme. De nombreuses fonctionnalités + <dd>Une partie indépendante d'un programme. De nombreuses fonctionnalités d'Apache sont fournies par des modules que vous pouvez choisir d'inclure - ou d'exclure. Les modules qui sont compilés dans le binaire - <program>httpd</program> sont appelés <dfn>modules statiques</dfn>, alors - que les modules qui existent séparément et peuvent être chargés - optionnellement à l'exécution sont appelés + ou d'exclure. Les modules qui sont compilés dans le binaire + <program>httpd</program> sont appelés <dfn>modules statiques</dfn>, alors + que les modules qui existent séparément et peuvent être chargés + optionnellement à l'exécution sont appelés <dfn>modules dynamiques</dfn> ou <glossary ref="dso">DSOs</glossary>. - Les modules qui sont inclus par défaut sont appelés + Les modules qui sont inclus par défaut sont appelés <dfn>modules de base</dfn>. De nombreux modules disponibles pour Apache ne se trouvent pas dans l'<glossary ref="tarball">archive</glossary> - du Serveur HTTP Apache . Il sont appelés + du Serveur HTTP Apache . Il sont appelés <dfn>modules tiers</dfn>.<br /> Voir : <a href="mod/">Index des modules</a> </dd> <dt><a name="passphrase" id="passphrase">Mot de Passe (Pass Phrase)</a></dt> - <dd>Le mot ou la phrase qui protège les fichiers de clés privées. - Il empêche les utilisateurs non autorisés de les déchiffrer. En général, - il s'agit simplement de la clé secrète de chiffrement/déchiffrement - utilisée pour les <glossary + <dd>Le mot ou la phrase qui protège les fichiers de clés privées. + Il empêche les utilisateurs non autorisés de les déchiffrer. En général, + il s'agit simplement de la clé secrète de chiffrement/déchiffrement + utilisée pour les <glossary ref="cipher">Algorithmes de chiffrement</glossary>.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="fully-qualifieddomain-name" - id="fully-qualifieddomain-name">Nom de domaine entièrement qualifié + id="fully-qualifieddomain-name">Nom de domaine entièrement qualifié (Fully-Qualified Domain-Name)</a> <a name="fqdn" id="fqdn">(FQDN)</a></dt> - <dd>Le nom unique d'une entité du réseau, comprenant un nom d'hôte et un - nom de domaine qui peuvent être résolus en une adresse IP. Par exemple, - <code>www</code> est un nom d'hôte, <code>example.com</code> est un nom + <dd>Le nom unique d'une entité du réseau, comprenant un nom d'hôte et un + nom de domaine qui peuvent être résolus en une adresse IP. Par exemple, + <code>www</code> est un nom d'hôte, <code>example.com</code> est un nom de domaine, et <code>www.example.com</code> est un nom de domaine - entièrement qualifié. + entièrement qualifié. </dd> <dt><a name="modulemagicnumber" id="modulemagicnumber"> Nombre Magique des Modules (Module Magic Number)</a> (<a name="mmn" id="mmn">MMN</a>)</dt> - <dd>Le Nombre Magique des Modules est une constante définie dans le code - source d'Apache et associée à la compatibilité binaire des modules. - Sa valeur est modifiée quand des structures internes d'Apache, des appels - de fonctions et d'autres parties significatives de l'API sont modifiées - de telle façon que la compatibilité binaire ne peut plus être garantie. - En cas de changement de MMN, tous les modules tiers doivent être au - moins recompilés, et parfois même légèrement modifiés afin de pouvoir + <dd>Le Nombre Magique des Modules est une constante définie dans le code + source d'Apache et associée à la compatibilité binaire des modules. + Sa valeur est modifiée quand des structures internes d'Apache, des appels + de fonctions et d'autres parties significatives de l'API sont modifiées + de telle façon que la compatibilité binaire ne peut plus être garantie. + En cas de changement de MMN, tous les modules tiers doivent être au + moins recompilés, et parfois même légèrement modifiés afin de pouvoir fonctionner avec la nouvelle version d'Apache. </dd> <dt><a name="dynamicsharedobject" id="dynamicsharedobject"> - Objet Dynamique Partagé (Dynamic Shared Object) + Objet Dynamique Partagé (Dynamic Shared Object) </a> <a name="dso" id="dso">(DSO)</a></dt> - <dd><glossary ref="module">Modules</glossary> compilés en dehors du binaire - Apache <program>httpd</program> et qui peuvent être - chargés à la demande.<br /> - Voir : <a href="dso.html">Support des objets dynamiques partagés</a> + <dd><glossary ref="module">Modules</glossary> compilés en dehors du binaire + Apache <program>httpd</program> et qui peuvent être + chargés à la demande.<br /> + Voir : <a href="dso.html">Support des objets dynamiques partagés</a> </dd> <dt><a name="openssl" id="openssl">OpenSSL</a></dt> @@ -498,8 +498,8 @@ Localisation de Ressource Uniformisée Outil de gestion des extensions Apache (APache eXtension Tool)</a> <a name="apxs" id="apxs">(apxs)</a></dt> - <dd>Un script Perl qui aide à la compilation des sources de <glossary - ref="module">module</glossary> sous forme d'Objets Dynamiques Partagés + <dd>Un script Perl qui aide à la compilation des sources de <glossary + ref="module">module</glossary> sous forme d'Objets Dynamiques Partagés (Dynamic Shared Objects ou <glossary ref="dso">DSO</glossary>s) et facilite leur installation dans le serveur Web Apache.<br /> @@ -507,7 +507,7 @@ Localisation de Ressource Uniformisée </dd> <dt><a name="plaintext" id="plaintext">Plein Texte (Plaintext)</a></dt> - <dd>Le texte non chiffré.</dd> + <dd>Le texte non chiffré.</dd> @@ -515,69 +515,69 @@ Localisation de Ressource Uniformisée id="hypertexttransferprotocol">Protocole de Transfert Hypertexte (HyperText Transfer Protocol)</a> <a name="http" id="hhtp">(HTTP)</a></dt> - <dd>Le protocole de transmission standard utilisé sur le World Wide Web. - Apache implémente la version 1.1 du protocole, référencée comme HTTP/1.1 et - définie par la + <dd>Le protocole de transmission standard utilisé sur le World Wide Web. + Apache implémente la version 1.1 du protocole, référencée comme HTTP/1.1 et + définie par la <a href="http://ietf.org/rfc/rfc2616.txt">RFC 2616</a>. </dd> - <dt><a name="messagedigest" id="messagedigest">Résumé de message + <dt><a name="messagedigest" id="messagedigest">Résumé de message (Message Digest)</a></dt> - <dd>Un hachage du message, qui peut être utilisé pour vérifier - que son contenu n'a pas été altéré durant le transfert.<br /> + <dd>Un hachage du message, qui peut être utilisé pour vérifier + que son contenu n'a pas été altéré durant le transfert.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="transportlayersecurity" id="transportlayersecurity"> - Sécurité de la couche Transport + Sécurité de la couche Transport (Transport Layer Security) </a> <a name="tls" id="tls">(TLS)</a></dt> - <dd>Le protocole successeur de SSL, créé par l'Internet Engineering Task - Force (IETF) pour l'authentification et le chiffrement généraux des - communications dans les réseaux TCP/IP. TLS version 1 est pratiquement - identique à SSL version 3.<br /> + <dd>Le protocole successeur de SSL, créé par l'Internet Engineering Task + Force (IETF) pour l'authentification et le chiffrement généraux des + communications dans les réseaux TCP/IP. TLS version 1 est pratiquement + identique à SSL version 3.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="session" id="session">Session</a></dt> - <dd>Les informations sur le contexte d'une communication en général.</dd> + <dd>Les informations sur le contexte d'une communication en général.</dd> - <dt><a name="digitalsignature" id="digitalsignature">Signature numérique + <dt><a name="digitalsignature" id="digitalsignature">Signature numérique (Digital Signature)</a></dt> - <dd>Un bloc de texte crypté qui valide un certificat ou un autre fichier. - Une <glossary ref="certificationauthority">Autorité de certification</glossary> - crée une signature en générant une empreinte de la <em>Clé publique</em> + <dd>Un bloc de texte crypté qui valide un certificat ou un autre fichier. + Une <glossary ref="certificationauthority">Autorité de certification</glossary> + crée une signature en générant une empreinte de la <em>Clé publique</em> fournie avec le <em>Certificat</em>; la CA chiffre ensuite l'empreinte - avec sa propre <em>Clé privée</em>. Seule la clé publique de la CA - peut décrypter la signature, ce qui permet de vérifier que la CA a bien - authentifié l'entité du réseau qui possède le + avec sa propre <em>Clé privée</em>. Seule la clé publique de la CA + peut décrypter la signature, ce qui permet de vérifier que la CA a bien + authentifié l'entité du réseau qui possède le <em>Certificat</em>.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="ssleay" id="ssleay">SSLeay</a></dt> - <dd>La bibliothèque originelle d'implémentation de SSL/TLS développée par + <dd>La bibliothèque originelle d'implémentation de SSL/TLS développée par Eric A. Young </dd> -<dt><a name="ciphertext" id="ciphertext">Texte crypté +<dt><a name="ciphertext" id="ciphertext">Texte crypté (Ciphertext)</a></dt> - <dd>Le résultat du passage d'un document + <dd>Le résultat du passage d'un document <glossary ref="plaintext">Plaintext</glossary> (Plein texte) par un <glossary ref="cipher">Cipher</glossary>.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> <dt><a name="mime-type" id="mime-type">Type MIME (MIME-type)</a></dt> - <dd>Une méthode pour décrire le type de document transmis. Son nom + <dd>Une méthode pour décrire le type de document transmis. Son nom vient du fait que son format est issu des Multipurpose Internet Mail Extensions (Extensions Multi-usages de la Messagerie par Internet) . Il comprend un type majeur et un type - mineur, séparés par un slash (barre oblique). On trouve + mineur, séparés par un slash (barre oblique). On trouve entre autres types <code>text/html</code>, <code>image/gif</code>, et <code>application/octet-stream</code>. Dans HTTP, le type MIME est transmis dans l' - <glossary ref="header">en-tête</glossary> <code>Content-Type</code>.<br /> + <glossary ref="header">en-tête</glossary> <code>Content-Type</code>.<br /> Voir : <a href="mod/mod_mime.html">mod_mime</a> </dd> @@ -586,18 +586,18 @@ Localisation de Ressource Uniformisée Variable d'environnement (Environment Variable)</a> <a name="env-variable" id="env-variable">(env-variable)</a></dt> - <dd>Ce sont des variables nommées gérées par le shell du système - d'exploitation, et servant au stockage d'informations et à la - communication entre les programmes. Apache possède aussi des variables - internes considérées comme variables d'environnement, mais stockées dans - des structures internes à Apache, et non dans l'environnement + <dd>Ce sont des variables nommées gérées par le shell du système + d'exploitation, et servant au stockage d'informations et à la + communication entre les programmes. Apache possède aussi des variables + internes considérées comme variables d'environnement, mais stockées dans + des structures internes à Apache, et non dans l'environnement du shell.<br /> Voir : <a href="env.html">Les variables d'environnement dans Apache</a> </dd> <dt><a name="x.509" id="x.509">X.509</a></dt> - <dd>Une norme de certificat d'authentification recommandée par l'International - Telecommunication Union (ITU-T) et utilisée pour + <dd>Une norme de certificat d'authentification recommandée par l'International + Telecommunication Union (ITU-T) et utilisée pour l'authentification SSL/TLS.<br /> Voir : <a href="ssl/">chiffrement SSL/TLS</a> </dd> diff --git a/docs/manual/index.xml.fr b/docs/manual/index.xml.fr index 83d2441264..28dd78695f 100644 --- a/docs/manual/index.xml.fr +++ b/docs/manual/index.xml.fr @@ -3,7 +3,7 @@ <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> -<!-- English Revision: 1767808:1780356 (outdated) --> +<!-- English Revision: 1780356 --> <!-- Licensed to the Apache Software Foundation (ASF) under one or more @@ -81,6 +81,7 @@ <page href="howto/public_html.html">Répertoires Web des utilisateurs (public_html)</page> <page href="howto/reverse_proxy.html">Guide de configuration d'un mandataire inverse</page> + <page href="howto/http2.html">Guide HTTP/2</page> </category> <category id="platform"><title>Notes spécifiques aux différentes plateformes</title> diff --git a/docs/manual/mod/core.xml.fr b/docs/manual/mod/core.xml.fr index 8247c148c0..b24d876866 100644 --- a/docs/manual/mod/core.xml.fr +++ b/docs/manual/mod/core.xml.fr @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1777163:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -1388,13 +1388,21 @@ Apache</compatibility> l'option <code>Strict</code>. L'option <code>Unsafe</code> a été ajoutée pour pouvoir restaurer les anciens comportements nécessaires aux anciens modules et applications et aux agents - utilisateurs personnalisés considérés comme obsolètes. Ces règles + utilisateurs personnalisés considérés comme obsolètes.</p> + + <p>Ces règles s'appliquant avant le traitement de la requête, elles doivent, pour être prises en compte, être définies au niveau global ou dans la première section par défaut du serveur virtuel qui correspond à la requête considérée, par interface IP/port et non par nom.</p> + <p>Cette directive accepte trois paramètres issus de la liste suivante, ceux + qui ne sont pas spécifiés prenant leur valeur par défaut :</p> + + <dl> + <dt>Strict|Unsafe</dt> + <dd> <p>Avant l'introduction de cette directive, les interpréteurs de requêtes du serveur HTTP Apache toléraient un grand nombre de formats en entrée qui n'étaient pas forcément conformes au protocole. <a @@ -1409,6 +1417,7 @@ Apache</compatibility> directive, toutes les règles de grammaire de la spécification doivent être respectées dans le mode d'opérations par défaut <code>Strict</code>.</p> + <note type="warning"><title>Risques de sécurité liés au mode Unsafe</title> <p>Il est fortement déconseillé aux utilisateurs d'utiliser le mode d'opération <code>Unsafe</code>, ou <code>UnsafeWhitespace</code>, en particulier pour les déploiements de @@ -1417,15 +1426,17 @@ Apache</compatibility> nécessite une interface, les utilisateurs ne doivent utiliser les options de type UnSafe qu'en cas de nécessité et uniquement au sein d'un serveur virtuel bien spécifique et sur un réseau privé.</p> + </note> - <p>La consultation des messages enregistrés dans le journal - <directive>ErrorLog</directive>, configuré via la directive - <directive>LogLevel</directive> avec un niveau <code>info</code>, pourra - vous aider à identifier de telles requêtes non conformes ainsi que leur - provenance. Les utilisateurs devront accorder une attention particulière aux - messages d'erreur de type 400 dans le journal access pour détecter les - requêtes apparemment valides mais rejetées.</p> - + <example> + <title>Exemple de requête provoquant l'envoi d'un message HTTP 400 en + mode Strict</title> + # Missing CRLF<br /> + GET / HTTP/1.0\n\n + </example> + </dd> + <dt>RegisteredMethods|LenientMethods</dt> + <dd> <p>La section de la <a href="https://tools.ietf.org/html/rfc7231#section-4.1">RFC 7231 §4.1</a> "Request Methods" "Overview" indique que les serveurs doivent @@ -1435,11 +1446,26 @@ Apache</compatibility> possibilité de limiter les méthodes utilisées via l'option <code>RegisteredMethods</code> en enregistrant toute méthode non standard via la directive <directive>RegisterHttpMethod</directive>, en particulier - si l'option <code>Unsafe</code> est utilisée. L'option + si l'option <code>Unsafe</code> est utilisée.</p> + + <note type="warning"><title>Compatibilité avec le mandat direct</title> + <p>L'option <code>RegisteredMethods</code> <strong>ne doit pas</strong> être utilisée pour les serveurs mandataires car ces derniers ne connaissent pas les méthodes supportées par les serveurs originaux.</p> + </note> + <example> + <title>Exemple de requête provoquant l'envoi d'un message HTTP 501 en + mode LenientMethods</title> + # Méthode HTTP inconnue<br /> + WOW / HTTP/1.0\r\n\r\n<br /><br /> + # Méthode HTTP spécifiée en minuscules<br /> + get / HTTP/1.0\r\n\r\n<br /> + </example> + </dd> + <dt>Allow0.9|Require1.0</dt> + <dd> <p>La section de la <a href="https://tools.ietf.org/html/rfc2616#section-19.6">RFC 2616 §19.6</a> "Compatibility With Previous Versions" encouragait les @@ -1450,6 +1476,23 @@ Apache</compatibility> A</a>. A ce titre, l'option <code>Require1.0</code> permet à l'utilisateur d'inhiber le comportement induit par l'option par défaut <code>Allow0.9</code>.</p> + + <example> + <title>Exemple de requête provoquant l'envoi d'un message HTTP 400 en + mode Require1.0</title> + # Version HTTP non supportée<br /> + GET /\r\n\r\n + </example> + </dd> + </dl> + + <p>La consultation des messages enregistrés dans le journal + <directive>ErrorLog</directive>, configuré via la directive + <directive>LogLevel</directive> avec un niveau <code>info</code>, pourra + vous aider à identifier de telles requêtes non conformes ainsi que leur + provenance. Les utilisateurs devront accorder une attention particulière aux + messages d'erreur de type 400 dans le journal access pour détecter les + requêtes apparemment valides mais rejetées.</p> </usage> </directivesynopsis> diff --git a/docs/manual/mod/mod_authnz_ldap.xml.fr b/docs/manual/mod/mod_authnz_ldap.xml.fr index 6052f29f27..f26017d03c 100644 --- a/docs/manual/mod/mod_authnz_ldap.xml.fr +++ b/docs/manual/mod/mod_authnz_ldap.xml.fr @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1736705:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> diff --git a/docs/manual/mod/mod_cache.xml.fr b/docs/manual/mod/mod_cache.xml.fr index ef5f7e375b..c845f71cde 100644 --- a/docs/manual/mod/mod_cache.xml.fr +++ b/docs/manual/mod/mod_cache.xml.fr @@ -1,7 +1,7 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1674195:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -25,93 +25,93 @@ <modulesynopsis metafile="mod_cache.xml.meta"> <name>mod_cache</name> -<description>Filtre de mise en cache HTTP conforme à la RFC 2616</description> +<description>Filtre de mise en cache HTTP conforme à la RFC 2616</description> <status>Extension</status> <sourcefile>mod_cache.c</sourcefile> <identifier>cache_module</identifier> <summary> - <note type="warning">Ce module doit être utilisé avec précautions + <note type="warning">Ce module doit être utilisé avec précautions car lorsque la directive <directive - module="mod_cache">CacheQuickHandler</directive> est définie à sa - valeur par défaut <strong>on</strong>, les directives <directive + module="mod_cache">CacheQuickHandler</directive> est définie à sa + valeur par défaut <strong>on</strong>, les directives <directive module="mod_access_compat">Allow</directive> and <directive - module="mod_access_compat">Deny</directive> sont court-circuitées. Vous + module="mod_access_compat">Deny</directive> sont court-circuitées. Vous ne devez donc pas activer la gestion rapide de la mise en cache pour - un contenu auquel vous souhaitez limiter l'accès en fonction du nom - d'hôte du client, de l'adresse IP ou d'une variable + un contenu auquel vous souhaitez limiter l'accès en fonction du nom + d'hôte du client, de l'adresse IP ou d'une variable d'environnement.</note> - <p><module>mod_cache</module> implémente un <strong>filtre de mise - en cache de contenu HTTP</strong> conforme à la <a + <p><module>mod_cache</module> implémente un <strong>filtre de mise + en cache de contenu HTTP</strong> conforme à la <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>, avec - support de la mise en cache des réponses dont le contenu a été - négocié et comportant l'en-tête Vary.</p> + support de la mise en cache des réponses dont le contenu a été + négocié et comportant l'en-tête Vary.</p> - <p>La mise en cache conforme à la RFC 2616 fournit un mécanisme - permettant de vérifier si un contenu expiré ou dépassé est encore à + <p>La mise en cache conforme à la RFC 2616 fournit un mécanisme + permettant de vérifier si un contenu expiré ou dépassé est encore à jour, et peut apporter un gain de performances significatif si le - serveur original supporte les <strong>requêtes - conditionnelles</strong> en prenant en compte l'en-tête de requête + serveur original supporte les <strong>requêtes + conditionnelles</strong> en prenant en compte l'en-tête de requête HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.26">If-None-Match</a>. - Le contenu n'est ainsi régénéré que lorsqu'il a été modifié, et non - lorsqu'il a expiré.</p> + Le contenu n'est ainsi régénéré que lorsqu'il a été modifié, et non + lorsqu'il a expiré.</p> - <p>En tant que filtre, <module>mod_cache</module> peut être placé + <p>En tant que filtre, <module>mod_cache</module> peut être placé en face d'un contenu issu de tout gestionnaire, y compris - <strong>des fichiers à accès séquentiel</strong> (servis depuis un + <strong>des fichiers à accès séquentiel</strong> (servis depuis un disque lent mis en cache sur un gros disque), la sortie d'un <strong>script - CGI</strong> ou d'un <strong>générateur de contenu - dynamique</strong>, ou du contenu <strong>mandaté depuis un autre + CGI</strong> ou d'un <strong>générateur de contenu + dynamique</strong>, ou du contenu <strong>mandaté depuis un autre serveur</strong>.</p> - <p>Dans la configuration par défaut, <module>mod_cache</module> + <p>Dans la configuration par défaut, <module>mod_cache</module> place le filtre de mise en cache aussi loin que possible dans la pile de filtres, utilisant le <strong>gestionnaire rapide</strong> - pour court-circuiter tout traitement par requête lors de l'envoi du - contenu au client. Dans ce mode opératoire, - <module>mod_cache</module> peut être considéré comme un serveur - mandataire avec cache fixé en tête du serveur web, alors qu'il - s'exécute dans ce même serveur web.</p> + pour court-circuiter tout traitement par requête lors de l'envoi du + contenu au client. Dans ce mode opératoire, + <module>mod_cache</module> peut être considéré comme un serveur + mandataire avec cache fixé en tête du serveur web, alors qu'il + s'exécute dans ce même serveur web.</p> - <p>Lorsque le gestionnaire rapide est désactivé via la directive + <p>Lorsque le gestionnaire rapide est désactivé via la directive <directive module="mod_cache">CacheQuickHandler</directive>, il - devient possible d'insérer le filtre <strong>CACHE</strong> à un + devient possible d'insérer le filtre <strong>CACHE</strong> à un point de la pile de filtres choisi par l'administrateur. Ceci permet de mettre en cache un contenu avant que celui-ci ne soit - personnalisé par le filtre <module>mod_include</module>, ou - éventuellement compressé par le filtre <module>mod_deflate</module>.</p> + personnalisé par le filtre <module>mod_include</module>, ou + éventuellement compressé par le filtre <module>mod_deflate</module>.</p> <p>Dans le mode de fonctionnement normal, <module>mod_cache</module> - peut être contrôlé par les en-têtes <a + peut être contrôlé par les en-têtes <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">Cache-Control</a> et <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.32">Pragma</a> - envoyés par un client dans une requête, ou par un serveur dans une - réponse. Dans des circonstances exceptionnelles, - <module>mod_cache</module> peut cependant être configuré pour - outrepasser ces en-têtes et forcer un comportement spécifique au - site, bien qu'un tel comportement sera limité à ce cache seulement, - et n'affectera pas les opérations des autres caches qui peuvent - s'insérer entre le client et le serveur, et ce type de configuration - ne doit donc être utiliser qu'en cas de nécessité absolue.</p> - - <p>La RFC 2616 permet au cache de renvoyer des données périmées - pendant que l'entrée périmée correspondante est mise à jour depuis + envoyés par un client dans une requête, ou par un serveur dans une + réponse. Dans des circonstances exceptionnelles, + <module>mod_cache</module> peut cependant être configuré pour + outrepasser ces en-têtes et forcer un comportement spécifique au + site, bien qu'un tel comportement sera limité à ce cache seulement, + et n'affectera pas les opérations des autres caches qui peuvent + s'insérer entre le client et le serveur, et ce type de configuration + ne doit donc être utiliser qu'en cas de nécessité absolue.</p> + + <p>La RFC 2616 permet au cache de renvoyer des données périmées + pendant que l'entrée périmée correspondante est mise à jour depuis le serveur original, et <module>mod_cache</module> supporte cette - fonctionnalité lorsque la directive <directive - module="mod_cache">CacheLock</directive> est configurée en - conséquence. De telles réponses comportent un en-tête HTTP <a + fonctionnalité lorsque la directive <directive + module="mod_cache">CacheLock</directive> est configurée en + conséquence. De telles réponses comportent un en-tête HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.46">Warning</a> - contenant un code de réponse 110. La RFC 2616 permet aussi au cache - de renvoyer des données périmées lorsque la tentative de mise à jour - des données périmées renvoie une erreur 500 ou supérieure, et cette - fonctionnalité est supportée par défaut par - <module>mod_cache</module>. De telles réponses comportent un en-tête HTTP <a + contenant un code de réponse 110. La RFC 2616 permet aussi au cache + de renvoyer des données périmées lorsque la tentative de mise à jour + des données périmées renvoie une erreur 500 ou supérieure, et cette + fonctionnalité est supportée par défaut par + <module>mod_cache</module>. De telles réponses comportent un en-tête HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.46">Warning</a> - contenant un code de réponse 111.</p> + contenant un code de réponse 111.</p> <p><module>mod_cache</module> requiert les services d'un ou plusieurs modules de gestion de stockage. La distribution Apache de base @@ -119,31 +119,31 @@ <dl> <dt><module>mod_cache_disk</module></dt> - <dd>implémente un gestionnaire de stockage sur disque. Les en-têtes - et corps sont stockés séparément sur le disque dans une structure de - répertoires basée sur le condensé md5 de l'URL mise en cache. - Plusieurs réponses à contenu négocié peuvent être stockées en même + <dd>implémente un gestionnaire de stockage sur disque. Les en-têtes + et corps sont stockés séparément sur le disque dans une structure de + répertoires basée sur le condensé md5 de l'URL mise en cache. + Plusieurs réponses à contenu négocié peuvent être stockées en même temps, mais la mise en cache de contenus partiels n'est pas - supportée par ce module. L'utilitaire + supportée par ce module. L'utilitaire <program>htcacheclean</program> permet de lister et de supprimer les - URLs mises en cache, et de maintenir le cache en deçà de + URLs mises en cache, et de maintenir le cache en deçà de certaines limites de taille et de nombre d'inodes.</dd> <dt><module>mod_cache_socache</module></dt> - <dd>Implémente un gestionnaire de stockage basé sur un cache d'objets - partagés. Les en-têtes et corps sont stockés ensemble sous une seule - clé basée sur l'URL de la réponse mise en cache. Des réponses à - contenus multiples négociés peuvent être stockées simultanément, mais + <dd>Implémente un gestionnaire de stockage basé sur un cache d'objets + partagés. Les en-têtes et corps sont stockés ensemble sous une seule + clé basée sur l'URL de la réponse mise en cache. Des réponses à + contenus multiples négociés peuvent être stockées simultanément, mais ce module ne supporte pas la mise en cache de contenus partiels.</dd> </dl> - <p>Pour de plus amples détails, une description, et des exemples, + <p>Pour de plus amples détails, une description, et des exemples, reportez-vous au <a href="../caching.html">Guide de la mise en cache</a>.</p> </summary> <seealso><a href="../caching.html">Guide de la mise en cache</a></seealso> -<section id="related"><title>Modules apparentés et directives</title> +<section id="related"><title>Modules apparentés et directives</title> <related> <modulelist> <module>mod_cache_socache</module> @@ -181,70 +181,70 @@ LoadModule cache_module modules/mod_cache.so </IfModule> # Lorsqu'on sert de mandataire, on ne met pas en cache la liste -# des mises à jour de sécurité +# des mises à jour de sécurité CacheDisable http://security.update.server/update-list/ </IfModule> </highlight> </example> </section> -<section id="thunderingherd"><title>Eviter une tempête de requête</title> - <p>Lorsqu'une entrée du cache est périmée, <module>mod_cache</module> - soumet une requête conditionnelle au processus d'arrière-plan, qui est - censé confirmer la validité de l'entrée du cache, ou dans la négative - envoyer une entrée mise à jour.</p> - <p>Un court mais non négligeable laps de temps existe entre le moment - où l'entrée du cache est périmée, et le moment où elle est mise à - jour. Sur un serveur fortement chargé, un certain nombre de requêtes +<section id="thunderingherd"><title>Eviter une tempête de requête</title> + <p>Lorsqu'une entrée du cache est périmée, <module>mod_cache</module> + soumet une requête conditionnelle au processus d'arrière-plan, qui est + censé confirmer la validité de l'entrée du cache, ou dans la négative + envoyer une entrée mise à jour.</p> + <p>Un court mais non négligeable laps de temps existe entre le moment + où l'entrée du cache est périmée, et le moment où elle est mise à + jour. Sur un serveur fortement chargé, un certain nombre de requêtes peut arriver pendant ce laps de temps, et provoquer une - <strong>tempête</strong> de requêtes susceptibles de saturer le - processus d'arrière-plan de manière soudaine et imprédictible.</p> - <p>Pour contenir cette tempête, on peut utiliser la directive - <directive>CacheLock</directive> afin de définir un répertoire où - seront créés <strong>à la volée</strong> des verrous pour les URLs. - Ces verrous sont utilisés comme autant d'<strong>indications</strong> - par les autres requêtes, soit pour empêcher une tentative de mise en - cache (un autre processus est en train de récupérer l'entité), soit - pour indiquer qu'une entrée périmée est en cours de mise à jour - (pendant ce temps, c'est le contenu périmé qui sera renvoyé). + <strong>tempête</strong> de requêtes susceptibles de saturer le + processus d'arrière-plan de manière soudaine et imprédictible.</p> + <p>Pour contenir cette tempête, on peut utiliser la directive + <directive>CacheLock</directive> afin de définir un répertoire où + seront créés <strong>à la volée</strong> des verrous pour les URLs. + Ces verrous sont utilisés comme autant d'<strong>indications</strong> + par les autres requêtes, soit pour empêcher une tentative de mise en + cache (un autre processus est en train de récupérer l'entité), soit + pour indiquer qu'une entrée périmée est en cours de mise à jour + (pendant ce temps, c'est le contenu périmé qui sera renvoyé). </p> <section> - <title>Mise en cache initiale d'une entrée</title> - <p>Lorsqu'une entité est mise en cache pour la première fois, un - verrou est créé pour cette entité jusqu'à ce que la réponse ait été - entièrement mise en cache. Pendant la durée de vie du verrou, le - cache va empêcher une seconde tentative de mise en cache de la même - entité. Bien que cela ne suffise pas à contenir la tempête de - requêtes, toute tentative de mettre en cache la même entité - plusieurs fois simultanément est stoppée. + <title>Mise en cache initiale d'une entrée</title> + <p>Lorsqu'une entité est mise en cache pour la première fois, un + verrou est créé pour cette entité jusqu'à ce que la réponse ait été + entièrement mise en cache. Pendant la durée de vie du verrou, le + cache va empêcher une seconde tentative de mise en cache de la même + entité. Bien que cela ne suffise pas à contenir la tempête de + requêtes, toute tentative de mettre en cache la même entité + plusieurs fois simultanément est stoppée. </p> </section> <section> - <title>Mise à jour d'une entrée périmée</title> - <p>Lorsqu'une entrée atteint la limite de sa durée de vie, et - devient par conséquent périmée, un verrou est créé pour cette entité - jusqu'à ce que la réponse ait été soit confirmée comme encore - valide, soit remplacée par le processus d'arrière-plan. Pendant la - durée de vie du verrou, une seconde requête entrante va provoquer le - renvoi de la donnée périmée, et la tempête de requêtes sera + <title>Mise à jour d'une entrée périmée</title> + <p>Lorsqu'une entrée atteint la limite de sa durée de vie, et + devient par conséquent périmée, un verrou est créé pour cette entité + jusqu'à ce que la réponse ait été soit confirmée comme encore + valide, soit remplacée par le processus d'arrière-plan. Pendant la + durée de vie du verrou, une seconde requête entrante va provoquer le + renvoi de la donnée périmée, et la tempête de requêtes sera contenue.</p> </section> <section> - <title>Verrous et en-tête Cache-Control: no-cache</title> - <p>Les verrous ne sont utilisés <strong>qu'à titre - indicatif</strong> pour enjoindre le cache à être plus coopératif - avec les serveurs d'arrière-plan, et il est possible de passer outre - si nécessaire. Si le client envoie une requête contenant un en-tête - Cache-Control imposant un nouveau téléchargement de l'entité, tout - verrou éventuel sera ignoré, la requête du client sera honorée - immédiatement, et l'entrée du cache mise à jour.</p> - - <p>Comme mécanisme de sécurité supplémentaire, la durée de vie + <title>Verrous et en-tête Cache-Control: no-cache</title> + <p>Les verrous ne sont utilisés <strong>qu'à titre + indicatif</strong> pour enjoindre le cache à être plus coopératif + avec les serveurs d'arrière-plan, et il est possible de passer outre + si nécessaire. Si le client envoie une requête contenant un en-tête + Cache-Control imposant un nouveau téléchargement de l'entité, tout + verrou éventuel sera ignoré, la requête du client sera honorée + immédiatement, et l'entrée du cache mise à jour.</p> + + <p>Comme mécanisme de sécurité supplémentaire, la durée de vie maximale des verrous est configurable. Lorsque cette limite est - atteinte, le verrou est supprimé et une autre requête peut alors en - créer un nouveau. Cette durée de vie peut être définie via la + atteinte, le verrou est supprimé et une autre requête peut alors en + créer un nouveau. Cette durée de vie peut être définie via la directive <directive>CacheLockMaxAge</directive>, et sa valeur par - défaut est de 5 secondes. + défaut est de 5 secondes. </p> </section> <section> @@ -264,38 +264,38 @@ LoadModule cache_module modules/mod_cache.so </section> </section> -<section id="finecontrol"><title>Contrôle fin via le filtre CACHE</title> - <p>Dans son mode de fonctionnement par défaut, le cache s'exécute sous - la forme d'un gestionnaire rapide, court-circuitant la majorité des +<section id="finecontrol"><title>Contrôle fin via le filtre CACHE</title> + <p>Dans son mode de fonctionnement par défaut, le cache s'exécute sous + la forme d'un gestionnaire rapide, court-circuitant la majorité des traitements du serveur et fournissant ainsi une mise en cache - possédant les plus hautes performances disponibles.</p> + possédant les plus hautes performances disponibles.</p> <p>Dans ce mode, le cache <strong>s'incruste</strong> devant le - serveur, comme si un mandataire de mise en cache indépendant RFC 2616 - était placé devant ce dernier.</p> + serveur, comme si un mandataire de mise en cache indépendant RFC 2616 + était placé devant ce dernier.</p> <p>Bien que que ce mode offre les meilleures performances, les administrateurs peuvent souhaiter, dans certaines circonstances, - effectuer des traitements sur la requête après que cette dernière ait - été mise en cache, comme ajouter du contenu personnalisé à la page + effectuer des traitements sur la requête après que cette dernière ait + été mise en cache, comme ajouter du contenu personnalisé à la page mise en cache, ou appliquer des restrictions d'autorisations au - contenu. Pour y parvenir, l'administrateur sera alors souvent forcé de - placer des serveurs mandataires inverses indépendants soit derrière, + contenu. Pour y parvenir, l'administrateur sera alors souvent forcé de + placer des serveurs mandataires inverses indépendants soit derrière, soit devant le serveur de mise en cache.</p> - <p>Pour résoudre ce problème, la directive <directive - module="mod_cache">CacheQuickHandler</directive> peut être définie à + <p>Pour résoudre ce problème, la directive <directive + module="mod_cache">CacheQuickHandler</directive> peut être définie à <strong>off</strong>, afin que le serveur traite toutes les phases - normalement exécutées par une requête non mise en cache, y compris les + normalement exécutées par une requête non mise en cache, y compris les phases <strong>d'authentification et d'autorisation</strong>.</p> - <p>En outre, l'administrateur peut éventuellement spécifier le - <strong>point précis dans la chaîne de filtrage</strong> où devra + <p>En outre, l'administrateur peut éventuellement spécifier le + <strong>point précis dans la chaîne de filtrage</strong> où devra intervenir la mise en cache en ajoutant le filtre - <strong>CACHE</strong> à la chaîne de filtrage en sortie.</p> + <strong>CACHE</strong> à la chaîne de filtrage en sortie.</p> <p>Par exemple, pour mettre en cache le contenu avant d'appliquer une - compression à la réponse, placez le filtre <strong>CACHE</strong> + compression à la réponse, placez le filtre <strong>CACHE</strong> avant le filtre <strong>DEFLATE</strong> comme dans l'exemple suivant :</p> @@ -305,12 +305,12 @@ CacheQuickHandler off AddOutputFilterByType CACHE;DEFLATE text/plain </highlight> - <p>Une autre possibilité consiste à mettre en cache le contenu avant - l'ajout de contenu personnalisé via <module>mod_include</module> (ou + <p>Une autre possibilité consiste à mettre en cache le contenu avant + l'ajout de contenu personnalisé via <module>mod_include</module> (ou tout autre filtre de traitement de contenu). Dans l'exemple suivant, - les modèles contenant des balises comprises par - <module>mod_include</module> sont mis en cache avant d'être - interprétés :</p> + les modèles contenant des balises comprises par + <module>mod_include</module> sont mis en cache avant d'être + interprétés :</p> <highlight language="config"> # Mise en cache du contenu avant l'intervention de mod_include et @@ -319,10 +319,10 @@ CacheQuickHandler off AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html </highlight> - <p>Vous pouvez insérer le filtre <strong>CACHE</strong> en tout point - de la chaîne de filtrage. Dans l'exemple suivant, le contenu est mis - en cache après avoir été interprété par <module>mod_include</module>, - mais avant d'être traité par <module>mod_deflate</module> :</p> + <p>Vous pouvez insérer le filtre <strong>CACHE</strong> en tout point + de la chaîne de filtrage. Dans l'exemple suivant, le contenu est mis + en cache après avoir été interprété par <module>mod_include</module>, + mais avant d'être traité par <module>mod_deflate</module> :</p> <highlight language="config"> # Mise en cache du contenu entre les interventions de mod_include et @@ -333,41 +333,41 @@ AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html <note type="warning"><title>Avertissement :</title>Si pour une raison ou pour une autre, le point d'insertion du filtre - <strong>CACHE</strong> dans la chaîne de filtrage est modifié, vous - devez <strong>vider votre cache</strong> pour être sûr que les données - servies soient à jour. En effet, <module>mod_cache</module> n'est pas - en mesure d'effectuer cette opération à votre place.</note> + <strong>CACHE</strong> dans la chaîne de filtrage est modifié, vous + devez <strong>vider votre cache</strong> pour être sûr que les données + servies soient à jour. En effet, <module>mod_cache</module> n'est pas + en mesure d'effectuer cette opération à votre place.</note> </section> <section id="status"><title>Etat du cache et journalisation</title> - <p>Lorsque <module>mod_cache</module> a décidé s'il devait ou non - servir une entité depuis le cache, les raisons précises de cette - décision sont enregistrées dans l'environnement du sous-processus - interne à la requête sous la clé <strong>cache-status</strong>. - Cette information peut être journalisée via la directive <directive + <p>Lorsque <module>mod_cache</module> a décidé s'il devait ou non + servir une entité depuis le cache, les raisons précises de cette + décision sont enregistrées dans l'environnement du sous-processus + interne à la requête sous la clé <strong>cache-status</strong>. + Cette information peut être journalisée via la directive <directive module="mod_log_config">LogFormat</directive> comme suit :</p> <highlight language="config"> LogFormat "%{cache-status}e ..." </highlight> - <p>En fonction de la décision prise, l'information est aussi écrite - dans l'environnement du sous-processus sous une des quatre clés + <p>En fonction de la décision prise, l'information est aussi écrite + dans l'environnement du sous-processus sous une des quatre clés suivantes :</p> <dl> - <dt>cache-hit</dt><dd>Le contenu a été servi depuis le cache.</dd> - <dt>cache-revalidate</dt><dd>Le contenu du cache était périmé, a été - mis à jour avec succès, puis servi depuis le cache.</dd> - <dt>cache-miss</dt><dd>Le contenu n'était pas dans le cache et a été - servi directement depuis le serveur demandé.</dd> - <dt>cache-invalidate</dt><dd>L'entité du cache est devenue invalide - suite à une requête d'un type autre que GET ou HEAD.</dd> + <dt>cache-hit</dt><dd>Le contenu a été servi depuis le cache.</dd> + <dt>cache-revalidate</dt><dd>Le contenu du cache était périmé, a été + mis à jour avec succès, puis servi depuis le cache.</dd> + <dt>cache-miss</dt><dd>Le contenu n'était pas dans le cache et a été + servi directement depuis le serveur demandé.</dd> + <dt>cache-invalidate</dt><dd>L'entité du cache est devenue invalide + suite à une requête d'un type autre que GET ou HEAD.</dd> </dl> <p>Il est alors possible d'envisager une journalisation conditionnelle - du traitement des requêtes par rapport au cache comme dans l'exemple + du traitement des requêtes par rapport au cache comme dans l'exemple suivant :</p> <highlight language="config"> @@ -377,60 +377,60 @@ CustomLog "revalidated-requests.log" common env=cache-revalidate CustomLog "invalidated-requests.log" common env=cache-invalidate </highlight> - <p>Pour les concepteurs de modules, une accroche (hook) nommée + <p>Pour les concepteurs de modules, une accroche (hook) nommée <var>cache_status</var> est disponible et permet aux modules de - répondre aux résultats de la vérification du cache ci-dessus de manière - personnalisée.</p> + répondre aux résultats de la vérification du cache ci-dessus de manière + personnalisée.</p> </section> <directivesynopsis> <name>CacheEnable</name> -<description>Active la mise en cache des URLs spécifiées en utilisant le -gestionnaire de stockage précisé</description> -<syntax>CacheEnable <var>type de cache</var> [<var>chaîne +<description>Active la mise en cache des URLs spécifiées en utilisant le +gestionnaire de stockage précisé</description> +<syntax>CacheEnable <var>type de cache</var> [<var>chaîne URL</var>]</syntax> <contextlist><context>server config</context><context>virtual host</context> <context>directory</context> </contextlist> -<compatibility>Une chaîne URL telle que '/' s'appliquait à tout contenu -en mandat direct dans les versions 2.2 et antérieures.</compatibility> +<compatibility>Une chaîne URL telle que '/' s'appliquait à tout contenu +en mandat direct dans les versions 2.2 et antérieures.</compatibility> <usage> <p>La directive <directive>CacheEnable</directive> enjoint - <module>mod_cache</module> de mettre en cache l'URL précisée par - <var>chaîne URL</var>, ainsi que les URLs de niveaux inférieurs. Le - gestionnaire de stockage du cache est spécifié à l'aide de + <module>mod_cache</module> de mettre en cache l'URL précisée par + <var>chaîne URL</var>, ainsi que les URLs de niveaux inférieurs. Le + gestionnaire de stockage du cache est spécifié à l'aide de l'argument <var>type de cache</var>. La directive - <directive>CacheEnable</directive> peut être placée à l'intérieur d'une + <directive>CacheEnable</directive> peut être placée à l'intérieur d'une section <directive type="section">Location</directive> ou <directive type="section">LocationMatch</directive> pour indiquer que le - contenu considéré peut être mis en cache. Si <var>type de cache</var> + contenu considéré peut être mis en cache. Si <var>type de cache</var> a pour valeur <code>disk</code>, <module>mod_cache</module> - utilisera le gestionnaire de stockage sur disque implémenté par + utilisera le gestionnaire de stockage sur disque implémenté par <module>mod_cache_disk</module>. Pour que <module>mod_cache</module> - utilise le gestionnaire de stockage basé sur le cache d'objets - partagés implémenté par <module>mod_cache_socache</module>, - spécifiez <code>socache</code> comme valeur du paramètre <var>type + utilise le gestionnaire de stockage basé sur le cache d'objets + partagés implémenté par <module>mod_cache_socache</module>, + spécifiez <code>socache</code> comme valeur du paramètre <var>type de cache</var>.</p> - <p>Si les différentes directives <directive>CacheEnable</directive> - spécifient des URLs qui se recoupent (comme dans l'exemple + <p>Si les différentes directives <directive>CacheEnable</directive> + spécifient des URLs qui se recoupent (comme dans l'exemple ci-dessous), tous les gestionnaires de stockage possibles seront - lancés, jusqu'au premier d'entre eux qui traitera effectivement la - requête. - L'ordre dans lequel les gestionnaires de stockage sont lancés est - déterminé par l'ordre dans lequel apparaissent les directives + lancés, jusqu'au premier d'entre eux qui traitera effectivement la + requête. + L'ordre dans lequel les gestionnaires de stockage sont lancés est + déterminé par l'ordre dans lequel apparaissent les directives <directive>CacheEnable</directive> dans le fichier de configuration. Les directives <directive>CacheEnable</directive> - situées à l'intérieur de sections <directive + situées à l'intérieur de sections <directive type="section">Location</directive> ou <directive - type="section">LocationMatch</directive> sont traitées avant les - directives <directive>CacheEnable</directive> définies au niveau + type="section">LocationMatch</directive> sont traitées avant les + directives <directive>CacheEnable</directive> définies au niveau global.</p> - <p>En fonctionnement du type serveur mandataire direct, <var>chaîne - URL</var> doit au moins débuter par un protocole pour lequel la mise - en cache doit être activée.</p> + <p>En fonctionnement du type serveur mandataire direct, <var>chaîne + URL</var> doit au moins débuter par un protocole pour lequel la mise + en cache doit être activée.</p> <highlight language="config"> # Mise en cache de contenu (gestionnaire normal seulement) @@ -445,33 +445,33 @@ CacheQuickHandler off CacheEnable disk </LocationMatch> -# Mise en cache de tous les contenus, à l'exception des URLs -# mandatées en direct (gestionnaire normal ou rapide) +# Mise en cache de tous les contenus, à l'exception des URLs +# mandatées en direct (gestionnaire normal ou rapide) CacheEnable disk / -# Mise en cache des URLs FTP mandatées (gestionnaire normal ou rapide) +# Mise en cache des URLs FTP mandatées (gestionnaire normal ou rapide) CacheEnable disk ftp:// -# Mise en cache des contenus mandatés en direct depuis www.example.org (gestionnaire normal ou rapide) +# Mise en cache des contenus mandatés en direct depuis www.example.org (gestionnaire normal ou rapide) CacheEnable disk http://www.example.org/ </highlight> - <p>Un nom d'hôte commençant par un caractère <strong>"*"</strong> - correspondra à tout nom d'hôte se terminant par le suffixe - considéré. Un nom d'hôte commençant par un caractère - <strong>"."</strong> correspondra à tout nom d'hôte contenant le - composant de nom de domaine qui suit ce caractère.</p> + <p>Un nom d'hôte commençant par un caractère <strong>"*"</strong> + correspondra à tout nom d'hôte se terminant par le suffixe + considéré. Un nom d'hôte commençant par un caractère + <strong>"."</strong> correspondra à tout nom d'hôte contenant le + composant de nom de domaine qui suit ce caractère.</p> <highlight language="config"> -# Correspond à www.example.org et fooexample.org +# Correspond à www.example.org et fooexample.org CacheEnable disk http://*example.org/ -# Correspond à www.example.org, mais pas à fooexample.org +# Correspond à www.example.org, mais pas à fooexample.org CacheEnable disk http://.example.org/ </highlight> - <p>Depuis la version 2.2.12, on peut définir la variable - d'environnement <code>no-cache</code> pour une définition plus fine - des ressources à mettre en cache.</p> + <p>Depuis la version 2.2.12, on peut définir la variable + d'environnement <code>no-cache</code> pour une définition plus fine + des ressources à mettre en cache.</p> </usage> <seealso><a href="../env.html">Les variables d'environnement dans @@ -480,9 +480,9 @@ Apache</a></seealso> <directivesynopsis> <name>CacheDisable</name> -<description>Désactive la mise en cache des URLs -spécifiées</description> -<syntax>CacheDisable <var>chaîne-url</var> | <var>on</var></syntax> +<description>Désactive la mise en cache des URLs +spécifiées</description> +<syntax>CacheDisable <var>chaîne-url</var> | <var>on</var></syntax> <contextlist><context>server config</context><context>virtual host</context> <context>directory</context><context>.htaccess</context> </contextlist> @@ -490,8 +490,8 @@ spécifiées</description> <usage> <p>La directive <directive>CacheDisable</directive> enjoint <module>mod_cache</module> de <em>ne pas</em> mettre en cache l'URL - spécifiée par <var>chaîne URL</var>, ainsi que les URLs de niveaux - inférieurs.</p> + spécifiée par <var>chaîne URL</var>, ainsi que les URLs de niveaux + inférieurs.</p> <example><title>Exemple</title> <highlight language="config"> @@ -499,10 +499,10 @@ spécifiées</description> </highlight> </example> - <p>Si la directive se trouve à l'intérieur d'une section <directive - type="section">Location</directive>, le chemin doit être spécifié en - dessous de la Location, et si le mot "on" est utilisé, la mise en - cache sera désactivée pour l'ensemble de l'arborescence concernée + <p>Si la directive se trouve à l'intérieur d'une section <directive + type="section">Location</directive>, le chemin doit être spécifié en + dessous de la Location, et si le mot "on" est utilisé, la mise en + cache sera désactivée pour l'ensemble de l'arborescence concernée par la section Location.</p> <example><title>Exemple</title> @@ -513,31 +513,31 @@ spécifiées</description> </highlight> </example> - <p>Avec les versions 2.2.12 et ultérieures, on peut définir la - variable d'environnement <code>no-cache</code> pour une définition - plus fine des ressources à mettre en cache.</p> + <p>Avec les versions 2.2.12 et ultérieures, on peut définir la + variable d'environnement <code>no-cache</code> pour une définition + plus fine des ressources à mettre en cache.</p> </usage> <seealso><a href="../env.html">Les variables d'environnement dans Apache</a></seealso> </directivesynopsis> <directivesynopsis> <name>CacheMaxExpire</name> -<description>La durée maximale en secondes de mise en cache d'un +<description>La durée maximale en secondes de mise en cache d'un document</description> <syntax>CacheMaxExpire <var>secondes</var></syntax> -<default>CacheMaxExpire 86400 (une journée)</default> +<default>CacheMaxExpire 86400 (une journée)</default> <contextlist><context>server config</context><context>virtual host</context> <context>directory</context><context>.htaccess</context> </contextlist> <usage> <p>La directive <directive>CacheMaxExpire</directive> permet de - spécifier le nombre maximum de secondes pendant lequel les documents - HTTP suceptibles d'être mis en cache seront conservés sans vérifier + spécifier le nombre maximum de secondes pendant lequel les documents + HTTP suceptibles d'être mis en cache seront conservés sans vérifier leur contenu sur le serveur d'origine. Ce nombre de secondes - correspond donc à la durée maximale pendant laquelle un document ne - sera pas à jour. L'utilisation de cette valeur maximale est forcée, - même si le document possède une date d'expiration.</p> + correspond donc à la durée maximale pendant laquelle un document ne + sera pas à jour. L'utilisation de cette valeur maximale est forcée, + même si le document possède une date d'expiration.</p> <highlight language="config"> CacheMaxExpire 604800 @@ -548,7 +548,7 @@ document</description> <directivesynopsis> <name>CacheMinExpire</name> -<description>La durée minimale en secondes de mise en cache d'un +<description>La durée minimale en secondes de mise en cache d'un document</description> <syntax>CacheMinExpire <var>secondes</var></syntax> <default>CacheMinExpire 0</default> @@ -558,10 +558,10 @@ document</description> <usage> <p>La directive <directive>CacheMaxExpire</directive> permet de - spécifier le nombre maximum de secondes pendant lequel les documents - HTTP suceptibles d'être mis en cache seront conservés sans vérifier + spécifier le nombre maximum de secondes pendant lequel les documents + HTTP suceptibles d'être mis en cache seront conservés sans vérifier leur contenu sur le serveur d'origine. Elle n'est prise en compte - que dans le cas où le document ne possède aucune date d'expiration + que dans le cas où le document ne possède aucune date d'expiration valide.</p> <highlight language="config"> @@ -572,8 +572,8 @@ document</description> <directivesynopsis> <name>CacheDefaultExpire</name> -<description>La durée par défaut de mise en cache d'un document -lorsqu'aucune date d'expiration n'a été spécifiée.</description> +<description>La durée par défaut de mise en cache d'un document +lorsqu'aucune date d'expiration n'a été spécifiée.</description> <syntax>CacheDefaultExpire <var>secondes</var></syntax> <default>CacheDefaultExpire 3600 (une heure)</default> <contextlist><context>server config</context><context>virtual host</context> @@ -582,12 +582,12 @@ lorsqu'aucune date d'expiration n'a été spécifiée.</ <usage> <p>La directive <directive>CacheDefaultExpire</directive> permet de - spécifier un temps par défaut, en secondes, pendant lequel sera - conservé dans le cache un document qui ne possède ni date - d'expiration, ni date de dernière modification. La valeur de cette - directive est écrasée par la valeur de la directive - <directive>CacheMaxExpire</directive> si cette dernière est - utilisée.</p> + spécifier un temps par défaut, en secondes, pendant lequel sera + conservé dans le cache un document qui ne possède ni date + d'expiration, ni date de dernière modification. La valeur de cette + directive est écrasée par la valeur de la directive + <directive>CacheMaxExpire</directive> si cette dernière est + utilisée.</p> <highlight language="config"> CacheDefaultExpire 86400 @@ -597,7 +597,7 @@ lorsqu'aucune date d'expiration n'a été spécifiée.</ <directivesynopsis> <name>CacheIgnoreNoLastMod</name> -<description>Ignore le fait qu'une réponse ne possède pas d'en-tête Last +<description>Ignore le fait qu'une réponse ne possède pas d'en-tête Last Modified.</description> <syntax>CacheIgnoreNoLastMod On|Off</syntax> <default>CacheIgnoreNoLastMod Off</default> @@ -606,17 +606,17 @@ Modified.</description> </contextlist> <usage> - <p>Normalement, les documents qui ne possèdent pas de date de - dernière modification ne sont pas mis en cache. Dans certaines - circonstances, la date de dernière modification est supprimée (au - cours des traitements liés à <module>mod_include</module> par + <p>Normalement, les documents qui ne possèdent pas de date de + dernière modification ne sont pas mis en cache. Dans certaines + circonstances, la date de dernière modification est supprimée (au + cours des traitements liés à <module>mod_include</module> par exemple), ou n'existe tout simplement pas. La directive - <directive>CacheIgnoreNoLastMod</directive> permet de spécifier si - les documents ne possèdant pas de date de dernière modification - doivent être mis en cache, même sans date de dernière modification. - Si le document ne possède ni date d'expiration, ni date de dernière - modification, la valeur spécifiée par la directive - <directive>CacheDefaultExpire</directive> servira à générer une date + <directive>CacheIgnoreNoLastMod</directive> permet de spécifier si + les documents ne possèdant pas de date de dernière modification + doivent être mis en cache, même sans date de dernière modification. + Si le document ne possède ni date d'expiration, ni date de dernière + modification, la valeur spécifiée par la directive + <directive>CacheDefaultExpire</directive> servira à générer une date d'expiration. </p> @@ -628,7 +628,7 @@ Modified.</description> <directivesynopsis> <name>CacheIgnoreCacheControl</name> -<description>Ignore les en-têtes de requête enjoignant de ne pas servir +<description>Ignore les en-têtes de requête enjoignant de ne pas servir le contenu au client depuis le cache</description> <syntax>CacheIgnoreCacheControl On|Off</syntax> <default>CacheIgnoreCacheControl Off</default> @@ -636,13 +636,13 @@ le contenu au client depuis le cache</description> </contextlist> <usage> - <p>Normalement, les requêtes contenant des en-têtes tels que + <p>Normalement, les requêtes contenant des en-têtes tels que Cache-Control: no-cache ou Pragma: no-cache ne sont pas servies depuis le cache. La directive <directive>CacheIgnoreCacheControl</directive> permet de modifier ce comportement. Avec <directive>CacheIgnoreCacheControl On</directive>, le serveur tentera de servir la ressource depuis le - cache, même si la requête contient un en-tête + cache, même si la requête contient un en-tête no-cache.</p> <highlight language="config"> @@ -651,8 +651,8 @@ le contenu au client depuis le cache</description> <note type="warning"><title>Avertissement :</title> Cette directive permet de servir des ressources depuis le cache, - même si le client a demandé à ce qu'il n'en soit pas ainsi. Le - contenu servi est ainsi susceptible d'être périmé. + même si le client a demandé à ce qu'il n'en soit pas ainsi. Le + contenu servi est ainsi susceptible d'être périmé. </note> </usage> <seealso><directive module="mod_cache">CacheStorePrivate</directive></seealso> @@ -661,7 +661,7 @@ le contenu au client depuis le cache</description> <directivesynopsis> <name>CacheIgnoreQueryString</name> -<description>Ignore la chaîne de paramètres lors de la mise en +<description>Ignore la chaîne de paramètres lors de la mise en cache</description> <syntax>CacheIgnoreQueryString On|Off</syntax> <default>CacheIgnoreQueryString Off</default> @@ -669,17 +669,17 @@ cache</description> </contextlist> <usage> - <p>Normalement, les requêtes comportant une chaîne de paramètres - sont mises en cache séparément si leurs chaînes de paramètres - diffèrent. - En accord avec la RFC 2616/13.9, cette mise en cache n'est effectuée - séparément que si une date d'expiration est spécifiée. La directive + <p>Normalement, les requêtes comportant une chaîne de paramètres + sont mises en cache séparément si leurs chaînes de paramètres + diffèrent. + En accord avec la RFC 2616/13.9, cette mise en cache n'est effectuée + séparément que si une date d'expiration est spécifiée. La directive <directive>CacheIgnoreQueryString</directive> permet la mise en - cache de requêtes même si aucune date d'expiration est spécifiée, et - de renvoyer une réponse depuis la cache même si les chaînes de - paramètres diffèrent. Du point de vue du cache, la requête est - traitée comme si elle ne possèdait pas de chaîne de paramètres - lorsque cette directive est activée.</p> + cache de requêtes même si aucune date d'expiration est spécifiée, et + de renvoyer une réponse depuis la cache même si les chaînes de + paramètres diffèrent. Du point de vue du cache, la requête est + traitée comme si elle ne possèdait pas de chaîne de paramètres + lorsque cette directive est activée.</p> <highlight language="config"> CacheIgnoreQueryString On @@ -690,8 +690,8 @@ cache</description> <directivesynopsis> <name>CacheLastModifiedFactor</name> -<description>Le facteur utilisé pour générer une date d'expiration en -fonction de la date de dernière modification.</description> +<description>Le facteur utilisé pour générer une date d'expiration en +fonction de la date de dernière modification.</description> <syntax>CacheLastModifiedFactor <var>flottant</var></syntax> <default>CacheLastModifiedFactor 0.1</default> <contextlist><context>server config</context><context>virtual host</context> @@ -699,24 +699,24 @@ fonction de la date de dernière modification.</description> </contextlist> <usage> - <p>Si un document ne possède pas de date d'expiration, elle peut - être calculée en fonction de la date de dernière modification, si + <p>Si un document ne possède pas de date d'expiration, elle peut + être calculée en fonction de la date de dernière modification, si elle existe. La directive - <directive>CacheLastModifiedFactor</directive> permet de spécifier - un <var>facteur</var> à utiliser pour la génération de cette date + <directive>CacheLastModifiedFactor</directive> permet de spécifier + un <var>facteur</var> à utiliser pour la génération de cette date d'expiration au sein de la formule suivante : - <code>délai-expiration = durée-depuis-date-dernière-modification * + <code>délai-expiration = durée-depuis-date-dernière-modification * <var>facteur</var> - date-expiration = date-courante + délai-expiration</code> + date-expiration = date-courante + délai-expiration</code> - Par exemple, si la dernière modification du document date de 10 - heures, et si <var>facteur</var> a pour valeur 0.1, le délai + Par exemple, si la dernière modification du document date de 10 + heures, et si <var>facteur</var> a pour valeur 0.1, le délai d'expiration sera de 10*0.1 = 1 heure. Si l'heure courante est - 3:00pm, la date d'expiration calculée sera 3:00pm + 1 heure = + 3:00pm, la date d'expiration calculée sera 3:00pm + 1 heure = 4:00pm. - Si le délai d'expiration est supérieur à celui spécifié par la + Si le délai d'expiration est supérieur à celui spécifié par la directive <directive>CacheMaxExpire</directive>, c'est ce dernier qui l'emporte.</p> @@ -728,18 +728,18 @@ fonction de la date de dernière modification.</description> <directivesynopsis> <name>CacheIgnoreHeaders</name> -<description>Ne pas stocker le(s) en-tête(s) spécifié(s) dans le cache. +<description>Ne pas stocker le(s) en-tête(s) spécifié(s) dans le cache. </description> -<syntax>CacheIgnoreHeaders <var>en-tête</var> [<var>en-tête</var>] ...</syntax> +<syntax>CacheIgnoreHeaders <var>en-tête</var> [<var>en-tête</var>] ...</syntax> <default>CacheIgnoreHeaders None</default> <contextlist><context>server config</context><context>virtual host</context> </contextlist> <usage> - <p>En accord avec la RFC 2616, les en-têtes HTTP hop-by-hop ne sont - pas stockés dans le cache. Les en-têtes HTTP suivant sont des - en-têtes hop-by-hop, et en tant que tels, ne sont en <em>aucun</em> - cas stockés dans le cache, quelle que soit la définition de la + <p>En accord avec la RFC 2616, les en-têtes HTTP hop-by-hop ne sont + pas stockés dans le cache. Les en-têtes HTTP suivant sont des + en-têtes hop-by-hop, et en tant que tels, ne sont en <em>aucun</em> + cas stockés dans le cache, quelle que soit la définition de la directive <directive>CacheIgnoreHeaders</directive> :</p> <ul> @@ -754,16 +754,16 @@ fonction de la date de dernière modification.</description> </ul> <p>La directive <directive>CacheIgnoreHeaders</directive> permet de - spécifier quels en-têtes HTTP ne doivent pas être stockés dans le - cache. Par exemple, il peut s'avérer pertinent dans certains cas de + spécifier quels en-têtes HTTP ne doivent pas être stockés dans le + cache. Par exemple, il peut s'avérer pertinent dans certains cas de ne pas stocker les cookies dans le cache.</p> <p>La directive <directive>CacheIgnoreHeaders</directive> accepte - une liste d'en-têtes HTTP séparés par des espaces, qui ne doivent - pas être stockés dans le cache. Si les en-têtes hop-by-hop sont les - seuls à ne pas devoir être stockés dans le cache (le comportement + une liste d'en-têtes HTTP séparés par des espaces, qui ne doivent + pas être stockés dans le cache. Si les en-têtes hop-by-hop sont les + seuls à ne pas devoir être stockés dans le cache (le comportement compatible RFC 2616), la directive - <directive>CacheIgnoreHeaders</directive> peut être définie à + <directive>CacheIgnoreHeaders</directive> peut être définie à <code>None</code>.</p> <example><title>Exemple 1</title> @@ -779,17 +779,17 @@ fonction de la date de dernière modification.</description> </example> <note type="warning"><title>Avertissement :</title> - Si des en-têtes nécessaires à la bonne gestion du cache, comme - <code>Expires</code>, ne sont pas stockés suite à la définition + Si des en-têtes nécessaires à la bonne gestion du cache, comme + <code>Expires</code>, ne sont pas stockés suite à la définition d'une directive <directive>CacheIgnoreHeaders</directive>, le - comportement de mod_cache sera imprévisible. + comportement de mod_cache sera imprévisible. </note> </usage> </directivesynopsis> <directivesynopsis> <name>CacheIgnoreURLSessionIdentifiers</name> -<description>Ignore les identifiants de session définis encodés dans +<description>Ignore les identifiants de session définis encodés dans l'URL lors de la mise en cache </description> <syntax>CacheIgnoreURLSessionIdentifiers <var>identifiant</var> @@ -806,17 +806,17 @@ l'URL lors de la mise en cache <li><code>/une-application/image.gif;jsessionid=123456789</code></li> <li><code>/une-application/image.gif?PHPSESSIONID=12345678</code></li> </ul> - <p>Ceci implique la mise en cache des ressources séparément pour - chaque session, ce qui n'est en général pas souhaité. La directive + <p>Ceci implique la mise en cache des ressources séparément pour + chaque session, ce qui n'est en général pas souhaité. La directive <directive>CacheIgnoreURLSessionIdentifiers</directive> permet de - définir une liste d'identifiants qui seront supprimés de la clé - utilisée pour identifier une entité dans le cache, de façon à ce que - les ressources ne soient pas stockées séparément pour chaque + définir une liste d'identifiants qui seront supprimés de la clé + utilisée pour identifier une entité dans le cache, de façon à ce que + les ressources ne soient pas stockées séparément pour chaque session. </p> <p><code>CacheIgnoreURLSessionIdentifiers None</code> vide la liste - des identifiants ignorés. Autrement, chaque identifiant spécifié est - ajouté à la liste.</p> + des identifiants ignorés. Autrement, chaque identifiant spécifié est + ajouté à la liste.</p> <example><title>Exemple 1</title> <highlight language="config"> @@ -835,8 +835,8 @@ l'URL lors de la mise en cache <directivesynopsis> <name>CacheStoreExpired</name> -<description>Tente de mettre en cache les réponses que le serveur -considère comme arrivées à expiration</description> +<description>Tente de mettre en cache les réponses que le serveur +considère comme arrivées à expiration</description> <syntax>CacheStoreExpired On|Off</syntax> <default>CacheStoreExpired Off</default> <contextlist><context>server config</context><context>virtual host</context> @@ -844,14 +844,14 @@ considère comme arrivées à expiration</description> </contextlist> <usage> - <p>Depuis la version 2.2.4, les réponses qui sont arrivées à - expiration ne sont pas stockées dans le cache. La directive + <p>Depuis la version 2.2.4, les réponses qui sont arrivées à + expiration ne sont pas stockées dans le cache. La directive <directive>CacheStoreExpired</directive> permet de modifier ce comportement. Avec <directive>CacheStoreExpired</directive> On, le - serveur tente de mettre en cache la ressource si elle est périmée. - Les requêtes suivantes vont déclencher une requête si-modifié-depuis - de la part du serveur d'origine, et la réponse sera renvoyée à - partir du cache si la ressource d'arrière-plan n'a pas été modifiée.</p> + serveur tente de mettre en cache la ressource si elle est périmée. + Les requêtes suivantes vont déclencher une requête si-modifié-depuis + de la part du serveur d'origine, et la réponse sera renvoyée à + partir du cache si la ressource d'arrière-plan n'a pas été modifiée.</p> <highlight language="config"> CacheStoreExpired On @@ -862,8 +862,8 @@ considère comme arrivées à expiration</description> <directivesynopsis> <name>CacheStorePrivate</name> -<description>Tente de mettre en cache des réponses que le serveur a -marquées comme privées</description> +<description>Tente de mettre en cache des réponses que le serveur a +marquées comme privées</description> <syntax>CacheStorePrivate On|Off</syntax> <default>CacheStorePrivate Off</default> <contextlist><context>server config</context><context>virtual host</context> @@ -871,13 +871,13 @@ marquées comme privées</description> </contextlist> <usage> - <p>Normalement, les réponse comportant un en-tête Cache-Control: - dont la valeur est private ne seront pas stockées dans le cache. La + <p>Normalement, les réponse comportant un en-tête Cache-Control: + dont la valeur est private ne seront pas stockées dans le cache. La directive <directive>CacheStorePrivate</directive> permet de modifier ce comportement. Si - <directive>CacheStorePrivate</directive> est définie à On, le - serveur tentera de mettre la ressource en cache, même si elle - contient un en-tête private.</p> + <directive>CacheStorePrivate</directive> est définie à On, le + serveur tentera de mettre la ressource en cache, même si elle + contient un en-tête private.</p> <highlight language="config"> @@ -886,10 +886,10 @@ marquées comme privées</description> <note type="warning"><title>Avertissement :</title> - Cette directive autorise la mise en cache même si le serveur - indique que la ressource ne doit pas être mise en cache. Elle - n'est de ce fait appropriée que dans le cas d'un cache - 'privé'. + Cette directive autorise la mise en cache même si le serveur + indique que la ressource ne doit pas être mise en cache. Elle + n'est de ce fait appropriée que dans le cas d'un cache + 'privé'. </note> </usage> <seealso><directive module="mod_cache">CacheIgnoreCacheControl</directive></seealso> @@ -898,8 +898,8 @@ marquées comme privées</description> <directivesynopsis> <name>CacheStoreNoStore</name> -<description>Tente de mettre en cache les requêtes ou réponses dont -l'entête Cache-Control: a pour valeur no-store.</description> +<description>Tente de mettre en cache les requêtes ou réponses dont +l'entête Cache-Control: a pour valeur no-store.</description> <syntax>CacheStoreNoStore On|Off</syntax> <default>CacheStoreNoStore Off</default> <contextlist><context>server config</context><context>virtual host</context> @@ -907,13 +907,13 @@ l'entête Cache-Control: a pour valeur no-store.</description> </contextlist> <usage> - <p>Normalement, les requêtes ou réponses dont l'en-tête - Cache-Control: a pour valeur no-store ne sont pas stockées dans le + <p>Normalement, les requêtes ou réponses dont l'en-tête + Cache-Control: a pour valeur no-store ne sont pas stockées dans le cache. La directive <directive>CacheStoreNoStore</directive> permet de modifier ce comportement. Si - <directive>CacheStoreNoStore</directive> est définie à On, le - serveur tente de mettre la ressource en cache même si elle contient - un en-tête no-store.</p> + <directive>CacheStoreNoStore</directive> est définie à On, le + serveur tente de mettre la ressource en cache même si elle contient + un en-tête no-store.</p> <highlight language="config"> @@ -922,13 +922,13 @@ l'entête Cache-Control: a pour valeur no-store.</description> <note type="warning"><title>Avertissement :</title> - Selon la RFC 2616, la valeur d'en-tête no-store est censée - "prévenir la suppression ou la rétention par inadvertance + Selon la RFC 2616, la valeur d'en-tête no-store est censée + "prévenir la suppression ou la rétention par inadvertance d'informations sensibles (par exemple, sur des bandes de sauvegarde)". Autrement dit, l'activation de la directive <directive>CacheStoreNoCache</directive> pourrait provoquer le stockage d'informations sensibles dans le cache. Vous avez donc - été prévenus. + été prévenus. </note> </usage> <seealso><directive module="mod_cache">CacheIgnoreCacheControl</directive></seealso> @@ -937,7 +937,7 @@ l'entête Cache-Control: a pour valeur no-store.</description> <directivesynopsis> <name>CacheLock</name> -<description>Active la protection contre les tempêtes de requêtes.</description> +<description>Active la protection contre les tempêtes de requêtes.</description> <syntax>CacheLock <var>on|off</var></syntax> <default>CacheLock off</default> <contextlist><context>server config</context><context>virtual host</context> @@ -945,11 +945,11 @@ l'entête Cache-Control: a pour valeur no-store.</description> <usage> <p>La directive <directive>CacheLock</directive> active la protection - contre les tempêtes de requêtes pour l'espace d'adressage donné.</p> + contre les tempêtes de requêtes pour l'espace d'adressage donné.</p> <p>La configuration minimale pour activer le verrouillage contre les - tempêtes de requêtes dans le répertoire par - défaut des fichiers run-time est + tempêtes de requêtes dans le répertoire par + défaut des fichiers run-time est la suivante :</p> <highlight language="config"> @@ -958,7 +958,7 @@ CacheLock on </highlight> <p>Les verrous sont des fichiers vides qui n'existent que pour les - URLs présentes dont le contenu est périmé ; ils consomment dont bien + URLs présentes dont le contenu est périmé ; ils consomment dont bien moins de ressources que le cache disque traditionnel.</p> </usage> @@ -966,17 +966,17 @@ CacheLock on <directivesynopsis> <name>CacheLockPath</name> -<description>Définit le répertoire des verrous.</description> -<syntax>CacheLockPath <var>répertoire</var></syntax> +<description>Définit le répertoire des verrous.</description> +<syntax>CacheLockPath <var>répertoire</var></syntax> <default>CacheLockPath mod_cache-lock</default> <contextlist><context>server config</context><context>virtual host</context> </contextlist> <usage> <p>La directive <directive>CacheLockPath</directive> permet de - spécifier le répertoire dans lequel les verrous sont - créés. Si <var>répertoire</var> n'est pas un - chemin absolu, il sera relatif au répertoire défini par la directive + spécifier le répertoire dans lequel les verrous sont + créés. Si <var>répertoire</var> n'est pas un + chemin absolu, il sera relatif au répertoire défini par la directive <directive module="core">DefaultRuntimeDir</directive>.</p> </usage> @@ -984,7 +984,7 @@ CacheLock on <directivesynopsis> <name>CacheLockMaxAge</name> -<description>Définit la durée de vie maximale d'un verrou de cache.</description> +<description>Définit la durée de vie maximale d'un verrou de cache.</description> <syntax>CacheLockMaxAge <var>entier</var></syntax> <default>CacheLockMaxAge 5</default> <contextlist><context>server config</context><context>virtual host</context> @@ -992,53 +992,53 @@ CacheLock on <usage> <p>La directive <directive>CacheLockMaxAge</directive> permet de - spécifier la durée de vie maximale d'un verrou de cache.</p> + spécifier la durée de vie maximale d'un verrou de cache.</p> - <p>Un verrou plus ancien que cette valeur exprimée en secondes sera - ignoré, et la prochaine requête entrante sera alors en mesure de - recréer le verrou. Ce mécanisme permet d'éviter les mises à jour trop - longues initiées par des clients lents.</p> + <p>Un verrou plus ancien que cette valeur exprimée en secondes sera + ignoré, et la prochaine requête entrante sera alors en mesure de + recréer le verrou. Ce mécanisme permet d'éviter les mises à jour trop + longues initiées par des clients lents.</p> </usage> </directivesynopsis> <directivesynopsis> <name>CacheQuickHandler</name> - <description>Exécute le cache à partir d'un gestionnaire rapide.</description> + <description>Exécute le cache à partir d'un gestionnaire rapide.</description> <syntax>CacheQuickHandler <var>on|off</var></syntax> <default>CacheQuickHandler on</default> <contextlist><context>server config</context><context>virtual host</context> </contextlist> - <compatibility>Disponible à partir de la version 2.3.3 du serveur HTTP + <compatibility>Disponible à partir de la version 2.3.3 du serveur HTTP Apache</compatibility> <usage> <p>La directive <directive - module="mod_cache">CacheQuickHandler</directive> permet de contrôler - la phase au cours de laquelle la mise en cache est effectuée.</p> + module="mod_cache">CacheQuickHandler</directive> permet de contrôler + la phase au cours de laquelle la mise en cache est effectuée.</p> - <p>Avec la configuration par défaut, le cache agit au cours de la - phase du gestionnaire rapide. Cette phase court-circuite la majorité - des traitements du serveur, et constitue le mode d'opération le plus + <p>Avec la configuration par défaut, le cache agit au cours de la + phase du gestionnaire rapide. Cette phase court-circuite la majorité + des traitements du serveur, et constitue le mode d'opération le plus performant pour un serveur typique. Le cache - <strong>s'incruste</strong> devant le serveur, et la majorité des - traitements du serveur est court-circuitée.</p> + <strong>s'incruste</strong> devant le serveur, et la majorité des + traitements du serveur est court-circuitée.</p> - <p>Lorsque cette directive est définie à off, le cache agit comme un - gestionnaire normal, et est concerné par toutes les phases de - traitement d'une requête. Bien que ce mode soit moins performant que - le mode par défaut, il permet d'utiliser le cache dans les cas où un - traitement complet de la requête est nécessaire, comme par exemple - lorsque le contenu est soumis à autorisation.</p> + <p>Lorsque cette directive est définie à off, le cache agit comme un + gestionnaire normal, et est concerné par toutes les phases de + traitement d'une requête. Bien que ce mode soit moins performant que + le mode par défaut, il permet d'utiliser le cache dans les cas où un + traitement complet de la requête est nécessaire, comme par exemple + lorsque le contenu est soumis à autorisation.</p> <highlight language="config"> -# Exécute le cache comme un gestionnaire normal +# Exécute le cache comme un gestionnaire normal CacheQuickHandler off </highlight> - <p>Lorsque le gestionnaire rapide est désactivé, l'administrateur a - aussi la possibilité de choisir avec précision le point de la chaîne - de filtrage où la mise en cache sera effectuée, en utilisant le + <p>Lorsque le gestionnaire rapide est désactivé, l'administrateur a + aussi la possibilité de choisir avec précision le point de la chaîne + de filtrage où la mise en cache sera effectuée, en utilisant le filtre <strong>CACHE</strong>.</p> <highlight language="config"> @@ -1048,7 +1048,7 @@ CacheQuickHandler off AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html </highlight> - <p>Si le filtre CACHE est spécifié plusieurs fois, c'est la dernière + <p>Si le filtre CACHE est spécifié plusieurs fois, c'est la dernière instance qui sera prise en compte.</p> </usage> @@ -1056,7 +1056,7 @@ AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html <directivesynopsis> <name>CacheHeader</name> -<description>Ajoute un en-tête X-Cache à la réponse.</description> +<description>Ajoute un en-tête X-Cache à la réponse.</description> <syntax>CacheHeader <var>on|off</var></syntax> <default>CacheHeader off</default> <contextlist><context>server config</context> @@ -1068,28 +1068,28 @@ AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html <usage> <p>Lorsque la directive <directive - module="mod_cache">CacheHeader</directive> est définie à on, un - en-tête <strong>X-Cache</strong> est ajouté à la réponse et contient - l'état du cache pour cette dernière. Si le gestionnaire normal est - utilisé, cette directive peut se situer dans une section + module="mod_cache">CacheHeader</directive> est définie à on, un + en-tête <strong>X-Cache</strong> est ajouté à la réponse et contient + l'état du cache pour cette dernière. Si le gestionnaire normal est + utilisé, cette directive peut se situer dans une section <directive type="section" module="core">Directory</directive> ou <directive type="section" module="core">Location</directive>. Si c'est le - gestionnaire rapide qui est utilisé, elle doit se situer dans un + gestionnaire rapide qui est utilisé, elle doit se situer dans un contexte de serveur principal ou de serveur virtuel, sinon elle sera - ignorée.</p> + ignorée.</p> <dl> - <dt><strong>HIT</strong></dt><dd>Le contenu était à jour et a été + <dt><strong>HIT</strong></dt><dd>Le contenu était à jour et a été servi depuis le cache.</dd> - <dt><strong>REVALIDATE</strong></dt><dd>Le contenu était périmé, a - été mis à jour, puis a été servi depuis le cache.</dd> - <dt><strong>MISS</strong></dt><dd>Le contenu n'a pas été servi - depuis le cache, mais directement depuis le serveur demandé.</dd> + <dt><strong>REVALIDATE</strong></dt><dd>Le contenu était périmé, a + été mis à jour, puis a été servi depuis le cache.</dd> + <dt><strong>MISS</strong></dt><dd>Le contenu n'a pas été servi + depuis le cache, mais directement depuis le serveur demandé.</dd> </dl> <highlight language="config"> -# Active l'en-tête X-Cache +# Active l'en-tête X-Cache CacheHeader on </highlight> @@ -1103,7 +1103,7 @@ CacheHeader on <directivesynopsis> <name>CacheDetailHeader</name> -<description>Ajoute un en-tête X-Cache-Detail à la réponse.</description> +<description>Ajoute un en-tête X-Cache-Detail à la réponse.</description> <syntax>CacheDetailHeader <var>on|off</var></syntax> <default>CacheDetailHeader off</default> <contextlist><context>server config</context> @@ -1115,27 +1115,27 @@ CacheHeader on <usage> <p>Lorsque la directive <directive - module="mod_cache">CacheDetailHeader</directive> est définie à on, un - en-tête <strong>X-Cache-Detail</strong> est ajouté à la réponse et - contient les raisons précises d'une décision d'utilisation du cache - vis à vis de cette dernière.</p> - - <p>Ceci peut s'avérer utile au cours du développement de services - RESTful mis en cache pour obtenir des informations supplémentaires à - propos des décisions vis à vis du cache écrites dans les en-têtes de - la réponse. Il est ainsi possible de vérifier si - <code>Cache-Control</code> et d'autres en-têtes ont été correctement - utilisés par le service et le client.</p> - - <p>Si le gestionnaire normal est utilisé, cette directive peut se + module="mod_cache">CacheDetailHeader</directive> est définie à on, un + en-tête <strong>X-Cache-Detail</strong> est ajouté à la réponse et + contient les raisons précises d'une décision d'utilisation du cache + vis à vis de cette dernière.</p> + + <p>Ceci peut s'avérer utile au cours du développement de services + RESTful mis en cache pour obtenir des informations supplémentaires à + propos des décisions vis à vis du cache écrites dans les en-têtes de + la réponse. Il est ainsi possible de vérifier si + <code>Cache-Control</code> et d'autres en-têtes ont été correctement + utilisés par le service et le client.</p> + + <p>Si le gestionnaire normal est utilisé, cette directive peut se situer dans une section <directive type="section" module="core">Directory</directive> ou <directive type="section" module="core">Location</directive>. Si c'est le gestionnaire - rapide qui est utilisé, elle doit se situer dans un contexte de - serveur principal ou de serveur virtuel, sinon elle sera ignorée.</p> + rapide qui est utilisé, elle doit se situer dans un contexte de + serveur principal ou de serveur virtuel, sinon elle sera ignorée.</p> <highlight language="config"> -# Active l'en-tête X-Cache-Detail +# Active l'en-tête X-Cache-Detail CacheDetailHeader on </highlight> @@ -1148,7 +1148,7 @@ CacheDetailHeader on <directivesynopsis> <name>CacheKeyBaseURL</name> -<description>Remplace l'URL de base des clés du cache mandatées en +<description>Remplace l'URL de base des clés du cache mandatées en inverse</description> <syntax>CacheKeyBaseURL <var>URL</var></syntax> <default>CacheKeyBaseURL http://example.com</default> @@ -1159,22 +1159,22 @@ inverse</description> <usage> <p>Lorsque la directive <directive - module="mod_cache">CacheKeyBaseURL</directive> est utilisée, l'URL - spécifiée sera utilisée comme URL de base pour calculer l'URL des clés - du cache dans la configuration du mandataire inverse. Par défaut, - c'est le protocole/nom d'hôte/port du serveur virtuel courant qui sera - utilisé pour construire la clé de cache. Dans le cas d'un cluster de - machines, si toutes les entrées du cache doivent posséder la même clé, - cette directive permet de spécifier une nouvelle URL de base.</p> + module="mod_cache">CacheKeyBaseURL</directive> est utilisée, l'URL + spécifiée sera utilisée comme URL de base pour calculer l'URL des clés + du cache dans la configuration du mandataire inverse. Par défaut, + c'est le protocole/nom d'hôte/port du serveur virtuel courant qui sera + utilisé pour construire la clé de cache. Dans le cas d'un cluster de + machines, si toutes les entrées du cache doivent posséder la même clé, + cette directive permet de spécifier une nouvelle URL de base.</p> <highlight language="config"> -# Remplace l'URL de base de la clé de cache. +# Remplace l'URL de base de la clé de cache. CacheKeyBaseURL http://www.example.com/ </highlight> - <note type="warning">Prenez garde en définissant cette directive. Si - deux serveurs virtuels distincts possèdent accidentellement la même - URL de base, les entrées en provenance d'un serveur virtuel seront + <note type="warning">Prenez garde en définissant cette directive. Si + deux serveurs virtuels distincts possèdent accidentellement la même + URL de base, les entrées en provenance d'un serveur virtuel seront servies par l'autre.</note> </usage> @@ -1182,7 +1182,7 @@ CacheKeyBaseURL http://www.example.com/ <directivesynopsis> <name>CacheStaleOnError</name> -<description>Sert du contenu non à jour à la place de réponses 5xx.</description> +<description>Sert du contenu non à jour à la place de réponses 5xx.</description> <syntax>CacheStaleOnError <var>on|off</var></syntax> <default>CacheStaleOnError on</default> <contextlist><context>server config</context> @@ -1194,17 +1194,17 @@ CacheKeyBaseURL http://www.example.com/ <usage> <p>Lorsque la directive <directive - module="mod_cache">CacheStaleOnError</directive> est définie à on, et - si des données non mises à jour sont disponibles dans le cache, ce - dernier renverra ces données, plutôt qu'une éventuelle réponse 5xx en - provenance du serveur d'arrière-plan. Alors que l'en-tête - Cache-Control envoyé par les clients sera respecté, et que les clients - recevront donc dans ce cas la réponse 5xx brute à leur requête, cette - réponse 5xx renvoyée au client n'invalidera pas le contenu dans le + module="mod_cache">CacheStaleOnError</directive> est définie à on, et + si des données non mises à jour sont disponibles dans le cache, ce + dernier renverra ces données, plutôt qu'une éventuelle réponse 5xx en + provenance du serveur d'arrière-plan. Alors que l'en-tête + Cache-Control envoyé par les clients sera respecté, et que les clients + recevront donc dans ce cas la réponse 5xx brute à leur requête, cette + réponse 5xx renvoyée au client n'invalidera pas le contenu dans le cache. </p> <highlight language="config"> -# Sert des données non mises à jour en cas d'erreur. +# Sert des données non mises à jour en cas d'erreur. CacheStaleOnError on </highlight> diff --git a/docs/manual/mod/mod_ldap.xml.fr b/docs/manual/mod/mod_ldap.xml.fr index 361c4f0c3a..c42595b8ef 100644 --- a/docs/manual/mod/mod_ldap.xml.fr +++ b/docs/manual/mod/mod_ldap.xml.fr @@ -1,7 +1,7 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1673945:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -27,46 +27,46 @@ <name>mod_ldap</name> <description>Conservation des connexions LDAP et services de mise en -cache du résultat à destination des autres modules LDAP</description> +cache du résultat à destination des autres modules LDAP</description> <status>Extension</status> <sourcefile>util_ldap.c</sourcefile> <identifier>ldap_module</identifier> <summary> - <p>Ce module a été conçu dans le but d'améliorer les performances - des sites web s'appuyant sur des connexions en arrière-plan vers des + <p>Ce module a été conçu dans le but d'améliorer les performances + des sites web s'appuyant sur des connexions en arrière-plan vers des serveurs LDAP. Il ajoute aux fonctions fournies par les - bibliothèques standards LDAP la conservation des connexions LDAP - ainsi qu'un cache LDAP partagé en mémoire.</p> + bibliothèques standards LDAP la conservation des connexions LDAP + ainsi qu'un cache LDAP partagé en mémoire.</p> - <p>Pour activer ce module, le support LDAP doit être compilé dans + <p>Pour activer ce module, le support LDAP doit être compilé dans apr-util. Pour ce faire, on ajoute l'option <code>--with-ldap</code> au script <program>configure</program> lorsqu'on construit Apache.</p> - <p>Le support SSL/TLS est conditionné par le kit de développement - LDAP qui a été lié à <glossary>APR</glossary>. Au moment où ces - lignes sont écrites, APR-util supporte <a + <p>Le support SSL/TLS est conditionné par le kit de développement + LDAP qui a été lié à <glossary>APR</glossary>. Au moment où ces + lignes sont écrites, APR-util supporte <a href="http://www.openldap.org/">OpenLDAP SDK</a> (version 2.x ou - supérieure), <a + supérieure), <a href="http://developer.novell.com/ndk/cldap.htm">Novell LDAP SDK</a>, <a href="https://wiki.mozilla.org/LDAP_C_SDK"> - Mozilla LDAP SDK</a>, le SDK LDAP Solaris natif (basé sur Mozilla) + Mozilla LDAP SDK</a>, le SDK LDAP Solaris natif (basé sur Mozilla) ou le SDK LDAP Microsoft natif. Voir le site web <a - href="http://apr.apache.org">APR</a> pour plus de détails.</p> + href="http://apr.apache.org">APR</a> pour plus de détails.</p> </summary> <section id="exampleconfig"><title>Exemple de configuration</title> <p>Ce qui suit est un exemple de configuration qui utilise - <module>mod_ldap</module> pour améliorer les performances de + <module>mod_ldap</module> pour améliorer les performances de l'authentification HTTP de base fournie par <module>mod_authnz_ldap</module>.</p> <highlight language="config"> -# Active la conservation des connexions LDAP et le cache partagé en -# mémoire. Active le gestionnaire de statut du cache LDAP. -# Nécessite le chargement de mod_ldap et de mod_authnz_ldap. +# Active la conservation des connexions LDAP et le cache partagé en +# mémoire. Active le gestionnaire de statut du cache LDAP. +# Nécessite le chargement de mod_ldap et de mod_authnz_ldap. # Remplacez "votre-domaine.example.com" par le nom de votre # domaine. @@ -93,108 +93,108 @@ LDAPOpCacheTTL 600 <section id="pool"><title>Conservation des connexions LDAP</title> - <p>Les connexions LDAP sont conservées de requête en requête. Ceci - permet de rester connecté et identifié au serveur LDAP, ce dernier - étant ainsi prêt pour la prochaine requête, sans avoir à se - déconnecter, reconnecter et réidentifier. Le gain en performances - est similaire à celui des connexions persistantes (keepalives) + <p>Les connexions LDAP sont conservées de requête en requête. Ceci + permet de rester connecté et identifié au serveur LDAP, ce dernier + étant ainsi prêt pour la prochaine requête, sans avoir à se + déconnecter, reconnecter et réidentifier. Le gain en performances + est similaire à celui des connexions persistantes (keepalives) HTTP.</p> - <p>Sur un serveur très sollicité, il est possible que de nombreuses - requêtes tentent d'accéder simultanément à la même connexion au - serveur LDAP. Lorsqu'une connexion LDAP est utilisée, Apache en crée - une deuxième en parallèle à la première, ce qui permet d'éviter que - le système de conservation des connexions ne devienne un goulot - d'étranglement.</p> + <p>Sur un serveur très sollicité, il est possible que de nombreuses + requêtes tentent d'accéder simultanément à la même connexion au + serveur LDAP. Lorsqu'une connexion LDAP est utilisée, Apache en crée + une deuxième en parallèle à la première, ce qui permet d'éviter que + le système de conservation des connexions ne devienne un goulot + d'étranglement.</p> - <p>Il n'est pas nécessaire d'activer explicitement la conservation + <p>Il n'est pas nécessaire d'activer explicitement la conservation des connexions dans la configuration d'Apache. Tout module utilisant - le module ldap pour accéder aux services LDAP partagera le jeu de + le module ldap pour accéder aux services LDAP partagera le jeu de connexions.</p> - <p>Les connexions LDAP peuvent garder la trace des données - d'identification du client ldap utilisées pour l'identification - auprès du serveur LDAP. Ces données peuvent être fournies aux + <p>Les connexions LDAP peuvent garder la trace des données + d'identification du client ldap utilisées pour l'identification + auprès du serveur LDAP. Ces données peuvent être fournies aux serveurs LDAP qui ne permettent pas les connexions anonymes au cours lors des tentatives de sauts vers des serveurs alternatifs. Pour - contrôler cette fonctionnalité, voir les directives <directive + contrôler cette fonctionnalité, voir les directives <directive module="mod_ldap">LDAPReferrals</directive> et <directive module="mod_ldap">LDAPReferralHopLimit</directive>. Cette - fonctionnalité est activée par défaut.</p> + fonctionnalité est activée par défaut.</p> </section> <section id="cache"><title>Cache LDAP</title> - <p>Pour améliorer les performances, <module>mod_ldap</module> met en - oeuvre une stratégie de mise en cache agressive visant à minimiser - le nombre de fois que le serveur LDAP doit être contacté. La mise en - cache peut facilement doubler et même tripler le débit d'Apache - lorsqu'il sert des pages protégées par mod_authnz_ldap. De plus, le - serveur LDAP verra lui-même sa charge sensiblement diminuée.</p> + <p>Pour améliorer les performances, <module>mod_ldap</module> met en + oeuvre une stratégie de mise en cache agressive visant à minimiser + le nombre de fois que le serveur LDAP doit être contacté. La mise en + cache peut facilement doubler et même tripler le débit d'Apache + lorsqu'il sert des pages protégées par mod_authnz_ldap. De plus, le + serveur LDAP verra lui-même sa charge sensiblement diminuée.</p> <p><module>mod_ldap</module> supporte deux types de mise en cache LDAP : un <em>cache recherche/identification</em> durant la phase - de recherche/identification et deux <em>caches d'opérations</em> - durant la phase de comparaison. Chaque URL LDAP utilisée par le + de recherche/identification et deux <em>caches d'opérations</em> + durant la phase de comparaison. Chaque URL LDAP utilisée par le serveur a son propre jeu d'instances dans ces trois caches.</p> <section id="search-bind"><title>Le cache recherche/identification</title> <p>Les processus de recherche et d'identification sont les - opérations LDAP les plus consommatrices en temps, en particulier + opérations LDAP les plus consommatrices en temps, en particulier si l'annuaire est de grande taille. Le cache de recherche/identification met en cache toutes les recherches qui - ont abouti à une identification positive. Les résultats négatifs - (c'est à dire les recherches sans succès, ou les recherches qui - n'ont pas abouti à une identification positive) ne sont pas mis en - cache. La raison de cette décision réside dans le fait que les - connexions avec des données d'identification invalides ne - représentent qu'un faible pourcentage du nombre total de + ont abouti à une identification positive. Les résultats négatifs + (c'est à dire les recherches sans succès, ou les recherches qui + n'ont pas abouti à une identification positive) ne sont pas mis en + cache. La raison de cette décision réside dans le fait que les + connexions avec des données d'identification invalides ne + représentent qu'un faible pourcentage du nombre total de connexions, et ainsi, le fait de ne pas mettre en cache les - données d'identification invalides réduira d'autant la taille du + données d'identification invalides réduira d'autant la taille du cache.</p> <p><module>mod_ldap</module> met en cache le nom d'utilisateur, le - DN extrait, le mot de passe utilisé pour l'identification, ainsi + DN extrait, le mot de passe utilisé pour l'identification, ainsi que l'heure de l'identification. Chaque fois qu'une nouvelle - connexion est initialisée avec le même nom d'utilisateur, + connexion est initialisée avec le même nom d'utilisateur, <module>mod_ldap</module> compare le mot de passe de la nouvelle - connexion avec le mot de passe enregistré dans le cache. Si les - mots de passe correspondent, et si l'entrée du cache n'est pas + connexion avec le mot de passe enregistré dans le cache. Si les + mots de passe correspondent, et si l'entrée du cache n'est pas trop ancienne, <module>mod_ldap</module> court-circuite la phase de recherche/identification.</p> - <p>Le cache de recherche/identification est contrôlé par les + <p>Le cache de recherche/identification est contrôlé par les directives <directive module="mod_ldap">LDAPCacheEntries</directive> et <directive module="mod_ldap">LDAPCacheTTL</directive>.</p> </section> - <section id="opcaches"><title>Les caches d'opérations</title> - <p>Au cours des opérations de comparaison d'attributs et de noms + <section id="opcaches"><title>Les caches d'opérations</title> + <p>Au cours des opérations de comparaison d'attributs et de noms distinctifs (DN), <module>mod_ldap</module> utilise deux caches - d'opérations pour mettre en cache les opérations de comparaison. - Le premier cache de comparaison sert à mettre en cache les - résultats de comparaisons effectuées pour vérifier l'appartenance - à un groupe LDAP. Le second cache de comparaison sert à mettre en - cache les résultats de comparaisons entre DNs.</p> + d'opérations pour mettre en cache les opérations de comparaison. + Le premier cache de comparaison sert à mettre en cache les + résultats de comparaisons effectuées pour vérifier l'appartenance + à un groupe LDAP. Le second cache de comparaison sert à mettre en + cache les résultats de comparaisons entre DNs.</p> - <p>Notez que, lorsque l'appartenance à un groupe est vérifiée, + <p>Notez que, lorsque l'appartenance à un groupe est vérifiée, toute comparaison de sous-groupes est mise en cache afin - d'accélérer les comparaisons de sous-groupes ultérieures.</p> + d'accélérer les comparaisons de sous-groupes ultérieures.</p> - <p>Le comportement de ces deux caches est contrôlé par les + <p>Le comportement de ces deux caches est contrôlé par les directives <directive module="mod_ldap">LDAPOpCacheEntries</directive> et <directive module="mod_ldap">LDAPOpCacheTTL</directive>.</p> </section> <section id="monitoring"><title>Superviser le cache</title> - <p><module>mod_ldap</module> possède un gestionnaire de contenu + <p><module>mod_ldap</module> possède un gestionnaire de contenu qui permet aux administrateurs de superviser les performances du cache. Le nom du gestionnaire de contenu est <code>ldap-status</code>, et on peut utiliser les directives - suivantes pour accéder aux informations du cache de + suivantes pour accéder aux informations du cache de <module>mod_ldap</module> :</p> <highlight language="config"> @@ -203,32 +203,32 @@ LDAPOpCacheTTL 600 </Location> </highlight> - <p>En se connectant à l'URL + <p>En se connectant à l'URL <code>http://nom-serveur/infos-cache</code>, l'administrateur peut obtenir un rapport sur le statut de chaque cache qu'utilise <module>mod_ldap</module>. Notez que si Apache ne supporte pas la - mémoire partagée, chaque instance de <program>httpd</program> - possèdera son propre cache, et chaque fois que l'URL sera - rechargée, un résultat différent pourra être affiché, en fonction + mémoire partagée, chaque instance de <program>httpd</program> + possèdera son propre cache, et chaque fois que l'URL sera + rechargée, un résultat différent pourra être affiché, en fonction de l'instance de <program>httpd</program> qui traitera la - requête.</p> + requête.</p> </section> </section> <section id="usingssltls"><title>Utiliser SSL/TLS</title> - <p>La possibilité de créer des connexions SSL et TLS avec un serveur - LDAP est définie par les directives <directive module="mod_ldap"> + <p>La possibilité de créer des connexions SSL et TLS avec un serveur + LDAP est définie par les directives <directive module="mod_ldap"> LDAPTrustedGlobalCert</directive>, <directive module="mod_ldap"> LDAPTrustedClientCert</directive> et <directive module="mod_ldap"> - LDAPTrustedMode</directive>. Ces directives permettent de spécifier - l'autorité de certification (CA), les certificats clients éventuels, - ainsi que le type de chiffrement à utiliser pour la connexion (none, + LDAPTrustedMode</directive>. Ces directives permettent de spécifier + l'autorité de certification (CA), les certificats clients éventuels, + ainsi que le type de chiffrement à utiliser pour la connexion (none, SSL ou TLS/STARTTLS).</p> <highlight language="config"> # Etablissement d'une connexion SSL LDAP sur le port 636. -# Nécessite le chargement de mod_ldap et mod_authnz_ldap. +# Nécessite le chargement de mod_ldap et mod_authnz_ldap. # Remplacez "votre-domaine.example.com" par le nom de votre # domaine. @@ -250,7 +250,7 @@ LDAPTrustedGlobalCert CA_DER /certs/certfile.der <highlight language="config"> # Etablissement d'une connexion TLS LDAP sur le port 389. -# Nécessite le chargement de mod_ldap et mod_authnz_ldap. +# Nécessite le chargement de mod_ldap et mod_authnz_ldap. # Remplacez "votre-domaine.example.com" par le nom de votre # domaine. @@ -274,43 +274,43 @@ LDAPTrustedGlobalCert CA_DER /certs/certfile.der <section id="settingcerts"><title>Certificats SSL/TLS</title> - <p>Les différents SDKs LDAP disposent de nombreuses méthodes pour - définir et gérer les certificats des clients et des autorités de + <p>Les différents SDKs LDAP disposent de nombreuses méthodes pour + définir et gérer les certificats des clients et des autorités de certification (CA).</p> <p>Si vous avez l'intention d'utiliser SSL ou TLS, lisez cette - section ATTENTIVEMENT de façon à bien comprendre les différences de - configurations entre les différents SDKs LDAP supportés.</p> + section ATTENTIVEMENT de façon à bien comprendre les différences de + configurations entre les différents SDKs LDAP supportés.</p> <section id="settingcerts-netscape"><title>SDK Netscape/Mozilla/iPlanet</title> - <p>Les certificat de CA sont enregistrés dans un fichier nommé + <p>Les certificat de CA sont enregistrés dans un fichier nommé cert7.db. Le SDK ne dialoguera avec aucun serveur LDAP dont le - certificat n'a pas été signé par une CA spécifiée dans ce + certificat n'a pas été signé par une CA spécifiée dans ce fichier. Si des certificats clients sont requis, un fichier - key3.db ainsi qu'un mot de passe optionnels peuvent être - spécifiés. On peut aussi spécifier le fichier secmod si - nécessaire. Ces fichiers sont du même format que celui utilisé + key3.db ainsi qu'un mot de passe optionnels peuvent être + spécifiés. On peut aussi spécifier le fichier secmod si + nécessaire. Ces fichiers sont du même format que celui utilisé par les navigateurs web Netscape Communicator ou Mozilla. Le - moyen le plus simple pour obtenir ces fichiers consiste à les + moyen le plus simple pour obtenir ces fichiers consiste à les extraire de l'installation de votre navigateur.</p> - <p>Les certificats clients sont spécifiés pour chaque connexion + <p>Les certificats clients sont spécifiés pour chaque connexion en utilisant la directive LDAPTrustedClientCert et en se - référant au certificat "nickname". On peut éventuellement - spécifier un mot de passe pour déverrouiller la clé privée du + référant au certificat "nickname". On peut éventuellement + spécifier un mot de passe pour déverrouiller la clé privée du certificat.</p> <p>Le SDK supporte seulement SSL. Toute tentative d'utilisation de STARTTLS engendrera une erreur lors des tentatives de - contacter le serveur LDAP pendant l'exécution.</p> + contacter le serveur LDAP pendant l'exécution.</p> <highlight language="config"> -# Spécifie un fichier de certificats de CA Netscape +# Spécifie un fichier de certificats de CA Netscape LDAPTrustedGlobalCert CA_CERT7_DB /certs/cert7.db -# Spécifie un fichier key3db optionnel pour le support des +# Spécifie un fichier key3db optionnel pour le support des # certificats clients LDAPTrustedGlobalCert CERT_KEY3_DB /certs/key3.db -# Spécifie le fichier secmod si nécessaire +# Spécifie le fichier secmod si nécessaire LDAPTrustedGlobalCert CA_SECMOD /certs/secmod <Location "/ldap-status"> SetHandler ldap-status @@ -331,29 +331,29 @@ LDAPTrustedGlobalCert CA_SECMOD /certs/secmod <section id="settingcerts-novell"><title>SDK Novell</title> - <p>Un ou plusieurs certificats de CA doivent être spécifiés pour + <p>Un ou plusieurs certificats de CA doivent être spécifiés pour que le SDK Novell fonctionne correctement. Ces certificats - peuvent être spécifiés sous forme de fichiers au format binaire - DER ou codés en Base64 (PEM).</p> + peuvent être spécifiés sous forme de fichiers au format binaire + DER ou codés en Base64 (PEM).</p> - <p>Note: Les certificats clients sont spécifiés globalement - plutôt qu'à chaque connexion, et doivent être spécifiés à l'aide - de la directive LDAPTrustedGlobalCert comme ci-dessous. Définir + <p>Note: Les certificats clients sont spécifiés globalement + plutôt qu'à chaque connexion, et doivent être spécifiés à l'aide + de la directive LDAPTrustedGlobalCert comme ci-dessous. Définir des certificats clients via la directive LDAPTrustedClientCert - engendrera une erreur qui sera journalisée, au moment de la + engendrera une erreur qui sera journalisée, au moment de la tentative de connexion avec le serveur LDAP.</p> - <p>Le SDK supporte SSL et STARTTLS, le choix étant défini par le - paramètre de la directive LDAPTrustedMode. Si une URL de type - ldaps:// est spécifiée, le mode SSL est forcé, et l'emporte sur + <p>Le SDK supporte SSL et STARTTLS, le choix étant défini par le + paramètre de la directive LDAPTrustedMode. Si une URL de type + ldaps:// est spécifiée, le mode SSL est forcé, et l'emporte sur cette directive.</p> <highlight language="config"> -# Spécifie deux fichiers contenant des certificats de CA +# Spécifie deux fichiers contenant des certificats de CA LDAPTrustedGlobalCert CA_DER /certs/cacert1.der LDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem -# Spécifie un fichier contenant des certificats clients -# ainsi qu'une clé +# Spécifie un fichier contenant des certificats clients +# ainsi qu'une clé LDAPTrustedGlobalCert CERT_BASE64 /certs/cert1.pem LDAPTrustedGlobalCert KEY_BASE64 /certs/key1.pem [password] # N'utilisez pas cette directive, sous peine de provoquer @@ -365,25 +365,25 @@ LDAPTrustedGlobalCert KEY_BASE64 /certs/key1.pem [password] <section id="settingcerts-openldap"><title>SDK OpenLDAP</title> - <p>Un ou plusieurs certificats de CA doivent être spécifiés pour + <p>Un ou plusieurs certificats de CA doivent être spécifiés pour que le SDK OpenLDAP fonctionne correctement. Ces certificats - peuvent être spécifiés sous forme de fichiers au format binaire - DER ou codés en Base64 (PEM).</p> + peuvent être spécifiés sous forme de fichiers au format binaire + DER ou codés en Base64 (PEM).</p> - <p>Les certificats clients sont spécifiés pour chaque connexion - à l'aide de la directive LDAPTrustedClientCert.</p> + <p>Les certificats clients sont spécifiés pour chaque connexion + à l'aide de la directive LDAPTrustedClientCert.</p> - <p>La documentation du SDK prétend que SSL et STARTTLS sont - supportés ; cependant, STARTTLS semble ne pas fonctionner avec - toutes les versions du SDK. Le mode SSL/TLS peut être défini en - utilisant le paramètre de la directive LDAPTrustedMode. Si une + <p>La documentation du SDK prétend que SSL et STARTTLS sont + supportés ; cependant, STARTTLS semble ne pas fonctionner avec + toutes les versions du SDK. Le mode SSL/TLS peut être défini en + utilisant le paramètre de la directive LDAPTrustedMode. Si une URL de type - ldaps:// est spécifiée, le mode SSL est forcé. La documentation - OpenLDAP indique que le support SSL (ldaps://) tend à être - remplacé par TLS, bien que le mode SSL fonctionne toujours.</p> + ldaps:// est spécifiée, le mode SSL est forcé. La documentation + OpenLDAP indique que le support SSL (ldaps://) tend à être + remplacé par TLS, bien que le mode SSL fonctionne toujours.</p> <highlight language="config"> -# Spécifie deux fichiers contenant des certificats de CA +# Spécifie deux fichiers contenant des certificats de CA LDAPTrustedGlobalCert CA_DER /certs/cacert1.der LDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem <Location "/ldap-status"> @@ -409,24 +409,24 @@ LDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem <section id="settingcerts-solaris"><title>SDK Solaris</title> - <p>SSL/TLS pour les bibliothèques LDAP propres à Solaris n'est - pas encore supporté. Si nécessaire, installez et utilisez plutôt - les bibliothèques OpenLDAP.</p> + <p>SSL/TLS pour les bibliothèques LDAP propres à Solaris n'est + pas encore supporté. Si nécessaire, installez et utilisez plutôt + les bibliothèques OpenLDAP.</p> </section> <section id="settingcerts-microsoft"><title>SDK Microsoft</title> <p>La configuration des certificats SSL/TLS pour les - bibliothèques LDAP propres à Microsoft s'effectue à l'intérieur - du registre système, et aucune directive de configuration n'est + bibliothèques LDAP propres à Microsoft s'effectue à l'intérieur + du registre système, et aucune directive de configuration n'est requise.</p> - <p>SSL et TLS sont tous deux supportés en utilisant des URLs de - type ldaps://, ou en définissant la directive LDAPTrustedMode à + <p>SSL et TLS sont tous deux supportés en utilisant des URLs de + type ldaps://, ou en définissant la directive LDAPTrustedMode à cet effet.</p> - <p>Note: L'état du support des certificats clients n'est pas + <p>Note: L'état du support des certificats clients n'est pas encore connu pour ce SDK.</p> </section> @@ -435,122 +435,122 @@ LDAPTrustedGlobalCert CA_BASE64 /certs/cacert2.pem <directivesynopsis> <name>LDAPSharedCacheSize</name> -<description>Taille en octets du cache en mémoire partagée</description> +<description>Taille en octets du cache en mémoire partagée</description> <syntax>LDAPSharedCacheSize <var>octets</var></syntax> <default>LDAPSharedCacheSize 500000</default> <contextlist><context>server config</context></contextlist> <usage> - <p>Cette directive permet de spécifier le nombre d'octets à allouer - pour le cache en mémoire partagée. La valeur par - défaut est 500kb. - Si elle est définie à 0, le cache en mémoire partagée ne sera pas - utilisé et chaque processus HTTPD va créer son propre cache.</p> + <p>Cette directive permet de spécifier le nombre d'octets à allouer + pour le cache en mémoire partagée. La valeur par + défaut est 500kb. + Si elle est définie à 0, le cache en mémoire partagée ne sera pas + utilisé et chaque processus HTTPD va créer son propre cache.</p> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPSharedCacheFile</name> -<description>Définit le fichier du cache en mémoire -partagée</description> +<description>Définit le fichier du cache en mémoire +partagée</description> <syntax>LDAPSharedCacheFile <var>chemin-fichier</var></syntax> <contextlist><context>server config</context></contextlist> <usage> - <p>Cette directive permet de spécifier le chemin du - fichier du cache en mémoire partagée. Si elle n'est pas définie, la - mémoire partagée anonyme sera utilisée si la plate-forme la + <p>Cette directive permet de spécifier le chemin du + fichier du cache en mémoire partagée. Si elle n'est pas définie, la + mémoire partagée anonyme sera utilisée si la plate-forme la supporte.</p> <p>Si <var>chemin-fichier</var> n'est pas un chemin absolu, il sera - relatif au répertoire défini via la directive <directive + relatif au répertoire défini via la directive <directive module="core">DefaultRuntimeDir</directive>.</p> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPCacheEntries</name> -<description>Nombre maximum d'entrées dans le cache LDAP +<description>Nombre maximum d'entré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écifier la taille maximale du cache - LDAP primaire. Ce cache contient les résultats de - recherche/identification positifs. Définissez-la à 0 pour désactiver - la mise en cache des résultats de recherche/identification positifs. - La taille par défaut est de 1024 recherches en cache.</p> + <p>Cette directive permet de spécifier la taille maximale du cache + LDAP primaire. Ce cache contient les résultats de + recherche/identification positifs. Définissez-la à 0 pour désactiver + la mise en cache des résultats de recherche/identification positifs. + La taille par défaut est de 1024 recherches en cache.</p> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPCacheTTL</name> -<description>Durée pendant laquelle les entrées du cache restent +<description>Durée pendant laquelle les entré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écifier la durée (en secondes) - pendant laquelle une entrée du cache de recherche/identification - reste valide. La valeur par défaut est de 600 secondes (10 + <p>Cette directive permet de spécifier la durée (en secondes) + pendant laquelle une entrée du cache de recherche/identification + reste valide. La valeur par défaut est de 600 secondes (10 minutes).</p> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPOpCacheEntries</name> -<description>Nombre d'entrées utilisées pour mettre en cache les -opérations de comparaison LDAP</description> +<description>Nombre d'entrées utilisées pour mettre en cache les +opé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écifier le nombre d'entrées que + <p>Cette directive permet de spécifier le nombre d'entrées que <module>mod_ldap</module> va utiliser pour mettre en cache les - opérations de comparaison LDAP. La valeur par défaut est de 1024 - entrées. Si elle est définie à 0, la mise en cache des opérations de - comparaison LDAP est désactivée.</p> + opérations de comparaison LDAP. La valeur par défaut est de 1024 + entrées. Si elle est définie à 0, la mise en cache des opérations de + comparaison LDAP est désactivée.</p> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPOpCacheTTL</name> -<description>Durée pendant laquelle les entrées du cache d'opérations +<description>Durée pendant laquelle les entrées du cache d'opé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écifier la durée (en secondes) - pendant laquelle les entrées du cache d'opérations restent valides. - La valeur par défaut est de 600 secondes.</p> + <p>Cette directive permet de spécifier la durée (en secondes) + pendant laquelle les entrées du cache d'opérations restent valides. + La valeur par dé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ête +alternatifs (referrals) avant l'abandon de la requête LDAP.</description> <syntax>LDAPReferralHopLimit <var>nombre</var></syntax> -<default>Dépend du SDK, en général entre 5 et 10</default> +<default>Dépend du SDK, en général entre 5 et 10</default> <contextlist><context>directory</context><context>.htaccess</context></contextlist> <override>AuthConfig</override> <usage> - <p>Si elle est activée par la directive <directive>LDAPReferrals</directive>, - cette directive permet de définir le nombre maximum de sauts vers - des serveurs alternatifs (referrals) avant l'abandon de la requête + <p>Si elle est activée par la directive <directive>LDAPReferrals</directive>, + cette directive permet de définir le nombre maximum de sauts vers + des serveurs alternatifs (referrals) avant l'abandon de la requête LDAP.</p> <note type="warning"> -<p>L'ajustement de ce paramètre n'est pas commun à tous les SDKs LDAP.</p> +<p>L'ajustement de ce paramètre n'est pas commun à tous les SDKs LDAP.</p> </note> </usage> </directivesynopsis> @@ -558,21 +558,21 @@ LDAP.</description> <directivesynopsis> <name>LDAPReferrals</name> <description>Active la redirection vers des serveurs alternatifs au -cours des requêtes vers le serveur LDAP.</description> +cours des requêtes vers le serveur LDAP.</description> <syntax>LDAPReferrals <var>On|Off|default</var></syntax> <default>LDAPReferrals On</default> <contextlist><context>directory</context><context>.htaccess</context></contextlist> <override>AuthConfig</override> -<compatibility>Le paramètre <var>default</var> est disponible depuis la +<compatibility>Le paramètre <var>default</var> est disponible depuis la version 2.4.7 du serveur HTTP Apache.</compatibility> <usage> <p>Certains serveurs LDAP partagent leur annuaire en plusieurs - domaines et utilisent le système des redirections (referrals) pour - aiguiller un client lorsque les limites d'un domaine doivent être - franchies. Ce processus est similaire à une redirection HTTP. Les - bibliothèques client LDAP ne respectent pas forcément ces - redirections par défaut. Cette directive permet de configurer + domaines et utilisent le système des redirections (referrals) pour + aiguiller un client lorsque les limites d'un domaine doivent être + franchies. Ce processus est similaire à une redirection HTTP. Les + bibliothèques client LDAP ne respectent pas forcément ces + redirections par défaut. Cette directive permet de configurer explicitement les redirections LDAP dans le SDK sous-jacent.</p> <p>La directive <directive>LDAPReferrals</directive> accepte les @@ -581,114 +581,114 @@ version 2.4.7 du serveur HTTP Apache.</compatibility> <dl> <dt>"on"</dt> <dd> <p>Avec la valeur "on", la prise en compte des redirections - LDAP par le SDK sous-jacent est activée, la directive + LDAP par le SDK sous-jacent est activée, la directive <directive>LDAPReferralHopLimit</directive> permet de surcharger la - "hop limit" du SDK, et un "LDAP rebind callback" est enregistré.</p></dd> + "hop limit" du SDK, et un "LDAP rebind callback" est enregistré.</p></dd> <dt>"off"</dt> <dd> <p>Avec la valeur "off", la prise en compte des redirections - LDAP par le SDK sous-jacent est complètement désactivée.</p></dd> + LDAP par le SDK sous-jacent est complètement désactivée.</p></dd> <dt>"default"</dt> <dd> <p>Avec la valeur "default", la prise en compte des redirections - LDAP par le SDK sous-jacent n'est pas modifiée, la directive + LDAP par le SDK sous-jacent n'est pas modifiée, la directive <directive>LDAPReferralHopLimit</directive> ne permet pas de surcharger la - "hop limit" du SDK, et aucun "LDAP rebind callback" n'est enregistré.</p></dd> + "hop limit" du SDK, et aucun "LDAP rebind callback" n'est enregistré.</p></dd> </dl> <p>La directive <directive>LDAPReferralHopLimit</directive> travaille en conjonction avec cette directive pour limiter le nombre de - redirections à suivre pour achever le traitement de la requête LDAP. - Lorsque le processus de redirection est activé par la valeur "On", - les données d'authentification du client sont transmises via un - "rebind callback" à tout serveur LDAP qui en fait la demande.</p> + redirections à suivre pour achever le traitement de la requête LDAP. + Lorsque le processus de redirection est activé par la valeur "On", + les données d'authentification du client sont transmises via un + "rebind callback" à tout serveur LDAP qui en fait la demande.</p> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPRetryDelay</name> -<description>Définit le temps d'attente avant un autre essai de connexion au +<description>Dé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éfinie - à une valeur différente de 0, le serveur attendra pendant la durée - spécifiée pour envoyer à nouveau sa requête LDAP. Une valeur de 0 - implique une absence de délai pour les essais successifs.</p> + <p>Si la directive <directive>LDAPRetryDelay</directive> est définie + à une valeur différente de 0, le serveur attendra pendant la durée + spécifiée pour envoyer à nouveau sa requête LDAP. Une valeur de 0 + implique une absence de dé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élai dépassé ou connexion refusée. </p> + cas d'erreurs LDAP du type délai dépassé ou connexion refusée. </p> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPRetries</name> -<description>Définit le nombre maximum de tentatives de connexions au +<description>Dé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 à des échecs de connexion au serveur LDAP, le serveur - tentera de se connecter autant de fois qu'indiqué par la directive - <directive>LDAPRetries</directive>. Si cette directive est définie à - 0, le serveur ne tentera pas d'autre connexion après un échec.</p> + <p>Suite à des échecs de connexion au serveur LDAP, le serveur + tentera de se connecter autant de fois qu'indiqué par la directive + <directive>LDAPRetries</directive>. Si cette directive est définie à + 0, le serveur ne tentera pas d'autre connexion après un échec.</p> <p>Il est possible d'effectuer une autre tentative de connexion en - cas d'erreurs LDAP du type délai dépassé ou connexion refusée. </p> + cas d'erreurs LDAP du type délai dépassé ou connexion refusée. </p> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPTrustedGlobalCert</name> -<description>Définit le nom de fichier ou la base de données contenant -les Autorités de Certification de confiance globales ou les certificats +<description>Définit le nom de fichier ou la base de données contenant +les Autorité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écifier le chemin et le nom du + <p>Cette directive permet de spécifier le chemin et le nom du fichier contenant les certificats des CA de confiance et/ou les - certificats clients du système global que <module>mod_ldap</module> - utilisera pour établir une connexion SSL ou TLS avec un serveur - LDAP. Notez que toute information relative aux certificats spécifiée - en utilisant cette directive s'applique globalement à l'ensemble de + certificats clients du système global que <module>mod_ldap</module> + utilisera pour établir une connexion SSL ou TLS avec un serveur + LDAP. Notez que toute information relative aux certificats spécifiée + en utilisant cette directive s'applique globalement à l'ensemble de l'installation du serveur. Certains SDK LDAP (en particulier Novell) - nécessitent la définition globale de tous les certificats clients en - utilisant cette directive. La plupart des autres SDK nécessitent la - définition des certificats clients dans une section Directory ou + nécessitent la définition globale de tous les certificats clients en + utilisant cette directive. La plupart des autres SDK nécessitent la + définition des certificats clients dans une section Directory ou Location en utilisant la directive LDAPTrustedClientCert. Si vous ne - définissez pas ces directives correctement, une erreur sera générée + définissez pas ces directives correctement, une erreur sera générée lors des tentatives de contact avec un serveur LDAP, ou la connexion - échouera silencieusement (Voir plus haut le guide des certificats - SSL/TLS pour plus de détails). Le paramètre type spécifie le type de - certificat en cours de définition, en fonction du SDK LDAP utilisé. - Les types supportés sont :</p> + échouera silencieusement (Voir plus haut le guide des certificats + SSL/TLS pour plus de détails). Le paramètre type spécifie le type de + certificat en cours de définition, en fonction du SDK LDAP utilisé. + Les types supportés sont :</p> <ul> - <li>CA_DER - certificat de CA codé en binaire DER</li> - <li>CA_BASE64 - certificat de CA codé en PEM</li> - <li>CA_CERT7_DB - fichier de base de données des certificats de CA + <li>CA_DER - certificat de CA codé en binaire DER</li> + <li>CA_BASE64 - certificat de CA codé en PEM</li> + <li>CA_CERT7_DB - fichier de base de données des certificats de CA de Netscape cert7.db</li> - <li>CA_SECMOD - fichier de base de données secmod de Netscape</li> - <li>CERT_DER - certificat client codé en binaire DER</li> - <li>CERT_BASE64 - certificat client codé en PEM</li> - <li>CERT_KEY3_DB - fichier de base de données des certificats + <li>CA_SECMOD - fichier de base de données secmod de Netscape</li> + <li>CERT_DER - certificat client codé en binaire DER</li> + <li>CERT_BASE64 - certificat client codé en PEM</li> + <li>CERT_KEY3_DB - fichier de base de données des certificats clients de Netscape key3.db</li> <li>CERT_NICKNAME - certificat client "nickname" (SDK Netscape)</li> - <li>CERT_PFX - certificat client codé en PKCS#12 (SDK Novell)</li> - <li>KEY_DER - clé privée codée en binaire DER</li> - <li>KEY_BASE64 - clé privée codée en PEM</li> - <li>KEY_PFX - clé privée codée en PKCS#12 (SDK Novell)</li> + <li>CERT_PFX - certificat client codé en PKCS#12 (SDK Novell)</li> + <li>KEY_DER - clé privée codée en binaire DER</li> + <li>KEY_BASE64 - clé privée codée en PEM</li> + <li>KEY_PFX - clé privée codée en PKCS#12 (SDK Novell)</li> </ul> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPTrustedClientCert</name> -<description>Définit le nom de fichier contenant un certificat client ou -un alias renvoyant vers un certificat client spécifique à une connexion. +<description>Définit le nom de fichier contenant un certificat client ou +un alias renvoyant vers un certificat client spécifique à une connexion. Tous les SDK LDAP ne supportent pas les certificats clients par connexion.</description> <syntax>LDAPTrustedClientCert <var>type</var> @@ -697,85 +697,85 @@ connexion.</description> host</context><context>directory</context><context>.htaccess</context></contextlist> <usage> - <p>Cette directive permet de spécifier le chemin et le nom de - fichier ou l'alias d'un certificat client par connexion utilisé lors - de l'établissement d'une connexion SSL ou TLS avec un serveur LDAP. - Les sections directory ou location peuvent posséder leurs propres + <p>Cette directive permet de spécifier le chemin et le nom de + fichier ou l'alias d'un certificat client par connexion utilisé lors + de l'établissement d'une connexion SSL ou TLS avec un serveur LDAP. + Les sections directory ou location peuvent possé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 à la place + LDAP si vous tenter d'utiliser cette directive (Utilisez à la place la directive LDAPTrustedGlobalCert pour les certificats clients sous Novell - Voir plus haut le guide des certificats SSL/TLS pour plus - de détails). Le paramètre type spécifie le type du certificat en - cours de définition, en fonction du SDK LDAP utilisé. Les types - supportés sont :</p> + de détails). Le paramètre type spécifie le type du certificat en + cours de définition, en fonction du SDK LDAP utilisé. Les types + supportés sont :</p> <ul> - <li>CA_DER - certificat de CA codé en binaire DER</li> - <li>CA_BASE64 - certificat de CA codé en PEM</li> - <li>CERT_DER - certificat client codé en binaire DER</li> - <li>CERT_BASE64 - certificat client codé en PEM</li> + <li>CA_DER - certificat de CA codé en binaire DER</li> + <li>CA_BASE64 - certificat de CA codé en PEM</li> + <li>CERT_DER - certificat client codé en binaire DER</li> + <li>CERT_BASE64 - certificat client codé en PEM</li> <li>CERT_NICKNAME - certificat client "nickname" (SDK Netscape)</li> - <li>KEY_DER - clé privée codée en binaire DER</li> - <li>KEY_BASE64 - clé privée codée en PEM</li> + <li>KEY_DER - clé privée codée en binaire DER</li> + <li>KEY_BASE64 - clé privée codée en PEM</li> </ul> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPTrustedMode</name> -<description>Spécifie le mode (SSL ou TLS) à utiliser lors de la -connexion à un serveur LDAP.</description> +<description>Spécifie le mode (SSL ou TLS) à utiliser lors de la +connexion à 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és :</p> + <p>Les modes suivants sont supportés :</p> <ul> <li>NONE - aucun chiffrement</li> - <li>SSL - chiffrement ldaps:// sur le port par défaut 636</li> - <li>TLS - chiffrement STARTTLS sur le port par défaut 389</li> + <li>SSL - chiffrement ldaps:// sur le port par défaut 636</li> + <li>TLS - chiffrement STARTTLS sur le port par défaut 389</li> </ul> - <p>Les modes ci-dessus ne sont pas supportés par tous les SDK LDAP. - Un message d'erreur sera généré à l'exécution si un mode n'est pas - supporté, et la connexion au serveur LDAP échouera. + <p>Les modes ci-dessus ne sont pas supportés par tous les SDK LDAP. + Un message d'erreur sera généré à l'exécution si un mode n'est pas + supporté, et la connexion au serveur LDAP échouera. </p> - <p>Si une URL de type ldaps:// est spécifiée, le mode est forcé à - SSL et la définition de LDAPTrustedMode est ignorée.</p> + <p>Si une URL de type ldaps:// est spécifiée, le mode est forcé à + SSL et la définition de LDAPTrustedMode est ignorée.</p> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPConnectionTimeout</name> -<description>Spécifie le délai d'attente en secondes de la socket de +<description>Spécifie le dé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èque client LDAP - sous-jacente, si elle est disponible. Cette valeur représente la - durée pendant laquelle la bibliothèque client LDAP va attendre que - le processus de connexion TCP au serveur LDAP soit achevé.</p> - - <p>Si la connexion n'a pas réussi avant ce délai, une erreur sera - renvoyée, ou la bibliothèque client LDAP tentera de se connecter à - un second serveur LDAP, s'il en a été défini un (via une liste de - noms d'hôtes séparés par des espaces dans la directive <directive + LDAP_OPT_CONNECT_TIMEOUT) dans la bibliothèque client LDAP + sous-jacente, si elle est disponible. Cette valeur représente la + durée pendant laquelle la bibliothèque client LDAP va attendre que + le processus de connexion TCP au serveur LDAP soit achevé.</p> + + <p>Si la connexion n'a pas réussi avant ce délai, une erreur sera + renvoyée, ou la bibliothèque client LDAP tentera de se connecter à + un second serveur LDAP, s'il en a été défini un (via une liste de + noms d'hôtes séparés par des espaces dans la directive <directive module="mod_authnz_ldap">AuthLDAPURL</directive>).</p> - <p>La valeur par défaut est 10 secondes, si la bibliothèque client - LDAP liée avec le serveur supporte l'option + <p>La valeur par défaut est 10 secondes, si la bibliothèque client + LDAP liée avec le serveur supporte l'option LDAP_OPT_NETWORK_TIMEOUT.</p> - <note>LDAPConnectionTimeout n'est disponible que si la bibliothèque client - LDAP liée avec le serveur supporte l'option + <note>LDAPConnectionTimeout n'est disponible que si la bibliothèque client + LDAP liée avec le serveur supporte l'option LDAP_OPT_NETWORK_TIMEOUT (ou LDAP_OPT_CONNECT_TIMEOUT), et le - comportement final est entièrement dicté par la bibliothèque client + comportement final est entièrement dicté par la bibliothèque client LDAP. </note> </usage> @@ -783,28 +783,28 @@ connexion</description> <directivesynopsis> <name>LDAPTimeout</name> -<description>Spécifie le délai d'attente pour les opérations de +<description>Spécifie le délai d'attente pour les opé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 à partir de la version 2.3.5 du serveur HTTP +<compatibility>Disponible à partir de la version 2.3.5 du serveur HTTP Apache</compatibility> <usage> - <p>Cette directive permet de spécifier le délai d'attente pour les - opérations de recherche et d'identification, ainsi que l'option - LDAP_OPT_TIMEOUT dans la bibliothèque LDAP client sous-jacente, + <p>Cette directive permet de spécifier le délai d'attente pour les + opérations de recherche et d'identification, ainsi que l'option + LDAP_OPT_TIMEOUT dans la bibliothèque LDAP client sous-jacente, lorsqu'elle est disponible.</p> - <p>Lorsque le délai est atteint, httpd va refaire un essai dans le - cas où une connexion existante a été silencieusement fermée par un + <p>Lorsque le délai est atteint, httpd va refaire un essai dans le + cas où une connexion existante a été silencieusement fermée par un pare-feu. Les performances seront cependant bien meilleures si le - pare-feu est configuré pour envoyer des paquets TCP RST au lieu de + pare-feu est configuré pour envoyer des paquets TCP RST au lieu de rejeter silencieusement les paquets.</p> <note> - <p>Les délais pour les opérations de comparaison LDAP nécessitent un + <p>Les délais pour les opérations de comparaison LDAP nécessitent un SDK avec LDAP_OPT_TIMEOUT, comme OpenLDAP >= 2.4.4.</p> </note> @@ -813,56 +813,56 @@ Apache</compatibility> <directivesynopsis> <name>LDAPVerifyServerCert</name> -<description>Force la vérification du certificat du +<description>Force la vé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écifier s'il faut forcer la - vérification d'un certificat de serveur lors de l'établissement + <p>Cette directive permet de spécifier s'il faut forcer la + vérification d'un certificat de serveur lors de l'établissement d'une connexion SSL avec un serveur LDAP.</p> </usage> </directivesynopsis> <directivesynopsis> <name>LDAPConnectionPoolTTL</name> -<description>Désactive les connexions d'arrière-plan qui sont restées +<description>Désactive les connexions d'arrière-plan qui sont resté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 à partir de la version 2.3.12 du serveur HTTP +<compatibility>Disponible à partir de la version 2.3.12 du serveur HTTP Apache</compatibility> <usage> - <p>Cette directive permet de spécifier la durée maximale, en + <p>Cette directive permet de spécifier la durée maximale, en secondes, pendant laquelle une connexion LDAP du jeu de connexions - peut demeurer inactive, mais rester quand-même disponible pour une - utilisation éventuelle. Le jeu de connexions est nettoyé au fur et à - mesure des besoins, de manière non asynchrone.</p> + peut demeurer inactive, mais rester quand-même disponible pour une + utilisation éventuelle. Le jeu de connexions est nettoyé au fur et à + mesure des besoins, de manière non asynchrone.</p> - <p>Si cette directive est définie à 0, les connexions ne sont jamais - sauvegardées dans le jeu de connexions d'arrière-plan. Avec la - valeur par défaut -1, ou toute autre valeur négative, les connexions - peuvent être réutilisées sans limite de durée.</p> + <p>Si cette directive est définie à 0, les connexions ne sont jamais + sauvegardées dans le jeu de connexions d'arrière-plan. Avec la + valeur par défaut -1, ou toute autre valeur négative, les connexions + peuvent être réutilisées sans limite de durée.</p> - <p>Dans le but d'améliorer les performances, le temps de référence - qu'utilise cette directive correspond au moment où la connexion LDAP - est enregistrée ou remise dans le jeu de connexions, et non au - moment du dernier échange réussi avec le serveur LDAP.</p> + <p>Dans le but d'améliorer les performances, le temps de référence + qu'utilise cette directive correspond au moment où la connexion LDAP + est enregistrée ou remise dans le jeu de connexions, et non au + moment du dernier échange réussi avec le serveur LDAP.</p> <p>La version 2.4.10 a introduit de nouvelles mesures permettant - d'éviter une augmentation excessive du temps de référence due à des - correspondances positives dans le cache ou des requêtes lentes. A - cet effet, le temps de référence n'est pas réactualisé si aucune - connexion LDAP d'arrière-plan n'est requise ; d'autre part, le temps - de référence se base sur le moment où la requête HTTP est reçue, et - non sur le moment où la requête a été traitée.</p> - - <note><p>Cette durée de vie s'exprime par défaut en secondes, mais - il est possible d'utiliser d'autres unités en ajoutant un suffixe : + d'éviter une augmentation excessive du temps de référence due à des + correspondances positives dans le cache ou des requêtes lentes. A + cet effet, le temps de référence n'est pas réactualisé si aucune + connexion LDAP d'arrière-plan n'est requise ; d'autre part, le temps + de référence se base sur le moment où la requête HTTP est reçue, et + non sur le moment où la requête a été traitée.</p> + + <note><p>Cette durée de vie s'exprime par défaut en secondes, mais + il est possible d'utiliser d'autres unités en ajoutant un suffixe : millisecondes (ms), minutes (min), ou heures (h). </p></note> </usage> @@ -870,32 +870,32 @@ Apache</compatibility> <directivesynopsis> <name>LDAPLibraryDebug</name> -<description>Active le débogage dans le SDK LDAP</description> +<description>Active le dé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ébogage LDAP spécifiques au SDK, qui - entraînent en général une journalisation d'informations verbeuses du + <p>Active les options de débogage LDAP spécifiques au SDK, qui + entraînent en géné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ès détaillées qui peuvent s'avérer utiles lors du - débogage des problèmes de connexion avec des serveurs LDAP - d'arrière-plan.</p> + informations très détaillées qui peuvent s'avérer utiles lors du + débogage des problèmes de connexion avec des serveurs LDAP + d'arrière-plan.</p> <p>Cette option n'est configurable que lorsque le serveur HTTP - Apache est lié avec un SDK LDAP qui implémente + Apache est lié avec un SDK LDAP qui implé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ées peuvent contenir des données - d'authentification en clair utilisées ou validées lors de - l'authentification LDAP ; vous devez donc prendre soin de protéger + <p>Les informations journalisées peuvent contenir des données + d'authentification en clair utilisées ou validées lors de + l'authentification LDAP ; vous devez donc prendre soin de protéger et de purger le journal des erreurs lorsque cette directive est - utilisée.</p> + utilisée.</p> </note> </usage> diff --git a/docs/manual/mod/mod_lua.xml.fr b/docs/manual/mod/mod_lua.xml.fr index 30011eb06b..6669ff7166 100644 --- a/docs/manual/mod/mod_lua.xml.fr +++ b/docs/manual/mod/mod_lua.xml.fr @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1741842:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> diff --git a/docs/manual/mod/mod_proxy_connect.xml.fr b/docs/manual/mod/mod_proxy_connect.xml.fr index 06f08c8e86..f5a68e0bf6 100644 --- a/docs/manual/mod/mod_proxy_connect.xml.fr +++ b/docs/manual/mod/mod_proxy_connect.xml.fr @@ -1,9 +1,9 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1648846:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> -<!-- $LastChangedRevision: 2015010301 $ --> + <!-- Licensed to the Apache Software Foundation (ASF) under one or more diff --git a/docs/manual/mod/mod_proxy_html.xml.fr b/docs/manual/mod/mod_proxy_html.xml.fr index dd66c12676..e2be08b983 100644 --- a/docs/manual/mod/mod_proxy_html.xml.fr +++ b/docs/manual/mod/mod_proxy_html.xml.fr @@ -423,7 +423,7 @@ dynamiquement au cours du traitement d'une requête. </p> </usage> </directivesynopsis> -i + <directivesynopsis> <name>ProxyHTMLEvents</name> <description>Spécifie les attributs à traiter comme des évènements de diff --git a/docs/manual/mod/mod_proxy_scgi.xml.fr b/docs/manual/mod/mod_proxy_scgi.xml.fr index 2a914cfb26..33d4bda5b4 100644 --- a/docs/manual/mod/mod_proxy_scgi.xml.fr +++ b/docs/manual/mod/mod_proxy_scgi.xml.fr @@ -97,10 +97,10 @@ ProxyPass "/scgi-bin/" "balancer://somecluster/" <module>mod_proxy_scgi</module> génère une estimation la plus précise possible de <var>PATH_INFO</var>, définissez cette variable d'environnement. La variable doit être définie avant - que la directive <directive - mod="mod_env">SetEnv</directive> ne soit effective. Il est possible - d'utiliser à la place la directive <directive - mod="mod_setenvif">SetEnvIf</directive> : <code>SetEnvIf Request_URI . proxy-scgi-pathinfo</code> + que la directive <directive module="mod_env">SetEnv</directive> ne soit + effective. Il est possible d'utiliser à la place la directive + <directive module="mod_setenvif">SetEnvIf</directive> : <code>SetEnvIf + Request_URI . proxy-scgi-pathinfo</code> </dd> </dl> </section> diff --git a/docs/manual/mod/mod_rewrite.xml.fr b/docs/manual/mod/mod_rewrite.xml.fr index b6a40c656c..06735d64cc 100644 --- a/docs/manual/mod/mod_rewrite.xml.fr +++ b/docs/manual/mod/mod_rewrite.xml.fr @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1776708:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> diff --git a/docs/manual/mod/mod_ssl.xml.fr b/docs/manual/mod/mod_ssl.xml.fr index db26ac9259..9445400184 100644 --- a/docs/manual/mod/mod_ssl.xml.fr +++ b/docs/manual/mod/mod_ssl.xml.fr @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1761215:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> -<!-- $LastChangedRevision: 2016092401 $ --> <!-- Licensed to the Apache Software Foundation (ASF) under one or more diff --git a/docs/manual/sitemap.xml.fr b/docs/manual/sitemap.xml.fr index 755806d07f..05a0b50451 100644 --- a/docs/manual/sitemap.xml.fr +++ b/docs/manual/sitemap.xml.fr @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE sitemap SYSTEM "./style/sitemap.dtd"> <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?> -<!-- English Revision: 1732099:1780356 (outdated) --> +<!-- English Revision: 1780356 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -131,6 +131,7 @@ Compatibilité</page> utilisateurs</page> <page href="howto/reverse_proxy.html">Guide de configuration des mandataires inverses</page> +<page href="howto/http2.html">Guide HTTP/2</page> </category> <category id="platform"> diff --git a/docs/manual/socache.xml.fr b/docs/manual/socache.xml.fr index 257c27b0d5..141af88677 100644 --- a/docs/manual/socache.xml.fr +++ b/docs/manual/socache.xml.fr @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?> - -<!-- English Revision: 1740717:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> diff --git a/docs/manual/ssl/ssl_intro.xml.fr b/docs/manual/ssl/ssl_intro.xml.fr index 4e0544ea3d..79fb1f68cd 100644 --- a/docs/manual/ssl/ssl_intro.xml.fr +++ b/docs/manual/ssl/ssl_intro.xml.fr @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1776090:1780210 (outdated) --> +<!-- English Revision: 1780210 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -573,7 +573,7 @@ l'Internet Engineering Task Force (IETF).</p> [<a href="#AC96">AC96</a>, ch13].</p> </section> -<section id="digestfuntion"> +<section id="digestfunction"> <title>Fonction de création d'empreinte</title> <p>Le choix d'une fonction de création d'empreinte détermine la manière dont une empreinte est créée à partir d'une unité de données. SSL supporte |