VladPolskiy/apache-http-server
1
0
Fork 0
mirror of https://github.com/apache/httpd.git synced 2025-08-10 02:56:11 +00:00
Code Issues Packages Projects Releases Wiki Activity

fr doc XML files updates.

Browse Source 
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1900654 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Lucien Gentis
2022-05-07 14:36:34 +00:00
parent 2115b29968
commit dd1c14fcc9
2 changed files with 78 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files

157
docs/manual/mod/mod_authn_dbd.xml.fr
View File

@ -1,7 +1,7 @@
<?xml version="1.0"?> <?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1874148 --> <!-- English Revision: 1900525 -->
<!-- French translation : Lucien GENTIS --> <!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines --> <!-- Reviewed by : Vincent Deffontaines -->
@ -25,7 +25,7 @@
<modulesynopsis metafile="mod_authn_dbd.xml.meta"> <modulesynopsis metafile="mod_authn_dbd.xml.meta">
<name>mod_authn_dbd</name> <name>mod_authn_dbd</name>
<description>Authentification utilisateur &agrave; l'aide d'une base de donn&eacute;es <description>Authentification utilisateur à l'aide d'une base de données
SQL</description> SQL</description>
<status>Extension</status> <status>Extension</status>
<sourcefile>mod_authn_dbd.c</sourcefile> <sourcefile>mod_authn_dbd.c</sourcefile>
@ -35,16 +35,16 @@ SQL</description>
<p>Ce module permet aux frontaux d'authentification comme <p>Ce module permet aux frontaux d'authentification comme
<module>mod_auth_digest</module> et <module>mod_auth_basic</module> <module>mod_auth_digest</module> et <module>mod_auth_basic</module>
d'authentifier les utilisateurs en les recherchant dans une base de d'authentifier les utilisateurs en les recherchant dans une base de
donn&eacute;es SQL. <module>mod_authn_file</module>, par exemple, fournit données SQL. <module>mod_authn_file</module>, par exemple, fournit
une fonctionnalit&eacute; similaire.</p> une fonctionnalité similaire.</p>
<p>Ce module s'appuie sur <module>mod_dbd</module> pour sp&eacute;cifier le <p>Ce module s'appuie sur <module>mod_dbd</module> pour spécifier le
pilote de la base de donn&eacute;es sous-jacente et les param&egrave;tres de pilote de la base de données sous-jacente et les paramètres de
connexion, mais aussi pour g&eacute;rer les connexions &agrave; la base de connexion, mais aussi pour gérer les connexions à la base de
donn&eacute;es.</p> données.</p>
<p>Si l'on utilise <module>mod_auth_basic</module> ou <p>Si l'on utilise <module>mod_auth_basic</module> ou
<module>mod_auth_digest</module>, on peut invoquer ce module en <module>mod_auth_digest</module>, on peut invoquer ce module en
affectant la valeur <code>dbd</code> &agrave; la directive <directive affectant la valeur <code>dbd</code> à la directive <directive
module="mod_auth_basic">AuthBasicProvider</directive> ou <directive module="mod_auth_basic">AuthBasicProvider</directive> ou <directive
module="mod_auth_digest">AuthDigestProvider</directive>.</p> module="mod_auth_digest">AuthDigestProvider</directive>.</p>
</summary> </summary>
@ -65,21 +65,21 @@ passe</a></seealso>
<section id="socache"> <section id="socache">
<title>Performances et mise en cache</title> <title>Performances et mise en cache</title>
<p>Certains utilisateurs de l'authentification DBD sous HTTPD 2.2/2.4 ont <p>Certains utilisateurs de l'authentification DBD sous HTTPD 2.2/2.4 ont
signal&eacute; une charge probl&eacute;matique au niveau de la base de donn&eacute;es. Cela signalé une charge problématique au niveau de la base de données. Cela
se produit en g&eacute;n&eacute;ral lorsqu'une page HTML contient des centaines d'objets se produit en général lorsqu'une page HTML contient des centaines d'objets
(comme des images, des scripts, etc...), chacun d'entre eux n&eacute;cessitant (comme des images, des scripts, etc...), chacun d'entre eux nécessitant
une authentification. Les utilisateurs qui rencontrent ce genre de une authentification. Les utilisateurs qui rencontrent ce genre de
probl&egrave;me peuvent utiliser le module <module>mod_authn_socache</module> problème peuvent utiliser le module <module>mod_authn_socache</module>
qui permet de mettre les donn&eacute;es d'authentification en cache, et qui permet de mettre les données d'authentification en cache, et
soulager ainsi la base de donn&eacute;es de la plus grande partie de la charge.</p> soulager ainsi la base de données de la plus grande partie de la charge.</p>
</section> </section>
<section id="example"> <section id="example">
<title>Exemple de configuration</title> <title>Exemple de configuration</title>
<p>Voici un exemple simple d'utilisation de ce module dans un contexte <p>Voici un exemple simple d'utilisation de ce module dans un contexte
d'authentification et de bases de donn&eacute;es.</p> d'authentification et de bases de données.</p>
<highlight language="config"> <highlight language="config">
# configuration de mod_dbd modifi&eacute;e pour inclure la mise en cache de # configuration de mod_dbd modifiée pour inclure la mise en cache de
# l'authentification # l'authentification
DBDriver pgsql DBDriver pgsql
DBDParams "dbname=apacheauth user=apache password=xxxxxx" DBDParams "dbname=apacheauth user=apache password=xxxxxx"
@ -95,11 +95,11 @@ DBDExptime 300
AuthType Basic AuthType Basic
AuthName "Mon serveur" AuthName "Mon serveur"
# Pour mettre en cache les donn&eacute;es d'authentification, placez socache # Pour mettre en cache les données d'authentification, placez socache
# avant dbd # avant dbd
AuthBasicProvider socache dbd AuthBasicProvider socache dbd
# Aussi n&eacute;cessaire &agrave; la mise en cache : dire au cache de mettre en # Aussi nécessaire à la mise en cache : dire au cache de mettre en
# cache les recherches dbd ! # cache les recherches dbd !
AuthnCacheProvideFor dbd AuthnCacheProvideFor dbd
AuthnCacheContext mon-serveur AuthnCacheContext mon-serveur
@ -107,121 +107,118 @@ DBDExptime 300
# configuration de mod_authz_core # configuration de mod_authz_core
Require valid-user Require valid-user
# la requ&ecirc;te SQL de mod_authn_dbd pour authentifier un utilisateur # la requête SQL de mod_authn_dbd pour authentifier un utilisateur
AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s" AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
&lt;/Directory&gt; &lt;/Directory&gt;
</highlight> </highlight>
</section> </section>
<section id="exposed"> <section id="exposed">
<title>Mise &agrave; disposition des informations de connexion</title> <title>Mise à disposition des informations de connexion</title>
<p> <p>
Si httpd a &eacute;t&eacute; compil&eacute; avec la version 1.3.0 ou sup&eacute;rieure de Pour chaque requête envoyée au serveur de
l'<glossary>APR</glossary>, pour chaque requ&ecirc;te envoy&eacute;e au serveur de base de données, toutes les valeurs de colonnes du premier
base de donn&eacute;es, toutes les valeurs de colonnes du premier enregistrement renvoyé par la requête sont affectées à des variables
enregistrement renvoy&eacute; par la requ&ecirc;te sont affect&eacute;es &agrave; des variables d'environnement avec le préfixe "AUTHENTICATE_".
d'environnement avec le pr&eacute;fixe "AUTHENTICATE_".
</p> </p>
<p>Par exemple, si une requ&ecirc;te renvoie un nom d'utilisateur, un nom <p>Par exemple, si une requête renvoie un nom d'utilisateur, un nom
complet et un num&eacute;ro de t&eacute;l&eacute;phone, un programme CGI pourra acc&eacute;der &agrave; ces complet et un numéro de téléphone, un programme CGI pourra accéder à ces
informations sans avoir besoin d'effectuer une deuxi&egrave;me requ&ecirc;te vers la informations sans avoir besoin d'effectuer une deuxième requête vers la
base de donn&eacute;es.</p> base de données.</p>
<p>Ceci va entra&icirc;ner une simplification consid&eacute;rable du code et de la <p>Ceci va entraîner une simplification considérable du code et de la
configuration n&eacute;cessaire de certaines applications web. configuration nécessaire de certaines applications web.
</p> </p>
</section> </section>
<section id="security"> <section id="security">
<title>Pr&eacute;vention contre les injections SQL</title> <title>Prévention contre les injections SQL</title>
<p>Selon le driver DBD et le serveur d'arri&egrave;re-plan que vous utilisez, <p>Selon le driver DBD et le serveur d'arrière-plan que vous utilisez,
vous devrez prendre garde &agrave; la s&eacute;curit&eacute; dans le domaine SQL. vous devrez prendre garde à la sécurité dans le domaine SQL.
Avec la plupart des drivers, vous n'avez rien &agrave; faire : la Avec la plupart des drivers, vous n'avez rien à faire : la
requ&ecirc;te est pr&eacute;par&eacute;e par la base de donn&eacute;es au d&eacute;marrage, et l'entr&eacute;e requête est préparée par la base de données au démarrage, et l'entrée
utilisateur n'est utilis&eacute;e qu'en tant que donn&eacute;e. Mais vous aurez utilisateur n'est utilisée qu'en tant que donnée. Mais vous aurez
peut-&ecirc;tre &agrave; nettoyer cette entr&eacute;e. Au moment o&ugrave; ces lignes sont peut-être à nettoyer cette entrée. Au moment où ces lignes sont
&eacute;crites, le seul driver qui peut n&eacute;cessiter le nettoyage de l'entr&eacute;e écrites, le seul driver qui peut nécessiter le nettoyage de l'entrée
est FreeTDS.</p> est FreeTDS.</p>
<p>Veuillez vous r&eacute;f&eacute;rez &agrave; la documentation de <p>Veuillez vous référez à la documentation de
<module>mod_dbd</module> pour plus d'informations &agrave; propos de la <module>mod_dbd</module> pour plus d'informations à propos de la
s&eacute;curit&eacute; dans ce domaine.</p> sécurité dans ce domaine.</p>
</section> </section>
<directivesynopsis> <directivesynopsis>
<name>AuthDBDUserPWQuery</name> <name>AuthDBDUserPWQuery</name>
<description>Requ&ecirc;te SQL servant &agrave; v&eacute;rifier le mot de passe d'un <description>Requête SQL servant à vérifier le mot de passe d'un
utilisateur</description> utilisateur</description>
<syntax>AuthDBDUserPWQuery <var>requ&ecirc;te</var></syntax> <syntax>AuthDBDUserPWQuery <var>requête</var></syntax>
<contextlist><context>directory</context> <contextlist><context>directory</context>
</contextlist> </contextlist>
<usage> <usage>
<p>La directive <directive>AuthDBDUserPWQuery</directive> permet de <p>La directive <directive>AuthDBDUserPWQuery</directive> permet de
sp&eacute;cifier une requ&ecirc;te servant &agrave; v&eacute;rifier le mot de passe d'un spécifier une requête servant à vérifier le mot de passe d'un
utilisateur donn&eacute;. L'identifiant utilisateur sera transmis comme utilisateur donné. L'identifiant utilisateur sera transmis comme
param&egrave;tre sous forme d'une seule cha&icirc;ne de caract&egrave;res lorsque la paramètre sous forme d'une seule chaîne de caractères lorsque la
requ&ecirc;te sera ex&eacute;cut&eacute;e. Cet identifiant est r&eacute;f&eacute;renc&eacute; dans la requ&ecirc;te requête sera exécutée. Cet identifiant est référencé dans la requête
en utilisant le sp&eacute;cificateur de format <code>%s</code>.</p> en utilisant le spécificateur de format <code>%s</code>.</p>
<highlight language="config"> <highlight language="config">
AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s" AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"
</highlight> </highlight>
<p>La premi&egrave;re colonne du premier enregistrement renvoy&eacute; par la <p>La première colonne du premier enregistrement renvoyé par la
requ&ecirc;te se pr&eacute;sentera sous la forme d'une cha&icirc;ne de caract&egrave;res requête se présentera sous la forme d'une chaîne de caractères
contenant le mot de passe chiffr&eacute;. Les enregistrements suivants sont contenant le mot de passe chiffré. Les enregistrements suivants sont
ignor&eacute;s. Si aucun enregistrement n'est renvoy&eacute;, l'utilisateur ne ignorés. Si aucun enregistrement n'est renvoyé, l'utilisateur ne
sera pas authentifi&eacute; par <module>mod_authn_dbd</module>.</p> sera pas authentifié par <module>mod_authn_dbd</module>.</p>
<p>Si httpd a &eacute;t&eacute; compil&eacute; avec la version 1.3.0 ou sup&eacute;rieure de <p>Toute valeur de colonne supplémentaire
l'<glossary>APR</glossary>, toute valeur de colonne suppl&eacute;mentaire du premier enregistrement renvoyé par la requête sera stockée dans
du premier enregistrement renvoy&eacute; par la requ&ecirc;te sera stock&eacute;e dans
une variable d'environnement dont le nom aura la forme une variable d'environnement dont le nom aura la forme
<code>AUTHENTICATE_<var>valeur-colonne</var></code>. <code>AUTHENTICATE_<var>valeur-colonne</var></code>.
</p> </p>
<p>Le format du mot de passe chiffr&eacute; d&eacute;pend du frontal <p>Le format du mot de passe chiffré dépend du frontal
d'authentification utilis&eacute; (par exemple d'authentification utilisé (par exemple
<module>mod_auth_basic</module> ou <module>mod_auth_basic</module> ou
<module>mod_auth_digest</module>). Voir la documentation sur les <a <module>mod_auth_digest</module>). Voir la documentation sur les <a
href="../misc/password_encryptions.html">Formats de mots de passe</a> pour href="../misc/password_encryptions.html">Formats de mots de passe</a> pour
plus de d&eacute;tails.</p> plus de détails.</p>
</usage> </usage>
</directivesynopsis> </directivesynopsis>
<directivesynopsis> <directivesynopsis>
<name>AuthDBDUserRealmQuery</name> <name>AuthDBDUserRealmQuery</name>
<description>Requ&ecirc;te SQL servant &agrave; v&eacute;rifier une empreinte de mot de <description>Requête SQL servant à vérifier une empreinte de mot de
passe pour un utilisateur et un identifiant d'authentification. passe pour un utilisateur et un identifiant d'authentification.
</description> </description>
<syntax>AuthDBDUserRealmQuery <var>requ&ecirc;te</var></syntax> <syntax>AuthDBDUserRealmQuery <var>requête</var></syntax>
<contextlist><context>directory</context> <contextlist><context>directory</context>
</contextlist> </contextlist>
<usage> <usage>
<p>La directive <directive>AuthDBDUserRealmQuery</directive> sp&eacute;cifie <p>La directive <directive>AuthDBDUserRealmQuery</directive> spécifie
une requ&ecirc;te SQL servant &agrave; v&eacute;rifier une empreinte de mot une requête SQL servant à vérifier une empreinte de mot
de passe pour un utilisateur et un identifiant d'authentification de passe pour un utilisateur et un identifiant d'authentification
donn&eacute;s au cours d'un processus d'authentification digest. Les donnés au cours d'un processus d'authentification digest. Les
identifiants de l'utilisateur et de l'authentification identifiants de l'utilisateur et de l'authentification
sont pass&eacute;s dans cet ordre comme param&egrave;tres &agrave; l'ex&eacute;cution de la sont passés dans cet ordre comme paramètres à l'exécution de la
requ&ecirc;te. Ils sont r&eacute;f&eacute;renc&eacute;s dans la cha&icirc;ne de la requ&ecirc;te en requête. Ils sont référencés dans la chaîne de la requête en
utilisant des sp&eacute;cificateurs de format <code>%s</code>.</p> utilisant des spécificateurs de format <code>%s</code>.</p>
<highlight language="config"> <highlight language="config">
AuthDBDUserRealmQuery "SELECT password FROM authn WHERE user = %s AND realm = %s" AuthDBDUserRealmQuery "SELECT password FROM authn WHERE user = %s AND realm = %s"
</highlight> </highlight>
<p>La premi&egrave;re colonne du premier enregistrement renvoy&eacute; par la <p>La première colonne du premier enregistrement renvoyé par la
requ&ecirc;te se pr&eacute;sentera sous la forme d'une cha&icirc;ne de caract&egrave;res requête se présentera sous la forme d'une chaîne de caractères
contenant le mot de passe chiffr&eacute;. Les enregistrements suivants contenant le mot de passe chiffré. Les enregistrements suivants
seront ignor&eacute;s. Si aucun enregistrement n'est renvoy&eacute;, l'utilisateur seront ignorés. Si aucun enregistrement n'est renvoyé, l'utilisateur
ne sera pas authentifi&eacute; par <module>mod_authn_dbd</module>.</p> ne sera pas authentifié par <module>mod_authn_dbd</module>.</p>
<p>Si httpd a &eacute;t&eacute; compil&eacute; avec une version 1.3.0 ou sup&eacute;rieure de <p>Toute valeur de colonne supplémentaire
l'<glossary>APR</glossary>, toute valeur de colonne suppl&eacute;mentaire du premier enregistrement renvoyé par la requête sera stockée dans
du premier enregistrement renvoy&eacute; par la requ&ecirc;te sera stock&eacute;e dans
une variable d'environnement avec un nom de la forme une variable d'environnement avec un nom de la forme
<code>AUTHENTICATE_<var>COLONNE</var></code>. <code>AUTHENTICATE_<var>COLONNE</var></code>.
</p> </p>
<p>Le format du mot de passe chiffr&eacute; d&eacute;pend du frontal <p>Le format du mot de passe chiffré dépend du frontal
d'authentification utilis&eacute; (par exemple d'authentification utilisé (par exemple
<module>mod_auth_basic</module> ou <module>mod_auth_basic</module> ou
<module>mod_auth_digest</module>). Voir la documentation sur les <a <module>mod_auth_digest</module>). Voir la documentation sur les <a
href="../misc/password_encryptions.html">Formats de mots de passe</a> pour href="../misc/password_encryptions.html">Formats de mots de passe</a> pour
plus de d&eacute;tails.</p> plus de détails.</p>
</usage> </usage>
</directivesynopsis> </directivesynopsis>

3
docs/manual/mod/mod_log_config.xml.fr
View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1818830 --> <!-- English Revision: 1900557 -->
<!-- French translation : Lucien GENTIS --> <!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines --> <!-- Reviewed by : Vincent Deffontaines -->
@ -205,7 +205,6 @@ d'Apache</a></seealso>
<td>Le numéro de processus ou le numéro de thread du processus <td>Le numéro de processus ou le numéro de thread du processus
enfant qui a servi la requête. Les formats valides sont enfant qui a servi la requête. Les formats valides sont
<code>pid</code>, <code>tid</code>, et <code>hextid</code>. <code>pid</code>, <code>tid</code>, et <code>hextid</code>.
<code>hextid</code> nécessite APR version 1.2.0 ou supérieure.
</td></tr> </td></tr>
<tr><td><code>%q</code></td> <tr><td><code>%q</code></td>