mirror of
https://github.com/apache/httpd.git
synced 2025-07-29 09:01:18 +03:00
3370f733e0
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1818608 13f79535-47bb-0310-9956-ffa450edef68
758 lines
30 KiB
Plaintext
758 lines
30 KiB
Plaintext
<?xml version="1.0"?>
|
|
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
|
<!-- English Revision : 1673945 -->
|
|
<!-- French translation : Lucien GENTIS -->
|
|
<!-- $LastChangedRevision: 2015050201 $ -->
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<modulesynopsis metafile="mod_policy.xml.meta">
|
|
|
|
<name>mod_policy</name>
|
|
<description>Mise en conformité avec le protocole HTTP.</description>
|
|
<status>Extension</status>
|
|
<sourcefile>mod_policy.c</sourcefile>
|
|
<identifier>policy_module</identifier>
|
|
|
|
<summary>
|
|
<p>Le protocole HTTP recommande aux clients d'être "indulgents pour
|
|
ce qu'ils doivent accepter", et aux serveurs d'être "stricts pour ce
|
|
qu'ils envoient". Dans certains cas, il peut s'avérer difficile de
|
|
déterminer si un serveur ou une application a été mal configuré,
|
|
sert un contenu qui ne peut pas être mis en cache ou se comporte de
|
|
manière non optimale, car le client HTTP est souvent en mesure de
|
|
compenser les défauts du serveur. Ces problèmes peuvent induire une
|
|
consommation de bande passante excessive, ou même une interruption
|
|
de service suite à une charge trop importante du serveur.</p>
|
|
|
|
<p>Le module <module>mod_policy</module> propose un jeu de filtres
|
|
qui permettent de tester la conformité du serveur au protocole HTTP.
|
|
Ces tests permettent à l'administrateur du serveur de journaliser
|
|
les violations, ou même de rejeter une réponse losque certaines
|
|
conditions spécifiées se réalisent.</p>
|
|
|
|
<p>Il devient ainsi possible de définir des critères de conformité
|
|
minimale au protocole HTTP pour développer des applications
|
|
sans problème. En outre, il est possible de configurer un
|
|
mandataire inverse ou un cache pour qu'il se protège lui-même contre
|
|
les serveurs d'origine mal configurés ou les contenus indument
|
|
impossible à être mis en cache, ou un mécanisme qui détecte les
|
|
erreurs de configuration au sein du serveur lui-même.</p>
|
|
|
|
</summary>
|
|
<seealso><a href="../filter.html">Les filtres</a></seealso>
|
|
<seealso><a href="../compliance.html">Conformité au protocole HTTP</a></seealso>
|
|
|
|
<section id="actions">
|
|
<title>Actions</title>
|
|
|
|
<p>Si une règle est violée, il possible d'effectuer les actions
|
|
suivantes :</p>
|
|
|
|
<dl>
|
|
<dt><strong>ignore</strong></dt>
|
|
<dd>La vérification de la politique de conformité sera désactivée
|
|
pour l'espace d'URL spécifié, même si le filtre est présent.</dd>
|
|
|
|
<dt><strong>log</strong></dt>
|
|
<dd>La vérification de la politique de conformité sera exécutée, et
|
|
si une violation est détectée, un avertissement sera enregistré dans
|
|
le journal error_log du serveur, et un en-tête <code>Warning</code>
|
|
ajouté à la réponse en tant qu'information à destination du client.</dd>
|
|
|
|
<dt><strong>enforce</strong></dt>
|
|
<dd>La vérification de la politique de conformité sera exécutée,
|
|
|
|
The policy check will be executed, and if a violation is detected
|
|
an error will be logged to the server error_log, a
|
|
<code>Warning</code> header added to the response, and a <code>502
|
|
Bad Gateway</code> will be returned to the client. Optional links to
|
|
explanatory documentation can be added to each error message,
|
|
detailing the origin of each policy.</dd>
|
|
|
|
</dl>
|
|
|
|
<p>Il est aussi possible de désactiver toutes les règles pour un
|
|
espace d'URL donné, si le besoin s'en fait sentir, via la directive
|
|
<directive module="mod_policy">PolicyFilter</directive>.</p>
|
|
|
|
<p>En outre, la directive <directive
|
|
module="mod_policy">PolicyEnvironment</directive> permet de
|
|
spécifier une variable d'environnement qui, si elle est définie, va
|
|
court-circuiter les règles ou diminuer leur portée.</p>
|
|
|
|
</section>
|
|
|
|
<section id="tests">
|
|
<title>Tests de la politique de filtrage</title>
|
|
|
|
<p>Les filtres suivants sont disponibles :</p>
|
|
|
|
<dl>
|
|
<dt><strong><a href="../compliance.html#policytype">POLICY_TYPE</a>
|
|
</strong>: Impose la validité des types de contenus</dt>
|
|
<dd>La requête peut être rejetée suite à la présence de types de contenus vides
|
|
ou syntaxiquement invalides. Les types peuvent aussi être restreints
|
|
à une liste pouvant contenir des caractères génériques ? et *.</dd>
|
|
|
|
<dt><strong><a href="../compliance.html#policylength">POLICY_LENGTH</a>
|
|
</strong>: Impose la présence de l'en-tête Content-Length</dt>
|
|
<dd>La longueur des réponses peut être spécifiée de trois manières
|
|
différentes : en spécifiant à l'avance une longueur explicite, en
|
|
utilisant un codage de morcellement (chunking) pour définir la
|
|
longueur, ou en ne spécifiant aucune longueur et en terminant la
|
|
requête lorsque son traitement est achevé. L'absence de
|
|
spécification d'une longueur de contenu peut affecter la possibilité
|
|
de mise en cache de la réponse, et empêcher l'utilisation de la
|
|
persistance avec les requêtes de type HTTP/1.0. Ce filtre impose la
|
|
présence d'une longueur de contenu explicite dans la réponse.</dd>
|
|
|
|
<dt><strong><a href="../compliance.html#policykeepalive">POLICY_KEEPALIVE
|
|
</a></strong>: Impose l'option de persistance</dt>
|
|
<dd>Moins restrictif que le filtre POLICY_LENGTH, ce filtre impose
|
|
la possibilité de persistance de la réponse. Si la réponse n'a pas
|
|
de longueur définie à 0 par le protocole, si elle n'est pas une
|
|
erreur, et si elle ne contient pas d'en-tête Content-Length ou si
|
|
elle est de type HTTP/1.1 et ne contient pas l'en-tête
|
|
Content-Encoding: chunked, alors elle sera rejetée.</dd>
|
|
|
|
<dt><strong><a href="../compliance.html#policyvary">POLICY_VARY</a>
|
|
</strong>: Interdit la présence de certains en-têtes au sein des
|
|
en-têtes Vary</dt>
|
|
<dd>Si l'en-tête Vary contient un des en-têtes spécifiés, ce filtre
|
|
va rejeter la requête. Un cas typique est la présence de l'en-tête
|
|
User-Agent dans l'en-tête Vary, ce qui peut être à l'origine d'une
|
|
condition de déni de service au niveau du cache.</dd>
|
|
|
|
<dt><strong><a href="../compliance.html#policyvalidation">
|
|
POLICY_VALIDATION</a></strong>: Impose la présence d'un en-tête Etag
|
|
et/ou Last-Modified</dt>
|
|
<dd>La possibilité pour un cache de déterminer si une entité qu'il
|
|
contient peut être rafraîchie dépend de la présence d'un en-tête
|
|
Etag et/ou Last-Modified pour vérifier si elle est valide. La requête sera
|
|
rejetée en cas d'absence de ces deux en-têtes, ou d'une syntaxe
|
|
invalide d'un de ces deux en-têtes.</dd>
|
|
|
|
<dt><strong><a href="../compliance.html#policyconditional">
|
|
POLICY_CONDITIONAL</a></strong>: Impose un traitement conforme des
|
|
en-têtes conditionnels</dt>
|
|
<dd>Lorsqu'une requête contient des en-têtes conditonnels, un
|
|
serveur doit répondre dans certaines conditions avec un code
|
|
<code>304 Not Modified</code> ou <code>412 Precondition
|
|
Failed</code>. Il arrive q'un serveur ignore les en-têtes
|
|
conditionnels, et cela diminue l'efficacité du mécanisme de mise en
|
|
cache HTTP. Ce filtre rejète les requêtes lorsqu'un en-tête
|
|
conditionnel était présent, et une réponse 2xx a été renvoyée au
|
|
lieu de la réponse 304 ou 412 attendue.</dd>
|
|
|
|
<dt><strong><a href="../compliance.html#policynocache">POLICY_NOCACHE</a>
|
|
</strong>: Impose la possibilité de mise en cache des réponses</dt>
|
|
<dd>Lorsqu'une requête se déclare elle-même impossible à mettre en
|
|
cache, elle est rejetée. C'est le cas si elle contient l'un des
|
|
en-têtes suivants :
|
|
<ul><li><code>Cache-Control: no-cache</code></li>
|
|
<li><code>Pragma: no-cache</code></li>
|
|
<li><code>Cache-Control: no-store</code></li>
|
|
<li><code>Cache-Control: private</code></li>
|
|
</ul></dd>
|
|
|
|
<dt><strong><a href="../compliance.html#policymaxage">POLICY_MAXAGE</a>
|
|
</strong>: Impose une durée de vie minimale</dt>
|
|
<dd>Lorsqu'une réponse possède une durée de vie inférieure à la
|
|
valeur spécifiée, ou si cette durée de vie est heuristique, la
|
|
requête est rejetée. La chronologie de la vérification d'une réponse
|
|
est la suivante :
|
|
<ul><li>Si <code>s-maxage</code> est présent mais d'une valeur trop
|
|
faible; ou</li>
|
|
<li>Si <code>max-age</code> est présent mais d'une valeur trop
|
|
faible; ou</li>
|
|
<li>Si <code>Expires</code> est présent et invalide; ou</li>
|
|
<li><code>Date</code> est présent et invalide; ou</li>
|
|
<li><code>Expires</code> moins Date est trop faible ; ou</li>
|
|
<li>Aucun en-tête <code>s-maxage</code>, <code>maxage</code>, ou
|
|
<code>Expires</code>/<code>Date</code> n'est présent</li>
|
|
</ul></dd>
|
|
|
|
<dt><strong><a href="../compliance.html#policyversion">POLICY_VERSION</a>
|
|
</strong>: Impose une version HTTP minimale dans la requête</dt>
|
|
<dd>Lorsqu'une requête possède un numéro de version HTTP inférieur
|
|
au numéro de version minimum requis, la requête est rejetée. Les
|
|
numéros de version suivants sont reconnus :
|
|
<ul><li><code>HTTP/1.1</code></li>
|
|
<li><code>HTTP/1.0</code></li>
|
|
<li><code>HTTP/0.9</code></li>
|
|
</ul></dd>
|
|
|
|
</dl>
|
|
|
|
</section>
|
|
|
|
<section id="example">
|
|
<title>Exemple de configuration</title>
|
|
|
|
<p>Voici un exemple de configuration qui protège un serveur qui
|
|
délivre du contenu statique :</p>
|
|
|
|
<highlight language="config">
|
|
<Location "/">
|
|
SetOutputFilter POLICY_TYPE;POLICY_LENGTH;POLICY_KEEPALIVE;POLICY_VARY;POLICY_VALIDATION; \
|
|
POLICY_CONDITIONAL;POLICY_NOCACHE;POLICY_MAXAGE;POLICY_VERSION
|
|
|
|
# le contenu peut être quelconque, mais l'en-tête Content-Type doit être
|
|
# présent et valide
|
|
PolicyType enforce */*
|
|
|
|
# rejet si aucune longueur de contenu déclarée
|
|
PolicyLength enforce
|
|
|
|
# pris en charge par le filtre policy length
|
|
PolicyKeepalive ignore
|
|
|
|
# rejet si l'en-tête User-Agent aparaît dans les en-têtes Vary
|
|
PolicyVary enforce User-Agent
|
|
|
|
# la validation est imposée
|
|
PolicyValidation enforce
|
|
|
|
# les réponses conditionnelles non conformes sont rejetées
|
|
PolicyConditional enforce
|
|
|
|
# les réponses impossibles à mettre en cache sont rejetées
|
|
PolicyNocache enforce
|
|
|
|
# la durée de vie doit être au moins d'un jour
|
|
PolicyMaxage enforce 86400
|
|
|
|
# le numéro de version de la requête peut être quelconque
|
|
PolicyVersion ignore HTTP/1.1
|
|
</Location>
|
|
|
|
# désactivation du filtrage pour le répertoire /server-status
|
|
<Location "/server-status">
|
|
PolicyFilter off
|
|
</Location>
|
|
</highlight>
|
|
|
|
</section>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyFilter</name>
|
|
<description>Active ou désactive le filtrage pour un espace d'URL donné.</description>
|
|
<syntax>PolicyFilter <var>on|off</var></syntax>
|
|
<default>on</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Commutateur principal qui permet d'activer ou de désactiver le
|
|
filtrage pour un espace d'URL donné.</p>
|
|
|
|
<example><title>Example</title>
|
|
<highlight language="config">
|
|
# activé par défaut
|
|
<Location "/">
|
|
PolicyFilter on
|
|
</Location>
|
|
|
|
# désactivation du filtrage pour le répertoire /server-status
|
|
<Location "/server-status">
|
|
PolicyFilter off
|
|
</Location>
|
|
</highlight>
|
|
</example>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyEnvironment</name>
|
|
<description>Modification des règles de filtrage en fonction d'une
|
|
variable d'environnement.</description>
|
|
<syntax>PolicyEnvironment <var>variable</var> <var>log-value</var> <var>ignore-value</var></syntax>
|
|
<default>none</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Limite l'action des règles à la journalisation ou les désactive
|
|
totalement en fonction de la présence d'une variable d'environnement. Si
|
|
la variable spécifiée est présente et égale à la valeur de
|
|
l'argument log-value, les erreurs rencontrées par les filtres ne
|
|
seront que journalisées. Si la variable spécifiée est présente et
|
|
égale à la valeur de l'argument ignore-value, toutes les règles
|
|
seront ignorées.</p>
|
|
|
|
<example><title>Example</title>
|
|
<highlight language="config">
|
|
# limitation de l'action des règles si la variable POLICY_CONTROL
|
|
# est présente
|
|
PolicyEnvironment POLICY_CONTROL log ignore
|
|
</highlight>
|
|
</example>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyConditional</name>
|
|
<description>Active le filtrage des requêtes conditionnelles.</description>
|
|
<syntax>PolicyConditional <var>ignore|log|enforce</var></syntax>
|
|
<default>ignore</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Avec l'argument enforce, une réponse qui aurait du être
|
|
conditionnelle mais ne l'est pas sera rejetée.</p>
|
|
|
|
<example><title>Exemple</title>
|
|
<highlight language="config">
|
|
# les réponses conditionnelles non conformes doivent être rejetées
|
|
PolicyConditional enforce
|
|
</highlight>
|
|
</example>
|
|
|
|
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyConditionalURL</name>
|
|
<description>URL contenant la description de la politique de filtrage
|
|
des requêtes conditionnelles.</description>
|
|
<syntax>PolicyConditionalURL <var>url</var></syntax>
|
|
<default>none</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Cette directive permet de spécifier l'URL de la documentation
|
|
décrivant la politique de filtrage des requêtes conditionnelles ;
|
|
elle apparaîtra dans les messages d'erreur.</p>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyLength</name>
|
|
<description>Active le filtrage de la spécification de la longueur du
|
|
contenu.</description>
|
|
<syntax>PolicyLength <var>ignore|log|enforce</var></syntax>
|
|
<default>ignore</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Avec l'argument enforce, une réponse qui ne contient pas
|
|
d'en-tête <code>Content-Length</code> sera rejetée.</p>
|
|
|
|
<example><title>Exemple</title>
|
|
<highlight language="config">
|
|
# rejet suite à l'absence de l'en-tête Content-Length
|
|
PolicyLength enforce
|
|
</highlight>
|
|
</example>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyLengthURL</name>
|
|
<description>URL contenant la description de la politique de filtrage de
|
|
la spécification de la longueur du contenu.</description>
|
|
<syntax>PolicyLengthURL <var>url</var></syntax>
|
|
<default>none</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Cette directive permet de spécifier l'URL contenant la
|
|
documentation décrivant la politique de filtrage de la spécification
|
|
de la longueur du contenu ; elle apparaîtra dans les messages
|
|
d'erreur.</p>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyKeepalive</name>
|
|
<description>Active la politique de persistance.</description>
|
|
<syntax>PolicyKeepalive <var>ignore|log|enforce</var></syntax>
|
|
<default>ignore</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Avec l'argument enforce, une réponse qui ne contient ni en-tête
|
|
<code>Content-Length</code>, ni en-tête
|
|
<code>Transfer-Encoding</code> de valeur <code>chunked</code> sera
|
|
rejetée.</p>
|
|
|
|
<example><title>Exemple</title>
|
|
<highlight language="config">
|
|
# rejet suite a absence d'en-tête Content-Length ou Transfer-Encoding
|
|
PolicyKeepalive enforce
|
|
</highlight>
|
|
</example>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyKeepaliveURL</name>
|
|
<description>URL contenant la description de la politique de persistance.</description>
|
|
<syntax>PolicyKeepaliveURL <var>url</var></syntax>
|
|
<default>none</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Cette directive permet de spécifier l'URL contenant la
|
|
description de la politique de persistance ; elle apparaîtra dans
|
|
les messages d'erreur.</p>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyType</name>
|
|
<description>Active la politique des types de contenus.</description>
|
|
<syntax>PolicyType <var>ignore|log|enforce</var> <var>type</var> [ <var>type</var> [ ... ]]</syntax>
|
|
<default>ignore</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Avec l'argument enforce, une réponse qui ne contient pas
|
|
d'en-tête <code>Content-Type</code>, ou dont l'en-tête
|
|
<code>Content-Type</code> est mal formé, ou dont l'en-tête
|
|
<code>Content-Type</code> contient une valeur qui ne correspond pas
|
|
au(x) modèle(s) spécifié(s) sera rejetée.</p>
|
|
|
|
<example><title>Exemple</title>
|
|
<highlight language="config">
|
|
# impose le type de contenu json ou XML
|
|
PolicyType enforce application/json text/xml
|
|
</highlight>
|
|
</example>
|
|
|
|
<example><title>Exemple</title>
|
|
<highlight language="config">
|
|
# rejet suite à type de contenu mal formé
|
|
PolicyType enforce */*
|
|
</highlight>
|
|
</example>
|
|
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyTypeURL</name>
|
|
<description>URL contenant la description de la politique des types de
|
|
contenu.</description>
|
|
<syntax>PolicyTypeURL <var>url</var></syntax>
|
|
<default>none</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Cette directive permet de spécifier l'URL contenant la
|
|
description de la politique des types de contenu ; elle apparaîtra
|
|
dans les messages d'erreur.</p>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyVary</name>
|
|
<description>Active la politique de filtrage de l'en-tête Vary.</description>
|
|
<syntax>PolicyVary <var>ignore|log|enforce</var> <var>header</var> [ <var>header</var> [ ... ]]</syntax>
|
|
<default>ignore</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Avec l'argument enforce, une réponse dont l'en-tête
|
|
<code>Vary</code> contient un des en-têtes spécifiés sera rejetée.</p>
|
|
|
|
<example><title>Exemple</title>
|
|
<highlight language="config">
|
|
# rejet suite à la présence de l'en-tête "User-Agent" dans l'en-tête
|
|
# Vary
|
|
PolicyVary enforce User-Agent
|
|
</highlight>
|
|
</example>
|
|
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyVaryURL</name>
|
|
<description>URL contenant la description de la politique de filtrage de
|
|
l'en-tête Vary.</description>
|
|
<syntax>PolicyVaryURL <var>url</var></syntax>
|
|
<default>none</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Cette directive permet de spécifier l'URL contenant la
|
|
description de la politique de filtrage de l'en-tête Vary ; elle
|
|
apparaîtra dans les messages d'erreur.</p>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyValidation</name>
|
|
<description>Active le filtrage de la validation du contenu.</description>
|
|
<syntax>PolicyValidation <var>ignore|log|enforce</var></syntax>
|
|
<default>ignore</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Avec l'argument enforce, une réponse qui ne contient ni en-tête
|
|
<code>ETag</code> valide, ni en-tête <code>Last-Modified</code>, ou
|
|
dont la syntaxe d'un de ces deux en-têtes est incorrecte sera
|
|
rejetée.</p>
|
|
|
|
<example><title>Exemple</title>
|
|
<highlight language="config">
|
|
# rejet suite à l'absence des en-têtes Etag et/ou Last-Modified
|
|
PolicyValidation enforce
|
|
</highlight>
|
|
</example>
|
|
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyValidationURL</name>
|
|
<description>URL contenant la description de la politique de filtrage de
|
|
la validation du contenu.</description>
|
|
<syntax>PolicyValidationURL <var>url</var></syntax>
|
|
<default>none</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Cette directive permet de spécifier l'URL contenant la
|
|
description de la politique de filtrage de la validation du contenu
|
|
; elle apparaîtra dans les messages d'erreur.</p>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyNocache</name>
|
|
<description>Active le filtrage des réponses qui se définissent
|
|
elles-mêmes comme impossibles à mettre en cache.</description>
|
|
<syntax>PolicyNocache <var>ignore|log|enforce</var></syntax>
|
|
<default>ignore</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Avec l'argument enforce, une réponse qui se définit elle-même
|
|
comme impossible à mettre en cache via l'en-tête
|
|
<code>Cache-Control</code> ou <code>Pragma</code> sera rejetée.</p>
|
|
|
|
<example><title>Exemple</title>
|
|
<highlight language="config">
|
|
# une réponse contenant l'en-tête Cache-Control: no-cache sera
|
|
# rejetée
|
|
PolicyNocache enforce
|
|
</highlight>
|
|
</example>
|
|
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyNocacheURL</name>
|
|
<description>URL contenant la description de la politique de filtrage
|
|
des réponses qui se définissent elles-mêmes comme impossibles à mettre
|
|
en cache.</description>
|
|
<syntax>PolicyNocacheURL <var>url</var></syntax>
|
|
<default>none</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Cette directive permet de spécifier l'URL contenant la
|
|
description de la politique de filtrage des réponses qui se
|
|
définissent elles-mêmes comme impossibles à mettre en cache ; elle
|
|
apparaîtra dans les messages d'erreur.</p>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyMaxage</name>
|
|
<description>Active le filtrage de la durée de vie des réponses.</description>
|
|
<syntax>PolicyMaxage <var>ignore|log|enforce</var> <var>age</var></syntax>
|
|
<default>ignore</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Avec l'argument enforce, une réponse dont la durée de vie n'est
|
|
pas explicitement spécifiée via un en-tête <code>max-age</code>,
|
|
<code>s-maxage</code> ou <code>Expires</code>, ou dont la durée de
|
|
vie est inférieure à la valeur donnée sera rejetée.</p>
|
|
|
|
<example><title>Exemple</title>
|
|
<highlight language="config">
|
|
# rejet des réponses dont la durée de vie est inférieure à une
|
|
# journée
|
|
PolicyMaxage enforce 86400
|
|
</highlight>
|
|
</example>
|
|
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyMaxageURL</name>
|
|
<description>URL contenant la description de la politique de filtrage
|
|
des réponses en fonction de leur durée de vie.</description>
|
|
<syntax>PolicyMaxageURL <var>url</var></syntax>
|
|
<default>none</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Cette directive permet de spécifier l'URL contenant la
|
|
description de la politique de filtrage des réponses en fonction de
|
|
leur durée de vie ; elle apparaîtra dans les messages d'erreur.</p>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyVersion</name>
|
|
<description>Active le filtrage des requêtes en fonction du numéro de
|
|
version HTTP.</description>
|
|
<syntax>PolicyVersion <var>ignore|log|enforce</var> <var>HTTP/0.9|HTTP/1.0|HTTP/1.1</var></syntax>
|
|
<default>ignore</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Avec l'argument enforce, une requête dont le numéro de version
|
|
HTTP est inférieur à la valeur spécifiée sera rejetée.</p>
|
|
|
|
<example><title>Exemple</title>
|
|
<highlight language="config">
|
|
# rejet des requêtes dont le numéro de version HTTP est inférieur à
|
|
# HTTP/1.1
|
|
PolicyVersion enforce HTTP/1.1
|
|
</highlight>
|
|
</example>
|
|
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>PolicyVersionURL</name>
|
|
<description>URL contenant la description de la politique de filtrage
|
|
des requêtes en fonction du numéro de version HTTP.</description>
|
|
<syntax>PolicyVersionURL <var>url</var></syntax>
|
|
<default>none</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context></contextlist>
|
|
<compatibility>Disponible à partir de la version 2.5.0 du serveur HTTP
|
|
Apache.</compatibility>
|
|
|
|
<usage>
|
|
<p>Cette directive permet de spécifier l'URL contenant la
|
|
description de la politique de filtrage des requêtes en fonction du
|
|
numéro de version HTTP ; elle apparaîtra dans les messages d'erreur.</p>
|
|
</usage>
|
|
|
|
</directivesynopsis>
|
|
|
|
</modulesynopsis>
|