From d66fc7154abbb970a6cb89e93c2069f386d190ea Mon Sep 17 00:00:00 2001 From: Jim Jagielski Date: Thu, 13 Apr 2017 12:26:37 +0000 Subject: [PATCH] Xforms git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1791237 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/convenience.map | 10 +- docs/manual/custom-error.html.es | 108 +- docs/manual/filter.html.es | 120 +- docs/manual/glossary.html.es | 344 ++-- docs/manual/handler.html.es | 94 +- docs/manual/howto/access.html.en | 2 + docs/manual/howto/access.html.es | 424 ++--- docs/manual/howto/auth.html.en | 2 + docs/manual/howto/auth.html.es | 1378 ++++++++--------- docs/manual/howto/auth.html.ja.utf8 | 2 + docs/manual/howto/auth.html.ko.euc-kr | 2 + docs/manual/howto/auth.html.tr.utf8 | 2 + docs/manual/howto/cgi.html.en | 2 + docs/manual/howto/cgi.html.es | 1182 +++++++------- docs/manual/howto/cgi.html.ja.utf8 | 2 + docs/manual/howto/cgi.html.ko.euc-kr | 2 + docs/manual/howto/htaccess.html.en | 2 + docs/manual/howto/htaccess.html.es | 880 +++++------ docs/manual/howto/htaccess.html.ja.utf8 | 2 + docs/manual/howto/htaccess.html.ko.euc-kr | 2 + docs/manual/howto/htaccess.html.pt-br | 2 + docs/manual/howto/http2.html.en | 2 + docs/manual/howto/http2.html.es | 518 +++---- docs/manual/howto/index.html.en | 2 + docs/manual/howto/index.html.es | 310 ++-- docs/manual/howto/index.html.ja.utf8 | 2 + docs/manual/howto/index.html.ko.euc-kr | 2 + docs/manual/howto/index.html.zh-cn.utf8 | 2 + docs/manual/howto/public_html.html.en | 2 + docs/manual/howto/public_html.html.es | 384 ++--- docs/manual/howto/public_html.html.ja.utf8 | 2 + docs/manual/howto/public_html.html.ko.euc-kr | 2 + docs/manual/howto/public_html.html.tr.utf8 | 2 + docs/manual/index.html.es | 76 +- docs/manual/install.html.es | 326 ++-- docs/manual/invoking.html.es | 128 +- docs/manual/mod/allmodules.xml | 1 + docs/manual/mod/allmodules.xml.de | 1 + docs/manual/mod/allmodules.xml.es | 1 + docs/manual/mod/allmodules.xml.fr | 1 + docs/manual/mod/allmodules.xml.ja | 1 + docs/manual/mod/allmodules.xml.ko | 1 + docs/manual/mod/allmodules.xml.tr | 1 + docs/manual/mod/allmodules.xml.zh-cn | 1 + docs/manual/mod/directive-dict.html.en | 2 + docs/manual/mod/directive-dict.html.es | 580 +++---- docs/manual/mod/directive-dict.html.ja.utf8 | 2 + docs/manual/mod/directive-dict.html.ko.euc-kr | 2 + docs/manual/mod/directive-dict.html.tr.utf8 | 2 + docs/manual/mod/directives.html.de | 8 +- docs/manual/mod/directives.html.en | 8 +- docs/manual/mod/directives.html.es | 41 +- docs/manual/mod/directives.html.fr | 5 + docs/manual/mod/directives.html.ja.utf8 | 8 +- docs/manual/mod/directives.html.ko.euc-kr | 8 +- docs/manual/mod/directives.html.tr.utf8 | 8 +- docs/manual/mod/directives.html.zh-cn.utf8 | 8 +- docs/manual/mod/index.html.de | 4 +- docs/manual/mod/index.html.en | 4 +- docs/manual/mod/index.html.es | 54 +- docs/manual/mod/index.html.fr | 4 +- docs/manual/mod/index.html.ja.utf8 | 4 +- docs/manual/mod/index.html.ko.euc-kr | 4 +- docs/manual/mod/index.html.tr.utf8 | 4 +- docs/manual/mod/index.html.zh-cn.utf8 | 4 +- docs/manual/mod/mod_autoindex.html.en | 8 + docs/manual/mod/mod_autoindex.html.tr.utf8 | 1 + docs/manual/mod/mod_brotli.html | 5 + docs/manual/mod/mod_brotli.html.en | 347 +++++ docs/manual/mod/mod_brotli.xml.meta | 12 + docs/manual/mod/mod_http2.html.en | 47 - docs/manual/mod/mod_ssl.html.en | 34 + docs/manual/mod/quickreference.html.de | 324 ++-- docs/manual/mod/quickreference.html.en | 324 ++-- docs/manual/mod/quickreference.html.es | 1241 +++++++-------- docs/manual/mod/quickreference.html.fr | 1237 +++++++-------- docs/manual/mod/quickreference.html.ja.utf8 | 324 ++-- docs/manual/mod/quickreference.html.ko.euc-kr | 324 ++-- docs/manual/mod/quickreference.html.tr.utf8 | 324 ++-- .../manual/mod/quickreference.html.zh-cn.utf8 | 324 ++-- docs/manual/platform/win_compiling.html.en | 9 + docs/manual/platform/win_compiling.html.fr | 2 + docs/manual/platform/win_compiling.xml.fr | 2 +- docs/manual/platform/win_compiling.xml.ko | 2 +- docs/manual/platform/win_compiling.xml.meta | 2 +- docs/manual/sitemap.html.de | 1 + docs/manual/sitemap.html.en | 1 + docs/manual/sitemap.html.es | 391 ++--- docs/manual/sitemap.html.fr | 1 + docs/manual/sitemap.html.ja.utf8 | 1 + docs/manual/sitemap.html.ko.euc-kr | 1 + docs/manual/sitemap.html.tr.utf8 | 1 + docs/manual/sitemap.html.zh-cn.utf8 | 1 + 93 files changed, 6472 insertions(+), 5915 deletions(-) create mode 100644 docs/manual/mod/mod_brotli.html create mode 100644 docs/manual/mod/mod_brotli.html.en create mode 100644 docs/manual/mod/mod_brotli.xml.meta diff --git a/docs/manual/convenience.map b/docs/manual/convenience.map index 5dc5b09e81..d854a7dc3a 100644 --- a/docs/manual/convenience.map +++ b/docs/manual/convenience.map @@ -113,6 +113,11 @@ balancergrowth mod/mod_proxy.html#balancergrowth balancerinherit mod/mod_proxy.html#balancerinherit balancermember mod/mod_proxy.html#balancermember balancerpersist mod/mod_proxy.html#balancerpersist +brotlialteretag mod/mod_brotli.html#brotlialteretag +brotlicompressionmaxinputblock mod/mod_brotli.html#brotlicompressionmaxinputblock +brotlicompressionquality mod/mod_brotli.html#brotlicompressionquality +brotlicompressionwindow mod/mod_brotli.html#brotlicompressionwindow +brotlifilternote mod/mod_brotli.html#brotlifilternote browsermatch mod/mod_setenvif.html#browsermatch browsermatchnocase mod/mod_setenvif.html#browsermatchnocase bufferedlogs mod/mod_log_config.html#bufferedlogs @@ -255,7 +260,6 @@ h2pushdiarysize mod/mod_http2.html#h2pushdiarysize h2pushpriority mod/mod_http2.html#h2pushpriority h2pushresource mod/mod_http2.html#h2pushresource h2serializeheaders mod/mod_http2.html#h2serializeheaders -h2sessionextrafiles mod/mod_http2.html#h2sessionextrafiles h2streammaxmemsize mod/mod_http2.html#h2streammaxmemsize h2tlscooldownsecs mod/mod_http2.html#h2tlscooldownsecs h2tlswarmupsize mod/mod_http2.html#h2tlswarmupsize @@ -402,6 +406,8 @@ proxyerroroverride mod/mod_proxy.html#proxyerroroverride proxyexpressdbmfile mod/mod_proxy_express.html#proxyexpressdbmfile proxyexpressdbmtype mod/mod_proxy_express.html#proxyexpressdbmtype proxyexpressenable mod/mod_proxy_express.html#proxyexpressenable +proxyfcgibackendtype mod/mod_proxy_fcgi.html#proxyfcgibackendtype +proxyfcgisetenvif mod/mod_proxy_fcgi.html#proxyfcgisetenvif proxyftpdircharset mod/mod_proxy_ftp.html#proxyftpdircharset proxyftpescapewildcards mod/mod_proxy_ftp.html#proxyftpescapewildcards proxyftplistonwildcard mod/mod_proxy_ftp.html#proxyftplistonwildcard @@ -555,8 +561,10 @@ sslhonorcipherorder mod/mod_ssl.html#sslhonorcipherorder sslinsecurerenegotiation mod/mod_ssl.html#sslinsecurerenegotiation sslocspdefaultresponder mod/mod_ssl.html#sslocspdefaultresponder sslocspenable mod/mod_ssl.html#sslocspenable +sslocspnoverify mod/mod_ssl.html#sslocspnoverify sslocspoverrideresponder mod/mod_ssl.html#sslocspoverrideresponder sslocspproxyurl mod/mod_ssl.html#sslocspproxyurl +sslocsprespondercertificatefile mod/mod_ssl.html#sslocsprespondercertificatefile sslocsprespondertimeout mod/mod_ssl.html#sslocsprespondertimeout sslocspresponsemaxage mod/mod_ssl.html#sslocspresponsemaxage sslocspresponsetimeskew mod/mod_ssl.html#sslocspresponsetimeskew diff --git a/docs/manual/custom-error.html.es b/docs/manual/custom-error.html.es index fc3109b5a9..dd2794c5c7 100644 --- a/docs/manual/custom-error.html.es +++ b/docs/manual/custom-error.html.es @@ -7,7 +7,7 @@ This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> -Respuestas de error personalizadas - Servidor Apache HTTP Versión 2.4 +Respuestas de error personalizadas - Servidor Apache HTTP Versión 2.4 @@ -16,19 +16,19 @@
-

Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

-

Versión 2.4 del Servidor HTTP Apache

+

Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

+

Versión 2.4 del Servidor HTTP Apache

<-
-Apache > Servidor HTTP > Documentación > Versión 2.4

Respuestas de error personalizadas

+Apache > Servidor HTTP > Documentación > Versión 2.4

Respuestas de error personalizadas

Idiomas disponibles:  en  | - es  | - fr  | + es  | + fr  |  ja  |  ko  | - tr 

+ tr 

Apache ofrece la posibilidad de que los webmasters puedan @@ -40,13 +40,13 @@

Si un script termina de forma anormal y se produce una respuesta "500 Server Error", esta respuesta puede ser sustituida por otro - texto de su elección o por una redirección a otra URL + texto de su elección o por una redirección a otra URL (local o externa).

+

Consulte también

top

Comportamiento

@@ -55,10 +55,10 @@

Comportamiento anterior

-

NCSA httpd 1.3 devolvía mensajes antiguos del error o - problema encontrado que con frecuencia no tenían - significado alguno para el usuario, y que no incluían en - los logs información que diera pistas sobre las causas de +

NCSA httpd 1.3 devolvía mensajes antiguos del error o + problema encontrado que con frecuencia no tenían + significado alguno para el usuario, y que no incluían en + los logs información que diera pistas sobre las causas de lo sucedido.

@@ -72,15 +72,15 @@
  • Desplegar un texto diferente, en lugar de los mensajes de la NCSA, o
    • -
  • redireccionar la petición a una URL local, o
    • +
  • redireccionar la petición a una URL local, o
    • -
  • redireccionar la petición a una URL externa.
    • +
  • redireccionar la petición a una URL externa.

    • Redireccionar a otra URL puede resultar de utilidad, pero - solo si con ello se puede también pasar alguna - información que pueda explicar el error o problema y/o - registrarlo en el log correspondiente más claramente.

    + solo si con ello se puede también pasar alguna + información que pueda explicar el error o problema y/o + registrarlo en el log correspondiente más claramente.

    Para conseguir esto, Apache define ahora variables de entorno similares a las de los CGI:

    @@ -103,25 +103,25 @@

    Tenga en cuenta el prefijo REDIRECT_.

    Al menos REDIRECT_URL y - REDIRECT_QUERY_STRING se pasarán a la nueva + REDIRECT_QUERY_STRING se pasarán a la nueva URL (asumiendo que es un cgi-script o un cgi-include). Las otras - variables existirán solo si existían antes de aparecer + variables existirán solo si existían antes de aparecer el error o problema. Ninguna de estas variables - se creará si en la directiva ErrorDocument ha especificado una - redirección externa (cualquier cosa que empiece + se creará si en la directiva ErrorDocument ha especificado una + redirección externa (cualquier cosa que empiece por un nombre de esquema del tipo http:, incluso si se refiere al mismo servidor).

    top
    -

    Configuración

    +

    Configuración

    El uso de ErrorDocument - está activado para los ficheros .htaccess cuando AllowOverride tiene el valor + está activado para los ficheros .htaccess cuando AllowOverride tiene el valor adecuado.

    -

    Aquí hay algunos ejemplos más...

    +

    Aquí hay algunos ejemplos más...

    ErrorDocument 500 /cgi-bin/crash-recover
    @@ -142,14 +142,14 @@

    1. Texto a mostrar. Ponga antes del texto que quiere que se muestre unas comillas ("). Lo que sea que siga a las comillas se - mostrará. Nota: las comillas (") no se + mostrará. Nota: las comillas (") no se muestran.
      2. -
    2. Una URL local a la que se redireccionará la - petición.
      3. +
    3. Una URL local a la que se redireccionará la + petición.
      4. -
    4. Una URL externa a la que se redireccionará la - petición.
      5. +
    5. Una URL externa a la que se redireccionará la + petición.
    top
    @@ -157,16 +157,16 @@

    El comportamiento de Apache en cuanto a las redirecciones ha - cambiado para que puedan usarse más variables de entorno con + cambiado para que puedan usarse más variables de entorno con los script/server-include.

    Antiguo comportamiento

    -

    Las variables CGI estándar estaban disponibles para el - script al que se hacía la redirección. No se incluía - ninguna indicación sobre la precedencia de la - redirección.

    +

    Las variables CGI estándar estaban disponibles para el + script al que se hacía la redirección. No se incluía + ninguna indicación sobre la precedencia de la + redirección.

    Nuevo comportamiento

    @@ -174,24 +174,24 @@

    Un nuevo grupo de variables de entorno se inicializa para que las use el script al que ha sido redireccionado. Cada - nueva variable tendrá el prefijo REDIRECT_. + nueva variable tendrá el prefijo REDIRECT_. Las variables de entorno REDIRECT_ se crean a partir de de las variables de entorno CGI que existen antes de - la redirección, se les cambia el nombre - añadiéndoles el prefijo REDIRECT_, por + la redirección, se les cambia el nombre + añadiéndoles el prefijo REDIRECT_, por ejemplo, HTTP_USER_AGENT pasa a ser - REDIRECT_HTTP_USER_AGENT. Además, para esas - nuevas variables, Apache definirá REDIRECT_URL + REDIRECT_HTTP_USER_AGENT. Además, para esas + nuevas variables, Apache definirá REDIRECT_URL y REDIRECT_STATUS para ayudar al script a seguir su origen. Tanto la URL original como la URL a la que es redirigida - la petición pueden almacenarse en los logs de acceso.

    + la petición pueden almacenarse en los logs de acceso.

    -

    Si ErrorDocument especifica una redirección local a un +

    Si ErrorDocument especifica una redirección local a un script CGI, el script debe incluir una campo de cabeceraa "Status:" en el resultado final para asegurar que - es posible hacer llegar al cliente de vuelta la condición - de error que lo provocó. Por ejemplo, un script en Perl - para usar con ErrorDocument podría incluir lo + es posible hacer llegar al cliente de vuelta la condición + de error que lo provocó. Por ejemplo, un script en Perl + para usar con ErrorDocument podría incluir lo siguiente:

    @@ -202,26 +202,26 @@

    Si el script tiene como fin tratar una determinada - condición de error, por ejemplo + condición de error, por ejemplo 404 Not Found, se pueden usar los - códigos de error y textos específicos en su lugar.

    + códigos de error y textos específicos en su lugar.

    Tenga en cuenta que el script debe incluir un campo de cabecera Status: apropiado (como 302 Found), si la respuesta contiene un campo de cabecera Location: (para poder enviar una - redirección que se interprete en el cliente). De otra + redirección que se interprete en el cliente). De otra manera, la cabecera Location: puede que no tenga efecto.

    Idiomas disponibles:  en  | - es  | - fr  | + es  | + fr  |  ja  |  ko  | - tr 

    + tr 

    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    - - -
    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    -
    -
    <-
    -

    Control de Acceso

    -
    -

    Idiomas disponibles:  en  | - es  | - fr 

    -
    - -

    El control de acceso, hace referencia a todos los medios que proporcionan - una forma de controlar el acceso a cualquier recurso. Esta parte está - separada de autenticación y autorización.

    -
    - -
    top
    -
    -

    Módulos y Directivas relacionados

    - -

    El control de acceso puede efectuarse mediante diferentes módulos. Los - más importantes de éstos son mod_authz_core y - mod_authz_host. También se habla en este documento de - el control de acceso usando el módulo mod_rewrite.

    - -
    top
    -
    -

    Control de Acceso por host

    -

    - Si lo que se quiere es restringir algunas zonas del sitio web, basándonos - en la dirección del visitante, esto puede ser realizado de manera - fácil con el módulo mod_authz_host. -

    - -

    La directiva Require - proporciona una variedad de diferentes maneras de permitir o denegar el acceso a los recursos. Además puede ser usada junto con las directivas:RequireAll, RequireAny, y RequireNone, estos requerimientos pueden - ser combinados de forma compleja y arbitraria, para cumplir cualquiera que - sean tus políticas de acceso.

    - -

    - Las directivas Allow, - Deny, y - Order, - proporcionadas por mod_access_compat, están obsoletas y - serán quitadas en futuras versiones. Deberá evitar su uso, y también - los tutoriales desactualizaos que recomienden su uso. -

    - -

    El uso de estas directivas es:

    - - - 
    Require host address 
    
-Require ip ip.address
-
    - - -

    En la primera línea, address es el FQDN de un nombre de - dominio (o un nombre parcial del dominio); puede proporcionar múltiples - direcciones o nombres de dominio, si se desea. -

    - -

    En la segunda línea, ip.address es la dirección IP, una - dirección IP parcial, una red con su máscara, o una especificación red/nnn - CIDR. Pueden usarse tanto IPV4 como IPV6.

    - -

    Consulte también la - documentación de mod_authz_host para otros ejemplos de esta sintaxis. -

    - -

    Puede ser insertado not para negar un requisito en particular. - Note que, ya que not es una negación de un valor, no puede ser - usado por si solo para permitir o denegar una petición, como not true - que no contituye ser false. En consecuencia, para denegar una - visita usando una negación, el bloque debe tener un elemento que se evalúa como - verdadero o falso. Por ejemplo, si tienes a alguien espameandote tu tablón de - mensajes, y tu quieres evitar que entren o dejarlos fuera, puedes realizar - lo siguiente: -

    - - 
    <RequireAll>
-    Require all granted
-    Require not ip 10.252.46.165
-</RequireAll>
    - - -

    Los visitantes que vengan desde la IP que se configura (10.252.46.165) - no tendrán acceso al contenido que cubre esta directiva. Si en cambio, lo que se - tiene es el nombre de la máquina, en vez de la IP, podrás usar:

    - - 
    Require not host host.example.com
-
    - - -

    Y, Si lo que se quiere es bloquear el acceso desde dominio especifico, - podrás especificar parte de una dirección o nombre de dominio:

    - - 
    Require not ip 192.168.205
-Require not host phishers.example.com moreidiots.example
-Require not host gov
    - - -

    Uso de las directivas RequireAll, RequireAny, y RequireNone pueden ser usadas - para forzar requisitos más complejos.

    - -
    top
    -
    -

    Control de acceso por variables arbitrarias.

    - -

    Haciendo el uso de <If>, - puedes permitir o denegar el acceso basado en variables de entrono arbitrarias - o en los valores de las cabeceras de las peticiones. Por ejemplo para denegar - el acceso basándonos en el "user-agent" (tipo de navegador así como Sistema Operativo) - puede que hagamos lo siguiente: -

    - - 
    <If "%{HTTP_USER_AGENT} == 'BadBot'">
-    Require all denied
-</If>
    - - -

    Usando la sintaxis de Require - expr , esto también puede ser escrito de la siguiente forma: -

    - - - 
    Require expr %{HTTP_USER_AGENT} != 'BadBot'
    - - -

    Advertencia:

    -

    El control de acceso por User-Agent es una técnica poco fiable, - ya que la cabecera de User-Agent puede ser modificada y establecerse - al antojo del usuario.

    -
    - -

    Vea también la página de expresiones - para una mayor aclaración de que sintaxis tienen las expresiones y que - variables están disponibles.

    - -
    top
    -
    -

    Control de acceso con mod_rewrite

    - -

    El flag [F] de RewriteRule causa una respuesta 403 Forbidden - para ser enviada. USando esto, podrá denegar el acceso a recursos basándose - en criterio arbitrario.

    - -

    Por ejemplo, si lo que desea es bloquear un recurso entre las 8pm y las - 7am, podrá hacerlo usando mod_rewrite:

    - - 
    RewriteEngine On
-RewriteCond "%{TIME_HOUR}" ">=20" [OR]
-RewriteCond "%{TIME_HOUR}" "<07"
-RewriteRule "^/fridge"     "-"       [F]
    - - -

    Esto devolverá una respuesta de error 403 Forbidden para cualquier petición - después de las 8pm y antes de las 7am. Esta técnica puede ser usada para cualquier - criterio que desee usar. También puede redireccionar, o incluso reescribir estas - peticiones, si se prefiere ese enfoque. -

    - -

    La directiva <If>, - añadida en la 2.4, sustituye muchas cosas que mod_rewrite - tradicionalmente solía hacer, y deberá comprobar estas antes de recurrir a -

    - -
    top
    -
    -

    Más información

    - -

    El motor de expresiones le da una gran - capacidad de poder para hacer una gran variedad de cosas basadas en - las variables arbitrarias del servidor, y debe consultar este - documento para más detalles.

    - -

    También, deberá leer la documentación de mod_authz_core - para ejemplos de combinaciones de múltiples requisitos de acceso y especificar - cómo interactúan. -

    - -

    Vea también los howtos de Authenticación y Autorización -

    -
    -
    -

    Idiomas disponibles:  en  | - es  | - fr 

    -
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    + --> +Control de Acceso - Servidor Apache HTTP Versión 2.4 + + + + + + +
    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    +
    +
    <-
    +

    Control de Acceso

    +
    +

    Idiomas disponibles:  en  | + es  | + fr 

    +
    + +

    El control de acceso, hace referencia a todos los medios que proporcionan + una forma de controlar el acceso a cualquier recurso. Esta parte está + separada de autenticación y autorización.

    +
    + +
    top
    +
    +

    Módulos y Directivas relacionados

    + +

    El control de acceso puede efectuarse mediante diferentes módulos. Los + más importantes de éstos son mod_authz_core y + mod_authz_host. También se habla en este documento de + el control de acceso usando el módulo mod_rewrite.

    + +
    top
    +
    +

    Control de Acceso por host

    +

    + Si lo que se quiere es restringir algunas zonas del sitio web, basándonos + en la dirección del visitante, esto puede ser realizado de manera + fácil con el módulo mod_authz_host. +

    + +

    La directiva Require + proporciona una variedad de diferentes maneras de permitir o denegar el acceso a los recursos. Además puede ser usada junto con las directivas:RequireAll, RequireAny, y RequireNone, estos requerimientos pueden + ser combinados de forma compleja y arbitraria, para cumplir cualquiera que + sean tus políticas de acceso.

    + +

    + Las directivas Allow, + Deny, y + Order, + proporcionadas por mod_access_compat, están obsoletas y + serán quitadas en futuras versiones. Deberá evitar su uso, y también + los tutoriales desactualizaos que recomienden su uso. +

    + +

    El uso de estas directivas es:

    + + + 
    Require host address 
    
+Require ip ip.address
+
    + + +

    En la primera línea, address es el FQDN de un nombre de + dominio (o un nombre parcial del dominio); puede proporcionar múltiples + direcciones o nombres de dominio, si se desea. +

    + +

    En la segunda línea, ip.address es la dirección IP, una + dirección IP parcial, una red con su máscara, o una especificación red/nnn + CIDR. Pueden usarse tanto IPV4 como IPV6.

    + +

    Consulte también la + documentación de mod_authz_host para otros ejemplos de esta sintaxis. +

    + +

    Puede ser insertado not para negar un requisito en particular. + Note que, ya que not es una negación de un valor, no puede ser + usado por si solo para permitir o denegar una petición, como not true + que no contituye ser false. En consecuencia, para denegar una + visita usando una negación, el bloque debe tener un elemento que se evalúa como + verdadero o falso. Por ejemplo, si tienes a alguien espameandote tu tablón de + mensajes, y tu quieres evitar que entren o dejarlos fuera, puedes realizar + lo siguiente: +

    + + 
    <RequireAll>
+    Require all granted
+    Require not ip 10.252.46.165
+</RequireAll>
    + + +

    Los visitantes que vengan desde la IP que se configura (10.252.46.165) + no tendrán acceso al contenido que cubre esta directiva. Si en cambio, lo que se + tiene es el nombre de la máquina, en vez de la IP, podrás usar:

    + + 
    Require not host host.example.com
+
    + + +

    Y, Si lo que se quiere es bloquear el acceso desde dominio especifico, + podrás especificar parte de una dirección o nombre de dominio:

    + + 
    Require not ip 192.168.205
+Require not host phishers.example.com moreidiots.example
+Require not host gov
    + + +

    Uso de las directivas RequireAll, RequireAny, y RequireNone pueden ser usadas + para forzar requisitos más complejos.

    + +
    top
    +
    +

    Control de acceso por variables arbitrarias.

    + +

    Haciendo el uso de <If>, + puedes permitir o denegar el acceso basado en variables de entrono arbitrarias + o en los valores de las cabeceras de las peticiones. Por ejemplo para denegar + el acceso basándonos en el "user-agent" (tipo de navegador así como Sistema Operativo) + puede que hagamos lo siguiente: +

    + + 
    <If "%{HTTP_USER_AGENT} == 'BadBot'">
+    Require all denied
+</If>
    + + +

    Usando la sintaxis de Require + expr , esto también puede ser escrito de la siguiente forma: +

    + + + 
    Require expr %{HTTP_USER_AGENT} != 'BadBot'
    + + +

    Advertencia:

    +

    El control de acceso por User-Agent es una técnica poco fiable, + ya que la cabecera de User-Agent puede ser modificada y establecerse + al antojo del usuario.

    +
    + +

    Vea también la página de expresiones + para una mayor aclaración de que sintaxis tienen las expresiones y que + variables están disponibles.

    + +
    top
    +
    +

    Control de acceso con mod_rewrite

    + +

    El flag [F] de RewriteRule causa una respuesta 403 Forbidden + para ser enviada. USando esto, podrá denegar el acceso a recursos basándose + en criterio arbitrario.

    + +

    Por ejemplo, si lo que desea es bloquear un recurso entre las 8pm y las + 7am, podrá hacerlo usando mod_rewrite:

    + + 
    RewriteEngine On
+RewriteCond "%{TIME_HOUR}" ">=20" [OR]
+RewriteCond "%{TIME_HOUR}" "<07"
+RewriteRule "^/fridge"     "-"       [F]
    + + +

    Esto devolverá una respuesta de error 403 Forbidden para cualquier petición + después de las 8pm y antes de las 7am. Esta técnica puede ser usada para cualquier + criterio que desee usar. También puede redireccionar, o incluso reescribir estas + peticiones, si se prefiere ese enfoque. +

    + +

    La directiva <If>, + añadida en la 2.4, sustituye muchas cosas que mod_rewrite + tradicionalmente solía hacer, y deberá comprobar estas antes de recurrir a +

    + +
    top
    +
    +

    Más información

    + +

    El motor de expresiones le da una gran + capacidad de poder para hacer una gran variedad de cosas basadas en + las variables arbitrarias del servidor, y debe consultar este + documento para más detalles.

    + +

    También, deberá leer la documentación de mod_authz_core + para ejemplos de combinaciones de múltiples requisitos de acceso y especificar + cómo interactúan. +

    + +

    Vea también los howtos de Authenticación y Autorización +

    +
    +
    +

    Idiomas disponibles:  en  | + es  | + fr 

    +
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    +//--> \ No newline at end of file diff --git a/docs/manual/howto/auth.html.en b/docs/manual/howto/auth.html.en index 753be15f03..e97e991c63 100644 --- a/docs/manual/howto/auth.html.en +++ b/docs/manual/howto/auth.html.en @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4 > How-To / Tutorials

    Authentication and Authorization

    Available Languages:  en  | + es  |  fr  |  ja  |  ko  | @@ -606,6 +607,7 @@ Require group GroupName

    Available Languages:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/auth.html.es b/docs/manual/howto/auth.html.es index 4589cc1f93..deb2452755 100644 --- a/docs/manual/howto/auth.html.es +++ b/docs/manual/howto/auth.html.es @@ -1,692 +1,692 @@ - - - - + + + + -Autenticación y Autorización - Servidor Apache HTTP Versión 2.4 - - - - - - -

    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    -
    -
    <-
    -

    Autenticación y Autorización

    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko  | - tr 

    -
    - -

    Autenticación es cualquier proceso por el cuál se verifica que uno es - quien dice ser. Autorización es cualquier proceso en el cuál cualquiera - está permitido a estar donde se quiera, o tener información la cuál se - quiera tener. -

    - -

    Para información de control de acceso de forma genérica visiteHow to de Control de Acceso.

    -
    - -
    top
    -
    -

    Módulos y Directivas Relacionados

    - -

    Hay tres tipos de módulos involucrados en los procesos de la autenticación - y autorización. Normalmente deberás escoger al menos un módulo de cada grupo.

    - - - -

    A parte de éstos módulos, también están - mod_authn_core y - mod_authz_core. Éstos módulos implementan las directivas - esenciales que son el centro de todos los módulos de autenticación.

    - -

    El módulo mod_authnz_ldap es tanto un proveedor de - autenticación como de autorización. El módulo - mod_authz_host proporciona autorización y control de acceso - basado en el nombre del Host, la dirección IP o características de la propia - petición, pero no es parte del sistema proveedor de - autenticación. Para tener compatibilidad inversa con el mod_access, - hay un nuevo modulo llamado mod_access_compat.

    - -

    También puedes mirar el how-to de Control de Acceso , donde se plantean varias formas del control de acceso al servidor.

    - -
    top
    -
    -

    Introducción

    -

    Si se tiene información en nuestra página web que sea información - sensible o pensada para un grupo reducido de usuarios/personas, - las técnicas que se describen en este manual, le servirán - de ayuda para asegurarse de que las personas que ven esas páginas sean - las personas que uno quiere.

    - -

    Este artículo cubre la parte "estándar" de cómo proteger partes de un - sitio web que muchos usarán.

    - -

    Nota:

    -

    Si de verdad es necesario que tus datos estén en un sitio seguro, - considera usar mod_ssl como método de autenticación adicional a cualquier forma de autenticación.

    -
    -
    top
    -
    -

    Los Prerequisitos

    -

    Las directivas que se usan en este artículo necesitaran ponerse ya sea - en el fichero de configuración principal del servidor ( típicamente en - la sección - <Directory> de httpd.conf ), o - en cada uno de los ficheros de configuraciones del propio directorio - (los archivos .htaccess).

    - -

    Si planea usar los ficheros .htaccess , necesitarás - tener en la configuración global del servidor, una configuración que permita - poner directivas de autenticación en estos ficheros. Esto se hace con la - directiva AllowOverride, la cual especifica - que directivas, en su caso, pueden ser puestas en cada fichero de configuración - por directorio.

    - -

    Ya que estamos hablando aquí de autenticación, necesitarás una directiva - AllowOverride como la siguiente: -

    - - 
    AllowOverride AuthConfig
    - - -

    O, si solo se van a poner las directivas directamente en la configuración - principal del servidor, deberás tener, claro está, permisos de escritura - en el archivo.

    - -

    Y necesitarás saber un poco de como está estructurado el árbol de - directorios de tu servidor, para poder saber donde se encuentran algunos - archivos. Esto no debería ser una tarea difícil, aún así intentaremos - dejarlo claro llegado el momento de comentar dicho aspecto.

    - -

    También deberás de asegurarte de que los módulos - mod_authn_core y mod_authz_core - han sido incorporados, o añadidos a la hora de compilar en tu binario httpd o - cargados mediante el archivo de configuración httpd.conf. Estos - dos módulos proporcionan directivas básicas y funcionalidades que son críticas - para la configuración y uso de autenticación y autorización en el servidor web.

    -
    top
    -
    -

    Conseguir que funcione

    -

    Aquí está lo básico de cómo proteger con contraseña un directorio en tu - servidor.

    - -

    Primero, necesitarás crear un fichero de contraseña. Dependiendo de que - proveedor de autenticación se haya elegido, se hará de una forma u otra. Para empezar, - usaremos un fichero de contraseña de tipo texto.

    - -

    Este fichero deberá estar en un sitio que no se pueda tener acceso desde - la web. Esto también implica que nadie pueda descargarse el fichero de - contraseñas. Por ejemplo, si tus documentos están guardados fuera de - /usr/local/apache/htdocs, querrás poner tu archivo de contraseñas en - /usr/local/apache/passwd.

    - -

    Para crear el fichero de contraseñas, usa la utilidad - htpasswd que viene con Apache. Esta herramienta se - encuentra en el directorio /bin en donde sea que se ha - instalado el Apache. Si ha instalado Apache desde un paquete de terceros, - puede ser que se encuentre en su ruta de ejecución.

    - -

    Para crear el fichero, escribiremos:

    - -

    - htpasswd -c /usr/local/apache/passwd/passwords rbowen -

    - -

    htpasswd te preguntará por una contraseña, y después - te pedirá que la vuelvas a escribir para confirmarla:

    - -

    - $ htpasswd -c /usr/local/apache/passwd/passwords rbowen
    - New password: mypassword
    - Re-type new password: mypassword
    - Adding password for user rbowen -

    - -

    Si htpasswd no está en tu variable de entorno "path" del - sistema, por supuesto deberás escribir la ruta absoluta del ejecutable para - poder hacer que se ejecute. En una instalación por defecto, está en: - /usr/local/apache2/bin/htpasswd

    - -

    Lo próximo que necesitas, será configurar el servidor para que pida una - contraseña y así decirle al servidor que usuarios están autorizados a acceder. - Puedes hacer esto ya sea editando el fichero httpd.conf - de configuración o usando in fichero .htaccess. Por ejemplo, - si quieres proteger el directorio - /usr/local/apache/htdocs/secret, puedes usar las siguientes - directivas, ya sea en el fichero .htaccess localizado en - following directives, either placed in the file - /usr/local/apache/htdocs/secret/.htaccess, o - en la configuración global del servidor httpd.conf dentro de la - sección <Directory - "/usr/local/apache/htdocs/secret"> , como se muestra a continuación:

    - - 
    <Directory "/usr/local/apache/htdocs/secret">
-AuthType Basic
-AuthName "Restricted Files"
-# (Following line optional)
-AuthBasicProvider file
-AuthUserFile "/usr/local/apache/passwd/passwords"
-Require user rbowen
-</Directory>
    - - -

    Vamos a explicar cada una de las directivas individualmente. - La directiva AuthType selecciona el método - que se usa para autenticar al usuario. El método más común es - Basic, y éste es el método que implementa - mod_auth_basic. Es muy importante ser consciente, - de que la autenticación básica, envía las contraseñas desde el cliente - al servidor sin cifrar. - Este método por tanto, no debe ser utilizado para proteger datos muy sensibles, - a no ser que, este método de autenticación básica, sea acompañado del módulo - mod_ssl. - Apache soporta otro método más de autenticación que es del tipo - AuthType Digest. Este método, es implementado por el módulo mod_auth_digest y con el se pretendía crear una autenticación más - segura. Este ya no es el caso, ya que la conexión deberá realizarse con mod_ssl en su lugar. -

    - -

    La directiva AuthName - establece el Realm para ser usado en la autenticación. El - Realm tiene dos funciones principales. - La primera, el cliente presenta a menudo esta información al usuario como - parte del cuadro de diálogo de contraseña. La segunda, que es utilizado por - el cliente para determinar qué contraseña enviar a para una determinada zona - de autenticación.

    - -

    Así que, por ejemple, una vez que el cliente se ha autenticado en el área de - los "Ficheros Restringidos", entonces re-intentará automáticamente - la misma contraseña para cualquier área en el mismo servidor que es marcado - con el Realm de "Ficheros Restringidos" - Por lo tanto, puedes prevenir que a un usuario se le pida mas de una vez por su - contraseña, compartiendo así varias áreas restringidas el mismo Realm - Por supuesto, por razones de seguridad, el cliente pedirá siempre por una contraseña, - siempre y cuando el nombre del servidor cambie. -

    - -

    La directiva AuthBasicProvider es, - en este caso, opcional, ya que file es el valor por defecto - para esta directiva. Deberás usar esta directiva si estas usando otro medio - diferente para la autenticación, como por ejemplo - mod_authn_dbm o mod_authn_dbd.

    - -

    La directiva AuthUserFile - establece el path al fichero de contraseñas que acabamos de crear con el - comando htpasswd. Si tiene un número muy grande de usuarios, - puede ser realmente lento el buscar el usuario en ese fichero de texto plano - para autenticar a los usuarios en cada petición. - Apache también tiene la habilidad de almacenar información de usuarios en - unos ficheros de rápido acceso a modo de base de datos. - El módulo mod_authn_dbm proporciona la directiva AuthDBMUserFile. Estos ficheros pueden ser creados y - manipulados con el programa dbmmanage y htdbm. - Muchos otros métodos de autenticación así como otras opciones, están disponibles en - módulos de terceros - Base de datos de Módulos disponibles.

    - -

    Finalmente, la directiva Require - proporciona la parte del proceso de autorización estableciendo el o los - usuarios que se les está permitido acceder a una región del servidor. - En la próxima sección, discutiremos las diferentes vías de utilizar la - directiva Require.

    -
    top
    -
    -

    Dejar que más de una persona - entre

    -

    Las directivas mencionadas arriba sólo permiten a una persona - (especialmente con un usuario que en ej ejemplo es rbowen) - en el directorio. En la mayoría de los casos, se querrá permitir el acceso - a más de una persona. Aquí es donde la directiva - AuthGroupFile entra en juego.

    - -

    Si lo que se desea es permitir a más de una persona el acceso, necesitarás - crear un archivo de grupo que asocie los nombres de grupos con el de personas - para permitirles el acceso. El formato de este fichero es bastante sencillo, - y puedes crearlo con tu editor de texto favorito. El contenido del fichero - se parecerá a:

    - -

    - GroupName: rbowen dpitts sungo rshersey -

    - -

    Básicamente eso es la lista de miembros los cuales están en un mismo fichero - de grupo en una sola linea separados por espacios.

    - -

    Para añadir un usuario a tu fichero de contraseñas existente teclee:

    - -

    - htpasswd /usr/local/apache/passwd/passwords dpitts -

    - -

    Te responderá lo mismo que anteriormente, pero se añadirá al fichero - existente en vez de crear uno nuevo. (Es decir el flag -c será - el que haga que se genere un nuevo - fichero de contraseñas).

    - -

    Ahora, tendrá que modificar su fichero .htaccess para que sea - parecido a lo siguiente:

    - - 
    AuthType Basic
-AuthName "By Invitation Only"
-# Optional line:
-AuthBasicProvider file
-AuthUserFile "/usr/local/apache/passwd/passwords"
-AuthGroupFile "/usr/local/apache/passwd/groups"
-Require group GroupName
    - - -

    Ahora, cualquiera que esté listado en el grupo GroupName, - y tiene una entrada en el fichero de contraseñas, se les - permitirá el acceso, si introducen su contraseña correctamente.

    - -

    Hay otra manera de dejar entrar a varios usuarios, que es menos específica. - En lugar de crear un archivo de grupo, sólo puede utilizar la siguiente - directiva:

    - - 
    Require valid-user
    - - -

    Usando ésto en vez de la línea Require user rbowen - permitirá a cualquier persona acceder, la cuál aparece en el archivo de - contraseñas, y que introduzca correctamente su contraseña. Incluso puede - emular el comportamiento del grupo aquí, sólo manteniendo un fichero de - contraseñas independiente para cada grupo. La ventaja de este enfoque es - que Apache sólo tiene que comprobar un archivo, en lugar de dos. La desventaja - es que se tiene que mantener un montón de ficheros de contraseña de grupo, y - recuerde hacer referencia al fichero correcto en la directiva - AuthUserFile.

    -
    top
    -
    -

    Posibles Problemas

    -

    Debido a la forma en que se especifica la autenticación básica, - su nombre de usuario y la contraseña deben ser verificados cada vez - que se solicita un documento desde el servidor. Esto es, incluso si  - se  vuelve a cargar la misma página, y para cada imagen de la página (si -    provienen de un directorio protegido). Como se puede imaginar, esto -    ralentiza las cosas un poco. La cantidad que ralentiza las cosas es - proporcional al tamaño del archivo de contraseñas, porque tiene que - abrir ese archivo, recorrer lista de usuarios hasta que llega a su nombre. - Y tiene que hacer esto cada vez que se carga una página.

    - -

    Una consecuencia de esto, es que hay un limite práctico de cuantos - usuarios puedes introducir en el fichero de contraseñas. Este límite - variará dependiendo de la máquina en la que tengas el servidor, - pero puedes notar ralentizaciones en cuanto se metan cientos de entradas, - y por lo tanto consideraremos entonces otro método de autenticación - en ese momento. -

    -
    top
    -
    -

    Método alternativo de almacenamiento de las - contraseñas

    - -

    Debido a que el almacenamiento de las contraseñas en texto plano tiene - el problema mencionado anteriormente, puede que se prefiera guardar - las contraseñas en otro lugar como por ejemplo una base de datos. -

    - -

    Los módulos mod_authn_dbm y mod_authn_dbd son - dos módulos que hacen esto posible. En vez de seleccionar la directiva de fichero - AuthBasicProvider , en su lugar - se puede elegir dbm o dbd como formato de almacenamiento.

    - -

    Para seleccionar los ficheros de tipo dbm en vez de texto plano, podremos hacer algo parecido a lo siguiente:

    - - 
    <Directory "/www/docs/private">
-    AuthName "Private"
-    AuthType Basic
-    AuthBasicProvider dbm
-    AuthDBMUserFile "/www/passwords/passwd.dbm"
-    Require valid-user
-</Directory>
    - - -

    Hay otras opciones disponibles. Consulta la documentación de - mod_authn_dbm para más detalles.

    -
    top
    -
    -

    Uso de múltiples proveedores

    - -

    Con la introducción de la nueva autenticación basada en un proveedor y - una arquitectura de autorización, ya no estaremos restringidos a un único - método de autenticación o autorización. De hecho, cualquier número de - los proveedores pueden ser mezclados y emparejados para ofrecerle - exactamente el esquema que se adapte a sus necesidades. - En el siguiente ejemplo, veremos como ambos proveedores tanto el fichero - como el LDAP son usados en la autenticación: -

    - - 
    <Directory "/www/docs/private">
-    AuthName "Private"
-    AuthType Basic
-    AuthBasicProvider file ldap
-    AuthUserFile "/usr/local/apache/passwd/passwords"
-    AuthLDAPURL ldap://ldaphost/o=yourorg
-    Require valid-user
-</Directory>
    - - -

    En este ejemplo el fichero, que actúa como proveedor, intentará autenticar - primero al usuario. Si no puede autenticar al usuario, el proveedor del LDAP - será llamado para que realice la autenticación. - Esto permite al ámbito de autenticación ser amplio, si su organización - implementa más de un tipo de almacén de autenticación. - Otros escenarios de autenticación y autorización pueden incluir la - mezcla de un tipo de autenticación con un tipo diferente de autorización. - Por ejemplo, autenticar contra un fichero de contraseñas pero autorizando - dicho acceso mediante el directorio del LDAP.

    - -

    Así como múltiples métodos y proveedores de autenticación pueden - ser implementados, también pueden usarse múltiples formas de - autorización. - En este ejemplo ambos ficheros de autorización de grupo así como - autorización de grupo mediante LDAP va a ser usado: -

    - - 
    <Directory "/www/docs/private">
-    AuthName "Private"
-    AuthType Basic
-    AuthBasicProvider file
-    AuthUserFile "/usr/local/apache/passwd/passwords"
-    AuthLDAPURL ldap://ldaphost/o=yourorg
-    AuthGroupFile "/usr/local/apache/passwd/groups"
-    Require group GroupName
-    Require ldap-group cn=mygroup,o=yourorg
-</Directory>
    - - -

    Para llevar la autorización un poco más lejos, las directivas - de autorización de contenedores tales como - <RequireAll> - and - <RequireAny> - nos permiten aplicar una lógica de en qué orden se manejará la autorización dependiendo - de la configuración y controlada a través de ella. - Mire también Contenedores de - Autorización para ejemplos de cómo pueden ser aplicados.

    - -
    top
    -
    -

    Más allá de la Autorización

    - -

    El modo en que la autorización puede ser aplicada es ahora mucho más flexible - que us solo chequeo contra un almacén de datos (contraseñas). Ordenando la - lógica y escoger la forma en que la autorización es realizada, ahora es posible -

    - -

    Aplicando la lógica y ordenación

    -

    Controlar el cómo y en qué orden se va a aplicar la autorización ha - sido un misterio en el pasado. En Apache 2.2 un proveedor del - mecanismo de autenticación fue introducido para disociar el proceso actual - de autenticación y soportar funcionalidad. - Uno de los beneficios secundarios fue que los proveedores de autenticación - podían ser configurados y llamados en un orden especifico que no dependieran - en el orden de carga del propio modulo. - Este proveedor de dicho mecanismo, ha sido introducido en la autorización - también. Lo que esto significa es que la directiva - Require - no sólo especifica que método de autorización deberá ser usado, si no - también especifica el orden en que van a ser llamados. Múltiples - métodos de autorización son llamados en el mismo orden en que la directiva - Require aparece en la - configuración. -

    - -

    - Con la Introducción del contenedor de directivas de autorización tales como - <RequireAll> - y - <RequireAny>, - La configuración también tiene control sobre cuándo se llaman a los métodos - de autorización y qué criterios determinan cuándo se concede el acceso. - Vease - Contenedores de autorización - Para un ejemplo de cómo pueden ser utilizados para expresar una lógica - más compleja de autorización. -

    - -

    - Por defecto todas las directivas - Require - son manejadas como si estuvieran contenidas en una directiva - <RequireAny>. - En otras palabras, Si alguno de los métodos de autorización - especificados tiene éxito, se concede la autorización. -

    - - - -

    Uso de los proveedores de autorización para - el control de acceso

    - -

    - La autenticación de nombre de usuario y contraseña es sólo parte - de toda la historia que conlleva el proceso. Frecuentemente quiere - dar acceso a la gente en base a algo más que lo que son. - Algo como de donde vienen. -

    - -

    - Los proveedores de autorización all, - env, host y ip - te permiten denegar o permitir el acceso basándose en otros - criterios como el nombre de la máquina o la IP de la máquina que - realiza la consulta para un documento. -

    - -

    - El uso de estos proveedores se especifica a través de la directiva - Require. - La directiva registra los proveedores de autorización que serán llamados - durante la solicitud de la fase del proceso de autorización. Por ejemplo: -

    - - 
    Require ip address
-
    - - -

    - Donde address es una dirección IP (o una dirección IP parcial) - o bien: -

    - - 
    Require host domain_name
-
    - - -

    - Donde domain_name es el nombre completamente cualificado de un nombre - de dominio (FQDN) (o un nombre parcial del dominio); - puede proporcionar múltiples direcciones o nombres de dominio, si se desea. -

    - -

    - Por ejemplo, si alguien envía spam a su tablón de mensajes y desea - mantenerlos alejados, podría hacer lo siguiente:

    - - 
    <RequireAll>
-    Require all granted
-    Require not ip 10.252.46.165
-</RequireAll>
    - - -

    - Visitantes que vengan desde esa IP no serán capaces de ver el contenido - que cubre esta directiva. Si, en cambio, lo que se tiene es el nombre de - la máquina, en vez de la dirección IP, podría usar: -

    - - 
    <RequireAll>
-    Require all granted
-    Require not host host.example.com
-</RequireAll>
    - - -

    - Y, si lo que se quiere es bloquear el acceso desde un determinado dominio - (bloquear el acceso desde el dominio entero), puede especificar parte - de la dirección o del propio dominio a bloquear: -

    - - 
    <RequireAll>
-    Require all granted
-    Require not ip 192.168.205
-    Require not host phishers.example.com moreidiots.example
-    Require not host ke
-</RequireAll>
    - - -

    - Usando <RequireAll> - con múltiples directivas <Require>, cada una negada con un not, - Sólo permitirá el acceso, si todas las condiciones negadas son verdaderas. - En otras palabras, el acceso será bloqueado, si cualquiera de las condiciones - negadas fallara. -

    - - - -

    Compatibilidad de Control de Acceso con versiones - anteriores

    - -

    - Uno de los efectos secundarios de adoptar proveedores basados en - mecanismos de autenticación es que las directivas anteriores - Order, - Allow, - Deny y - Satisfy ya no son necesarias. - Sin embargo, para proporcionar compatibilidad con configuraciones antiguas, - estas directivas se han movido al módulo mod_access_compat. -

    - -

    Nota:

    -

    - Las directivas proporcionadas por mod_access_compat - han quedado obsoletas por mod_authz_host. Mezclar - directivas antiguas como - Order, - Allow ó - Deny con las nuevas - como - Require - es técnicamente posible pero desaconsejable. El módulo - mod_access_compat se creó para soportar configuraciones - que contuvieran sólo directivas antiguas para facilitar la actualización - a la versión 2.4. - Por favor revise la documentación de - actualización para más información al - respecto. -

    -
    - - -
    top
    -
    -

    Cache de Autenticación

    -

    - Puede haber momentos en que la autenticación ponga una carga - inaceptable en el proveedor (de autenticación) o en tu red. - Esto suele afectar a los usuarios de mod_authn_dbd - (u otros proveedores de terceros/personalizados). - Para lidiar con este problema, HTTPD 2.3/2.4 introduce un nuevo proveedor - de caché mod_authn_socache para cachear las credenciales - y reducir la carga en el proveedor(es) original. -

    -

    - Esto puede ofrecer un aumento de rendimiento sustancial para algunos usuarios. -

    -
    top
    -
    -

    Más información

    - -

    - También debería leer la documentación para - mod_auth_basic y mod_authz_host - la cuál contiene más información de como funciona todo esto. - La directiva <AuthnProviderAlias> puede también ayudar - a la hora de simplificar ciertas configuraciones de autenticación. -

    - -

    - Los diferentes algoritmos de cifrado que están soportados por Apache - para la autenticación se explican en - Cifrado de Contraseñas. -

    - -

    - Y tal vez quiera ojear la documentación de "how to" - Control de Acceso donde se mencionan temas - relacionados.

    - -
    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko  | - tr 

    -
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    + --> +Autenticación y Autorización - Servidor Apache HTTP Versión 2.4 + + + + + + +
    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    +
    +
    <-
    +

    Autenticación y Autorización

    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko  | + tr 

    +
    + +

    Autenticación es cualquier proceso por el cuál se verifica que uno es + quien dice ser. Autorización es cualquier proceso en el cuál cualquiera + está permitido a estar donde se quiera, o tener información la cuál se + quiera tener. +

    + +

    Para información de control de acceso de forma genérica visiteHow to de Control de Acceso.

    +
    + +
    top
    +
    +

    Módulos y Directivas Relacionados

    + +

    Hay tres tipos de módulos involucrados en los procesos de la autenticación + y autorización. Normalmente deberás escoger al menos un módulo de cada grupo.

    + + + +

    A parte de éstos módulos, también están + mod_authn_core y + mod_authz_core. Éstos módulos implementan las directivas + esenciales que son el centro de todos los módulos de autenticación.

    + +

    El módulo mod_authnz_ldap es tanto un proveedor de + autenticación como de autorización. El módulo + mod_authz_host proporciona autorización y control de acceso + basado en el nombre del Host, la dirección IP o características de la propia + petición, pero no es parte del sistema proveedor de + autenticación. Para tener compatibilidad inversa con el mod_access, + hay un nuevo modulo llamado mod_access_compat.

    + +

    También puedes mirar el how-to de Control de Acceso , donde se plantean varias formas del control de acceso al servidor.

    + +
    top
    +
    +

    Introducción

    +

    Si se tiene información en nuestra página web que sea información + sensible o pensada para un grupo reducido de usuarios/personas, + las técnicas que se describen en este manual, le servirán + de ayuda para asegurarse de que las personas que ven esas páginas sean + las personas que uno quiere.

    + +

    Este artículo cubre la parte "estándar" de cómo proteger partes de un + sitio web que muchos usarán.

    + +

    Nota:

    +

    Si de verdad es necesario que tus datos estén en un sitio seguro, + considera usar mod_ssl como método de autenticación adicional a cualquier forma de autenticación.

    +
    +
    top
    +
    +

    Los Prerequisitos

    +

    Las directivas que se usan en este artículo necesitaran ponerse ya sea + en el fichero de configuración principal del servidor ( típicamente en + la sección + <Directory> de httpd.conf ), o + en cada uno de los ficheros de configuraciones del propio directorio + (los archivos .htaccess).

    + +

    Si planea usar los ficheros .htaccess , necesitarás + tener en la configuración global del servidor, una configuración que permita + poner directivas de autenticación en estos ficheros. Esto se hace con la + directiva AllowOverride, la cual especifica + que directivas, en su caso, pueden ser puestas en cada fichero de configuración + por directorio.

    + +

    Ya que estamos hablando aquí de autenticación, necesitarás una directiva + AllowOverride como la siguiente: +

    + + 
    AllowOverride AuthConfig
    + + +

    O, si solo se van a poner las directivas directamente en la configuración + principal del servidor, deberás tener, claro está, permisos de escritura + en el archivo.

    + +

    Y necesitarás saber un poco de como está estructurado el árbol de + directorios de tu servidor, para poder saber donde se encuentran algunos + archivos. Esto no debería ser una tarea difícil, aún así intentaremos + dejarlo claro llegado el momento de comentar dicho aspecto.

    + +

    También deberás de asegurarte de que los módulos + mod_authn_core y mod_authz_core + han sido incorporados, o añadidos a la hora de compilar en tu binario httpd o + cargados mediante el archivo de configuración httpd.conf. Estos + dos módulos proporcionan directivas básicas y funcionalidades que son críticas + para la configuración y uso de autenticación y autorización en el servidor web.

    +
    top
    +
    +

    Conseguir que funcione

    +

    Aquí está lo básico de cómo proteger con contraseña un directorio en tu + servidor.

    + +

    Primero, necesitarás crear un fichero de contraseña. Dependiendo de que + proveedor de autenticación se haya elegido, se hará de una forma u otra. Para empezar, + usaremos un fichero de contraseña de tipo texto.

    + +

    Este fichero deberá estar en un sitio que no se pueda tener acceso desde + la web. Esto también implica que nadie pueda descargarse el fichero de + contraseñas. Por ejemplo, si tus documentos están guardados fuera de + /usr/local/apache/htdocs, querrás poner tu archivo de contraseñas en + /usr/local/apache/passwd.

    + +

    Para crear el fichero de contraseñas, usa la utilidad + htpasswd que viene con Apache. Esta herramienta se + encuentra en el directorio /bin en donde sea que se ha + instalado el Apache. Si ha instalado Apache desde un paquete de terceros, + puede ser que se encuentre en su ruta de ejecución.

    + +

    Para crear el fichero, escribiremos:

    + +

    + htpasswd -c /usr/local/apache/passwd/passwords rbowen +

    + +

    htpasswd te preguntará por una contraseña, y después + te pedirá que la vuelvas a escribir para confirmarla:

    + +

    + $ htpasswd -c /usr/local/apache/passwd/passwords rbowen
    + New password: mypassword
    + Re-type new password: mypassword
    + Adding password for user rbowen +

    + +

    Si htpasswd no está en tu variable de entorno "path" del + sistema, por supuesto deberás escribir la ruta absoluta del ejecutable para + poder hacer que se ejecute. En una instalación por defecto, está en: + /usr/local/apache2/bin/htpasswd

    + +

    Lo próximo que necesitas, será configurar el servidor para que pida una + contraseña y así decirle al servidor que usuarios están autorizados a acceder. + Puedes hacer esto ya sea editando el fichero httpd.conf + de configuración o usando in fichero .htaccess. Por ejemplo, + si quieres proteger el directorio + /usr/local/apache/htdocs/secret, puedes usar las siguientes + directivas, ya sea en el fichero .htaccess localizado en + following directives, either placed in the file + /usr/local/apache/htdocs/secret/.htaccess, o + en la configuración global del servidor httpd.conf dentro de la + sección <Directory + "/usr/local/apache/htdocs/secret"> , como se muestra a continuación:

    + + 
    <Directory "/usr/local/apache/htdocs/secret">
+AuthType Basic
+AuthName "Restricted Files"
+# (Following line optional)
+AuthBasicProvider file
+AuthUserFile "/usr/local/apache/passwd/passwords"
+Require user rbowen
+</Directory>
    + + +

    Vamos a explicar cada una de las directivas individualmente. + La directiva AuthType selecciona el método + que se usa para autenticar al usuario. El método más común es + Basic, y éste es el método que implementa + mod_auth_basic. Es muy importante ser consciente, + de que la autenticación básica, envía las contraseñas desde el cliente + al servidor sin cifrar. + Este método por tanto, no debe ser utilizado para proteger datos muy sensibles, + a no ser que, este método de autenticación básica, sea acompañado del módulo + mod_ssl. + Apache soporta otro método más de autenticación que es del tipo + AuthType Digest. Este método, es implementado por el módulo mod_auth_digest y con el se pretendía crear una autenticación más + segura. Este ya no es el caso, ya que la conexión deberá realizarse con mod_ssl en su lugar. +

    + +

    La directiva AuthName + establece el Realm para ser usado en la autenticación. El + Realm tiene dos funciones principales. + La primera, el cliente presenta a menudo esta información al usuario como + parte del cuadro de diálogo de contraseña. La segunda, que es utilizado por + el cliente para determinar qué contraseña enviar a para una determinada zona + de autenticación.

    + +

    Así que, por ejemple, una vez que el cliente se ha autenticado en el área de + los "Ficheros Restringidos", entonces re-intentará automáticamente + la misma contraseña para cualquier área en el mismo servidor que es marcado + con el Realm de "Ficheros Restringidos" + Por lo tanto, puedes prevenir que a un usuario se le pida mas de una vez por su + contraseña, compartiendo así varias áreas restringidas el mismo Realm + Por supuesto, por razones de seguridad, el cliente pedirá siempre por una contraseña, + siempre y cuando el nombre del servidor cambie. +

    + +

    La directiva AuthBasicProvider es, + en este caso, opcional, ya que file es el valor por defecto + para esta directiva. Deberás usar esta directiva si estas usando otro medio + diferente para la autenticación, como por ejemplo + mod_authn_dbm o mod_authn_dbd.

    + +

    La directiva AuthUserFile + establece el path al fichero de contraseñas que acabamos de crear con el + comando htpasswd. Si tiene un número muy grande de usuarios, + puede ser realmente lento el buscar el usuario en ese fichero de texto plano + para autenticar a los usuarios en cada petición. + Apache también tiene la habilidad de almacenar información de usuarios en + unos ficheros de rápido acceso a modo de base de datos. + El módulo mod_authn_dbm proporciona la directiva AuthDBMUserFile. Estos ficheros pueden ser creados y + manipulados con el programa dbmmanage y htdbm. + Muchos otros métodos de autenticación así como otras opciones, están disponibles en + módulos de terceros + Base de datos de Módulos disponibles.

    + +

    Finalmente, la directiva Require + proporciona la parte del proceso de autorización estableciendo el o los + usuarios que se les está permitido acceder a una región del servidor. + En la próxima sección, discutiremos las diferentes vías de utilizar la + directiva Require.

    +
    top
    +
    +

    Dejar que más de una persona + entre

    +

    Las directivas mencionadas arriba sólo permiten a una persona + (especialmente con un usuario que en ej ejemplo es rbowen) + en el directorio. En la mayoría de los casos, se querrá permitir el acceso + a más de una persona. Aquí es donde la directiva + AuthGroupFile entra en juego.

    + +

    Si lo que se desea es permitir a más de una persona el acceso, necesitarás + crear un archivo de grupo que asocie los nombres de grupos con el de personas + para permitirles el acceso. El formato de este fichero es bastante sencillo, + y puedes crearlo con tu editor de texto favorito. El contenido del fichero + se parecerá a:

    + +

    + GroupName: rbowen dpitts sungo rshersey +

    + +

    Básicamente eso es la lista de miembros los cuales están en un mismo fichero + de grupo en una sola linea separados por espacios.

    + +

    Para añadir un usuario a tu fichero de contraseñas existente teclee:

    + +

    + htpasswd /usr/local/apache/passwd/passwords dpitts +

    + +

    Te responderá lo mismo que anteriormente, pero se añadirá al fichero + existente en vez de crear uno nuevo. (Es decir el flag -c será + el que haga que se genere un nuevo + fichero de contraseñas).

    + +

    Ahora, tendrá que modificar su fichero .htaccess para que sea + parecido a lo siguiente:

    + + 
    AuthType Basic
+AuthName "By Invitation Only"
+# Optional line:
+AuthBasicProvider file
+AuthUserFile "/usr/local/apache/passwd/passwords"
+AuthGroupFile "/usr/local/apache/passwd/groups"
+Require group GroupName
    + + +

    Ahora, cualquiera que esté listado en el grupo GroupName, + y tiene una entrada en el fichero de contraseñas, se les + permitirá el acceso, si introducen su contraseña correctamente.

    + +

    Hay otra manera de dejar entrar a varios usuarios, que es menos específica. + En lugar de crear un archivo de grupo, sólo puede utilizar la siguiente + directiva:

    + + 
    Require valid-user
    + + +

    Usando ésto en vez de la línea Require user rbowen + permitirá a cualquier persona acceder, la cuál aparece en el archivo de + contraseñas, y que introduzca correctamente su contraseña. Incluso puede + emular el comportamiento del grupo aquí, sólo manteniendo un fichero de + contraseñas independiente para cada grupo. La ventaja de este enfoque es + que Apache sólo tiene que comprobar un archivo, en lugar de dos. La desventaja + es que se tiene que mantener un montón de ficheros de contraseña de grupo, y + recuerde hacer referencia al fichero correcto en la directiva + AuthUserFile.

    +
    top
    +
    +

    Posibles Problemas

    +

    Debido a la forma en que se especifica la autenticación básica, + su nombre de usuario y la contraseña deben ser verificados cada vez + que se solicita un documento desde el servidor. Esto es, incluso si  + se  vuelve a cargar la misma página, y para cada imagen de la página (si +    provienen de un directorio protegido). Como se puede imaginar, esto +    ralentiza las cosas un poco. La cantidad que ralentiza las cosas es + proporcional al tamaño del archivo de contraseñas, porque tiene que + abrir ese archivo, recorrer lista de usuarios hasta que llega a su nombre. + Y tiene que hacer esto cada vez que se carga una página.

    + +

    Una consecuencia de esto, es que hay un limite práctico de cuantos + usuarios puedes introducir en el fichero de contraseñas. Este límite + variará dependiendo de la máquina en la que tengas el servidor, + pero puedes notar ralentizaciones en cuanto se metan cientos de entradas, + y por lo tanto consideraremos entonces otro método de autenticación + en ese momento. +

    +
    top
    +
    +

    Método alternativo de almacenamiento de las + contraseñas

    + +

    Debido a que el almacenamiento de las contraseñas en texto plano tiene + el problema mencionado anteriormente, puede que se prefiera guardar + las contraseñas en otro lugar como por ejemplo una base de datos. +

    + +

    Los módulos mod_authn_dbm y mod_authn_dbd son + dos módulos que hacen esto posible. En vez de seleccionar la directiva de fichero + AuthBasicProvider , en su lugar + se puede elegir dbm o dbd como formato de almacenamiento.

    + +

    Para seleccionar los ficheros de tipo dbm en vez de texto plano, podremos hacer algo parecido a lo siguiente:

    + + 
    <Directory "/www/docs/private">
+    AuthName "Private"
+    AuthType Basic
+    AuthBasicProvider dbm
+    AuthDBMUserFile "/www/passwords/passwd.dbm"
+    Require valid-user
+</Directory>
    + + +

    Hay otras opciones disponibles. Consulta la documentación de + mod_authn_dbm para más detalles.

    +
    top
    +
    +

    Uso de múltiples proveedores

    + +

    Con la introducción de la nueva autenticación basada en un proveedor y + una arquitectura de autorización, ya no estaremos restringidos a un único + método de autenticación o autorización. De hecho, cualquier número de + los proveedores pueden ser mezclados y emparejados para ofrecerle + exactamente el esquema que se adapte a sus necesidades. + En el siguiente ejemplo, veremos como ambos proveedores tanto el fichero + como el LDAP son usados en la autenticación: +

    + + 
    <Directory "/www/docs/private">
+    AuthName "Private"
+    AuthType Basic
+    AuthBasicProvider file ldap
+    AuthUserFile "/usr/local/apache/passwd/passwords"
+    AuthLDAPURL ldap://ldaphost/o=yourorg
+    Require valid-user
+</Directory>
    + + +

    En este ejemplo el fichero, que actúa como proveedor, intentará autenticar + primero al usuario. Si no puede autenticar al usuario, el proveedor del LDAP + será llamado para que realice la autenticación. + Esto permite al ámbito de autenticación ser amplio, si su organización + implementa más de un tipo de almacén de autenticación. + Otros escenarios de autenticación y autorización pueden incluir la + mezcla de un tipo de autenticación con un tipo diferente de autorización. + Por ejemplo, autenticar contra un fichero de contraseñas pero autorizando + dicho acceso mediante el directorio del LDAP.

    + +

    Así como múltiples métodos y proveedores de autenticación pueden + ser implementados, también pueden usarse múltiples formas de + autorización. + En este ejemplo ambos ficheros de autorización de grupo así como + autorización de grupo mediante LDAP va a ser usado: +

    + + 
    <Directory "/www/docs/private">
+    AuthName "Private"
+    AuthType Basic
+    AuthBasicProvider file
+    AuthUserFile "/usr/local/apache/passwd/passwords"
+    AuthLDAPURL ldap://ldaphost/o=yourorg
+    AuthGroupFile "/usr/local/apache/passwd/groups"
+    Require group GroupName
+    Require ldap-group cn=mygroup,o=yourorg
+</Directory>
    + + +

    Para llevar la autorización un poco más lejos, las directivas + de autorización de contenedores tales como + <RequireAll> + and + <RequireAny> + nos permiten aplicar una lógica de en qué orden se manejará la autorización dependiendo + de la configuración y controlada a través de ella. + Mire también Contenedores de + Autorización para ejemplos de cómo pueden ser aplicados.

    + +
    top
    +
    +

    Más allá de la Autorización

    + +

    El modo en que la autorización puede ser aplicada es ahora mucho más flexible + que us solo chequeo contra un almacén de datos (contraseñas). Ordenando la + lógica y escoger la forma en que la autorización es realizada, ahora es posible +

    + +

    Aplicando la lógica y ordenación

    +

    Controlar el cómo y en qué orden se va a aplicar la autorización ha + sido un misterio en el pasado. En Apache 2.2 un proveedor del + mecanismo de autenticación fue introducido para disociar el proceso actual + de autenticación y soportar funcionalidad. + Uno de los beneficios secundarios fue que los proveedores de autenticación + podían ser configurados y llamados en un orden especifico que no dependieran + en el orden de carga del propio modulo. + Este proveedor de dicho mecanismo, ha sido introducido en la autorización + también. Lo que esto significa es que la directiva + Require + no sólo especifica que método de autorización deberá ser usado, si no + también especifica el orden en que van a ser llamados. Múltiples + métodos de autorización son llamados en el mismo orden en que la directiva + Require aparece en la + configuración. +

    + +

    + Con la Introducción del contenedor de directivas de autorización tales como + <RequireAll> + y + <RequireAny>, + La configuración también tiene control sobre cuándo se llaman a los métodos + de autorización y qué criterios determinan cuándo se concede el acceso. + Vease + Contenedores de autorización + Para un ejemplo de cómo pueden ser utilizados para expresar una lógica + más compleja de autorización. +

    + +

    + Por defecto todas las directivas + Require + son manejadas como si estuvieran contenidas en una directiva + <RequireAny>. + En otras palabras, Si alguno de los métodos de autorización + especificados tiene éxito, se concede la autorización. +

    + + + +

    Uso de los proveedores de autorización para + el control de acceso

    + +

    + La autenticación de nombre de usuario y contraseña es sólo parte + de toda la historia que conlleva el proceso. Frecuentemente quiere + dar acceso a la gente en base a algo más que lo que son. + Algo como de donde vienen. +

    + +

    + Los proveedores de autorización all, + env, host y ip + te permiten denegar o permitir el acceso basándose en otros + criterios como el nombre de la máquina o la IP de la máquina que + realiza la consulta para un documento. +

    + +

    + El uso de estos proveedores se especifica a través de la directiva + Require. + La directiva registra los proveedores de autorización que serán llamados + durante la solicitud de la fase del proceso de autorización. Por ejemplo: +

    + + 
    Require ip address
+
    + + +

    + Donde address es una dirección IP (o una dirección IP parcial) + o bien: +

    + + 
    Require host domain_name
+
    + + +

    + Donde domain_name es el nombre completamente cualificado de un nombre + de dominio (FQDN) (o un nombre parcial del dominio); + puede proporcionar múltiples direcciones o nombres de dominio, si se desea. +

    + +

    + Por ejemplo, si alguien envía spam a su tablón de mensajes y desea + mantenerlos alejados, podría hacer lo siguiente:

    + + 
    <RequireAll>
+    Require all granted
+    Require not ip 10.252.46.165
+</RequireAll>
    + + +

    + Visitantes que vengan desde esa IP no serán capaces de ver el contenido + que cubre esta directiva. Si, en cambio, lo que se tiene es el nombre de + la máquina, en vez de la dirección IP, podría usar: +

    + + 
    <RequireAll>
+    Require all granted
+    Require not host host.example.com
+</RequireAll>
    + + +

    + Y, si lo que se quiere es bloquear el acceso desde un determinado dominio + (bloquear el acceso desde el dominio entero), puede especificar parte + de la dirección o del propio dominio a bloquear: +

    + + 
    <RequireAll>
+    Require all granted
+    Require not ip 192.168.205
+    Require not host phishers.example.com moreidiots.example
+    Require not host ke
+</RequireAll>
    + + +

    + Usando <RequireAll> + con múltiples directivas <Require>, cada una negada con un not, + Sólo permitirá el acceso, si todas las condiciones negadas son verdaderas. + En otras palabras, el acceso será bloqueado, si cualquiera de las condiciones + negadas fallara. +

    + + + +

    Compatibilidad de Control de Acceso con versiones + anteriores

    + +

    + Uno de los efectos secundarios de adoptar proveedores basados en + mecanismos de autenticación es que las directivas anteriores + Order, + Allow, + Deny y + Satisfy ya no son necesarias. + Sin embargo, para proporcionar compatibilidad con configuraciones antiguas, + estas directivas se han movido al módulo mod_access_compat. +

    + +

    Nota:

    +

    + Las directivas proporcionadas por mod_access_compat + han quedado obsoletas por mod_authz_host. Mezclar + directivas antiguas como + Order, + Allow ó + Deny con las nuevas + como + Require + es técnicamente posible pero desaconsejable. El módulo + mod_access_compat se creó para soportar configuraciones + que contuvieran sólo directivas antiguas para facilitar la actualización + a la versión 2.4. + Por favor revise la documentación de + actualización para más información al + respecto. +

    +
    + + +
    top
    +
    +

    Cache de Autenticación

    +

    + Puede haber momentos en que la autenticación ponga una carga + inaceptable en el proveedor (de autenticación) o en tu red. + Esto suele afectar a los usuarios de mod_authn_dbd + (u otros proveedores de terceros/personalizados). + Para lidiar con este problema, HTTPD 2.3/2.4 introduce un nuevo proveedor + de caché mod_authn_socache para cachear las credenciales + y reducir la carga en el proveedor(es) original. +

    +

    + Esto puede ofrecer un aumento de rendimiento sustancial para algunos usuarios. +

    +
    top
    +
    +

    Más información

    + +

    + También debería leer la documentación para + mod_auth_basic y mod_authz_host + la cuál contiene más información de como funciona todo esto. + La directiva <AuthnProviderAlias> puede también ayudar + a la hora de simplificar ciertas configuraciones de autenticación. +

    + +

    + Los diferentes algoritmos de cifrado que están soportados por Apache + para la autenticación se explican en + Cifrado de Contraseñas. +

    + +

    + Y tal vez quiera ojear la documentación de "how to" + Control de Acceso donde se mencionan temas + relacionados.

    + +
    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko  | + tr 

    +
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    +//--> \ No newline at end of file diff --git a/docs/manual/howto/auth.html.ja.utf8 b/docs/manual/howto/auth.html.ja.utf8 index 3d96f8f8de..cf215a729a 100644 --- a/docs/manual/howto/auth.html.ja.utf8 +++ b/docs/manual/howto/auth.html.ja.utf8 @@ -24,6 +24,7 @@ Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.4 > How-To / チュートリアル

    認証、承認、アクセス制御

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko  | @@ -659,6 +660,7 @@

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/auth.html.ko.euc-kr b/docs/manual/howto/auth.html.ko.euc-kr index 55790de157..0e815ff582 100644 --- a/docs/manual/howto/auth.html.ko.euc-kr +++ b/docs/manual/howto/auth.html.ko.euc-kr @@ -26,6 +26,7 @@ Á¢±ÙÁ¦¾î(Access Control)

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko  | @@ -322,6 +323,7 @@

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/auth.html.tr.utf8 b/docs/manual/howto/auth.html.tr.utf8 index feb05bfdb5..39c459fa70 100644 --- a/docs/manual/howto/auth.html.tr.utf8 +++ b/docs/manual/howto/auth.html.tr.utf8 @@ -24,6 +24,7 @@ Apache > HTTP Sunucusu > Belgeleme > Sürüm 2.4 > Nasıllar ve Öğreticiler

    Kimlik Doğrulama ve Yetkilendirme

    Mevcut Diller:  en  | + es  |  fr  |  ja  |  ko  | @@ -605,6 +606,7 @@ Require group Grupismi

    Mevcut Diller:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/cgi.html.en b/docs/manual/howto/cgi.html.en index f6a8c366e3..76f7e9a2c0 100644 --- a/docs/manual/howto/cgi.html.en +++ b/docs/manual/howto/cgi.html.en @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4 > How-To / Tutorials

    Apache Tutorial: Dynamic Content with CGI

    Available Languages:  en  | + es  |  fr  |  ja  |  ko 

    @@ -569,6 +570,7 @@ foreach my $key (keys %ENV) {

    Available Languages:  en  | + es  |  fr  |  ja  |  ko 

    diff --git a/docs/manual/howto/cgi.html.es b/docs/manual/howto/cgi.html.es index 5ead2d908c..ac4abb74fb 100644 --- a/docs/manual/howto/cgi.html.es +++ b/docs/manual/howto/cgi.html.es @@ -1,594 +1,594 @@ - - - - + + + + -Tutorial de Apache: Contenido Dinámico con CGI - Servidor Apache HTTP Versión 2.4 - - - - - - -
    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    -
    -
    <-
    -

    Tutorial de Apache: Contenido Dinámico con CGI

    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko 

    -
    -
    - -
    top
    -
    -

    Introducción

    - -
    Módulos RelacionadosDirectivas Relacionadas
    - -

    CGI (Common Gateway Interface) es un método por el cual - un servidor web puede interactuar con programas externos de - generación de contenido, a ellos nos referimos comúnmente como - programas CGI o scripts CGI. Es el método más común y sencillo de - mostrar contenido dinámico en su sitio web. Este documento es una - introducción para configurar CGI en su servidor web Apache, y de - iniciación para escribir programas CGI.

    -
    top
    -
    -

    Configurando Apache para permitir CGI

    - - -

    Para conseguir que sus programas CGI funcionen correctamente, - deberá configurar Apache para que permita la ejecución de CGI. Hay - distintas formas de hacerlo.

    - -
    Nota: Si Apache ha sido compilado con soporte - de módulos compartidos, necesitará que el módulo de CGI esté cargado; - en su httpd.conf tiene que asegurarse de que la directiva - LoadModule - no ha sido comentada. Una directiva configurada correctamente sería así: - - 
    LoadModule cgid_module modules/mod_cgid.so
    - - - En Windows, o si usa un mpm que no es multihilo, como prefork, una - directiva configurada correctamente podría definirse así: - - 
    LoadModule cgi_module modules/mod_cgi.so
    -
    - -

    ScriptAlias

    - - -

    La directiva - ScriptAlias - indica a Apache que un directorio se ha configurado específicamente - para programas CGI. Apache asumirá que cada fichero en este - directorio es un programa CGI, e intentará ejecutarlos cuando un - cliente solicita este recurso.

    - -

    La directiva - ScriptAlias se puede - definir así:

    - - 
    ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"
    - - -

    El ejemplo que se muestra es de un archivo de configuración - httpd.conf por defecto si usted instaló Apache - en la ubicación por defecto. La directiva - ScriptAlias es muy - parecida a la directiva Alias, - ésta define un prefijo de URL que se enlaza a un directorio - en particular. Alias y - ScriptAlias se usan generalmente para - directorios que se encuentran fuera del directorio - DocumentRoot. La diferencia - entre Alias y ScriptAlias - es que en ScriptAlias cualquier elemento - debajo de ese prefijo de URL será considerado un programa CGI. Así, - el ejemplo de más arriba le indica a Apache que - cualquier solicitud para un recurso que comience con - /cgi-bin/ debería servirse desde el directorio - /usr/local/apache2/cgi-bin/, y debería tratarse como un - programa CGI.

    - -

    Por ejemplo, si se solicita la URL - http://www.example.com/cgi-bin/test.pl, - Apache intentará ejecutar el archivo - /usr/local/apache2/cgi-bin/test.pl y dar - el resultado. Por supuesto el archivo debe existir y ser ejecutable, - y dar el resultado de una manera específica o Apache devolverá - un mensaje de error.

    - - -

    CGI fuera de directorios ScriptAlias

    - - -

    Los programas CGI habitualmente se restringen a los directorios de - ScriptAlias por razones de - seguridad. De esta manera, los administradores pueden controlar de una - manera más segura quien puede ejecutar programas CGI. Aun así, si no - se toman suficientes precauciones, no hay ninguna razón por la que - programas CGI no se puedan ejecutar desde directorios seleccionados de - manera arbitraria. Por ejemplo, quizás quiera permitir que usuarios del - sistema tengan contenido web en sus directorios home con la directiva - UserDir. Si quieren - tener sus propios programas CGI, pero no tienen acceso al directorio - principal cgi-bin, necesitarán ser capaces de - ejecutar sus scripts CGI en algún otro sitio.

    - -

    Hay dos pasos a seguir para permitir la ejecución CGI en directorios - seleccionados de manera arbitraria. Primero, el handler - cgi-script debe estar activado usando la directiva - AddHandler o la directiva - SetHandler. Segundo, el parámetro - ExecCGI debe estar definido en la directiva - Options.

    - - -

    Usando Options de manera explícita para permitir ejecución de - CGI

    - - -

    Puede usar la directiva - Options, en el archivo de - configuración principal para especificar que se permite la ejecución - de CGI en un directorio en particular:

    - - 
    <Directory "/usr/local/apache2/htdocs/somedir">
-    Options +ExecCGI
-</Directory>
    - - -

    Esta directiva de aquí arriba le indica a Apache que debe - permitir la ejecución de archivos CGI. También necesitará indicarle - al servidor que los archivos son archivos CGI. La directiva - AddHandler le indica al - servidor que debe tratar a todos los archivos con la extensión - cgi o pl como programas CGI:

    - - 
    AddHandler cgi-script .cgi .pl
    - - - -

    Ficheros .htaccess

    - - -

    El tutorial .htaccess - enseña como activar programas CGI si no tienes acceso a - httpd.conf.

    - - -

    Directorios de Usuario

    - - -

    Para permitir la ejecución de programas CGI para cualquier - archivo que acabe en .cgi en directorios de usuario, - puedes usar la siguiente configuración:

    - - 
    <Directory "/home/*/public_html">
-    Options +ExecCGI
-    AddHandler cgi-script .cgi
-</Directory>
    - - -

    Si quiere designar un subdirectorio cgi-bin dentro - de un directorio de usuario en el que todos los ficheros serán - tratados como un programa CGI, puede usar lo siguiente:

    - - 
    <Directory "/home/*/public_html/cgi-bin">
-    Options ExecCGI
-    SetHandler cgi-script
-</Directory>
    - - -
    top
    -
    -

    Escribiendo un programa CGI

    - - -

    Hay dos diferencias principales entre programación ``regular'' y - programación en CGI.

    - -

    Primera, el resultado al completo de tu programa CGI debe estar - precedido de una cabecera MIME-type. Esta - cabecera HTTP le indica al cliente que tipo de contenido está - recibiendo. La mayor parte de las veces, ésto será algo como:

    - -

    - Content-type: text/html -

    - -

    Segunda, el resultado debe estar en formato HTML, o cualquier - otro formato que su navegador sea capaz de mostrar. La mayor - parte de las veces, será HTML, pero otras escribirá un programa - CGI que devuelve una imagen gif, u otro contenido no-HTML.

    - -

    Aparte de estas dos cosas, escribir un programa en CGI se - parecerá bastante a cualquier otro programa que vaya a escribir. -

    - - -

    Su primer programa CGI

    - - -

    A continuación podrá ver un ejemplo de programa CGI que muestra - una línea de texto en su navegador. Escriba lo siguiente, - guárdelo en un archivo con el nombre first.pl, y - póngalo en su directorio cgi-bin.

    - - 
    #!/usr/bin/perl
-print "Content-type: text/html\n\n";
-print "Hola, Mundo.";
    - - -

    Incluso si Perl no le resulta familiar, podrá ver lo que está - ocurriendo aquí. La primera línea le dice a Apache (o a - cualquier shell en la que se esté ejecutando) que este programa - puede ejecutarse con el intérprete en la ubicación - /usr/bin/perl. La segunda línea imprime la - declaración de Content-Type que mencionamos antes, seguida de - dos pares de retornos de carro. Esto pone una línea en blanco - después de la cabecera para indicar el final de las cabeceras - HTTP, y el comienzo del cuerpo del contenido. La tercera - imprime la cadena de caracteres "Hola, Mundo.". Y ese es el - final del programa.

    - -

    Si lo abre con su navegador favorito y le dice que solicite la - dirección

    - -

    - http://www.example.com/cgi-bin/first.pl -

    - -

    o donde quiera que pusiera el archivo, verá una línea - Hola, Mundo. aparecerán la ventana del navegador. No es - muy emocionante, pero una vez que consiga que funcione podrá hacer - lo mismo con casi cualquier programa.

    - -
    top
    -
    -

    ¡Pero todavía no funciona!

    - - -

    Hay 4 cosas básicas que puede llegar a ver en su navegador cuando - intenta acceder a un programa CGI desde la web:

    - -
    -
    El resultado del programa CGI
    -
    ¡Genial! Esto indica que todo funcionó correctamente. Si el - resultado es correcto, pero el navegador no lo procesa - correctamente, asegúrese de que tiene especificado - correctamente el Content-Type en su programa - CGI.
    - -
    El código fuente de su programa CGI o un mensaje del tipo - "POST Method Not Allowed".
    - -
    Eso significa que no ha configurado Apache de manera - apropiada para interpretar su programa CGI. Relea la sección - de Configurando Apache e intente - encontrar qué le falta.
    - -
    Un mensaje que empieza con "Forbidden"
    -
    Eso significa que hay un problema de permisos. Compruebe el - Log de Errores de Apache y la - sección de más abajo de Permisos de - Fichero.
    - -
    Un mensaje indicando "Internal Server Error"
    -
    Si comprueba el Log de errores de - Apache, probablemente encontrará que indica "Premature - end of script headers", posiblemente acompañado de otro - mensaje de error generado por su programa CGI. En este caso, - querrá comprobar cada una de las secciones de más adelante - para ver qué impide que su programa CGI genere las cabeceras - HTTP adecuadas.
    -
    - -

    Permisos de Fichero

    - - -

    Recuerde que el servidor no se ejecuta con su usuario. Es decir, - cuando el servidor arranca, está funcionando con un usuario sin - privilegios, generalmente el usuario nobody, o - www-data, así que necesitará permisos extra para - ejecutar los archivos de los que usted es dueño. Generalmente, - el método para dar permisos suficientes para que se pueda - ejecutar con nobody es dar permisos de ejecución a - todo el mundo en el fichero:

    - -

    - chmod a+x first.pl -

    - -

    Además, si su programa lee desde o escribe a cualquier otro/s - archivo/s, esos archivos necesitarán tener los permisos correctos - para permitir esas acciones.

    - - - -

    Información de Ruta y Entorno

    - - -

    Cuando ejecuta un programa desde la línea de comandos, usted tiene - cierta información que se le pasa a la shell sin que usted se - percate de ello. Por ejemplo, usted tiene un PATH, - que le indica a la shell dónde debe buscar archivos a los que usted - hace referencia.

    - -

    Cuando un programa se ejecuta a través del servidor web como un - programa CGI, puede que no tenga el mismo PATH. - Cualquier programa que invoque desde su programa CGI (como por - ejemplo sendmail) necesitará que se le indique la - ruta absoluta, así la shell puede encontrarlos cuando intenta - ejecutar su programa CGI.

    - -

    Una manifestación común de esto es la ruta del intérprete del - script (a menudo perl) indicado en la primera línea - de su programa CGI, que parecerá algo como:

    - - 
    #!/usr/bin/perl
    - - -

    Asegúrese de que éste es de hecho el path de su intérprete.

    -
    - Cuando edita scripts CGI en Windows, los caracteres de retorno de - carro podrían añadirse a la línea donde se especifica el intérprete. - Asegúrese de que los archivos se transfieren al servidor en modo - ASCII. Fallar en esto puede acabar con avisos del tipo "Command not - found" del Sistema Operativo, debido a que éste no reconoce los - caracteres de final de línea interpretados como parte del nombre - de fichero del intérprete. -
    - - -

    Faltan Variables de Entorno

    - - -

    Si su programa CGI depende de variables de entorno no estándar, necesitará - asegurarse de que Apache pasa esas variables.

    - -

    Cuando no encuentra ciertas cabeceras HTTP del entorno, asegúrese - de que están formateadas según el - RFC 2616, - sección 4.2: Nombres de Cabeceras deben empezar con una letra, - seguida solo de letras, números o guión. Cualquier cabecera - que no cumpla esta regla será ignorada de manera silenciosa.

    - - - -

    Errores de Programa

    - - -

    La mayor parte de las veces cuando un programa CGI falla, es por un - problema en el programa mismo. Esto ocurre generalmente cuando se - maneja bien con "esto del CGI", y ya no comete los dos errores - mencionados más arriba. Lo primero que hay que hacer es asegurarse - de que su programa se ejecuta correctamente en línea de comandos - antes de probarlo a través del servidor web. Por ejemplo, - intente:

    - -

    - cd /usr/local/apache2/cgi-bin
    - ./first.pl -

    - -

    (No llame al intérprete de perl. La consola y Apache - tienen que poder encontrar el intérprete usando línea - línea de información en la primera - línea del script.)

    - -

    Lo primero que debe ver escrito por su programa es un conjunto de - cabeceras HTTP, incluyendo el Content-Type, - seguido de una línea en blanco. Si ve alguna otra cosa, Apache - devolverá el error Premature end of script headers si - intenta lanzar el script en el servidor web. Vea - Escribiendo un programa CGI más arriba para - más detalle.

    - - -

    Log de Errores

    - - -

    El log de errores es su amigo. Cualquier cosa que vaya mal generará - un mensaje en el log de errores. Debería mirar siempre ahí primero. - Si el lugar donde está alojando su sitio web no permite que acceda - al log de errores, probablemente debería alojarlo en otro sitio. - Aprenda a leer el log de errores y se dará cuenta de que enseguida - averiguará el motivo del error y lo solucionará rápidamente.

    - - -

    Suexec

    - - -

    El programa de soporte suexec permite - que programas CGI se ejecuten con permisos de usuario distintos, - dependiendo del virtualhost o el directorio home donde se - encuentren. Suexec tiene una comprobación de permisos muy estricta, - y cualquier fallo en esa comprobación dará como resultado un error - con el mensaje Premature end of script headers.

    - -

    Para comprobar si está usando Suexec, ejecute - apachectl -V y compruebe la ubicación de - SUEXEC_BIN. Si Apache encuentra un binario - suexec al arrancar, suexec se activará.

    - -

    A menos que comprenda suxec perfectamente, no debería usarlo. - Para desactivar suexec, basta con eliminar el binario - suexec al que apunta SUEXEC_BIN y - reiniciar el servidor. Si después de leer sobre - suexec todavía quiere usarlo, entonces - ejecute suexec -V para encontrar la ubicación del - fichero log de suexec, y use ese log para encontrar que política no - está cumpliendo.

    - -
    top
    -
    -

    ¿Qué ocurre entre bastidores?

    - - -

    En cuanto tenga conocimiento avanzado de programación CGI, le será - útil comprender más de lo que ocurre entre bastidores. - Específicamente, cómo el navegador y el servidor se comunican el uno - con el otro. Porque aunque esté muy bien escribir un programa que - diga "Hola, Mundo.", no tiene una gran utilidad.

    - -

    Variables de Entorno

    - - -

    Las variables de entorno son valores que están ahí cuando - usa el ordenador. Son cosas útiles como el path (donde su ordenador - busca el archivo específico que se lanza cuando usted escribe un - comando), su nombre de usuario, el tipo de terminal que usa, etc. - Para una lista completa de la variables de entorno normales que se - se usan en su día a día escriba env en la línea de - comandos.

    - -

    Durante la transacción CGI, el servidor y el navegador también - configuran variables de entorno, y así pueden comunicarse entre - ellos. Cosas como el tipo de navegador (Netscape, IE, Lynx), el tipo - de servidor (Apache, IIS, WebSite), el nombre del programa CGI que - se está ejecutando, etc.

    - -

    Estas variables están disponibles para el programador de CGI, y son - la mitad de la historia de la comunicación cliente-servidor. La - lista completa de las variables necesarias se encuentra en - el RFC de Common Gateway - Interface.

    - -

    Este sencillo programa CGI en Perl mostrará todas las variables - de entorno que se están pasando entre el cliente y el navegador. Dos - programas similares están incluidos en el directorio - cgi-bin de la distribución de Apache. Tenga en cuenta - que algunas variables son necesarias mientras que otras son - opcionales, así que es posible que vea algunas variables que no - están en la lista oficial. Adicionalmente, Apache aporta distintas - maneras diferentes para que pueda - añadir sus variables de entorno a las - básicas que se proveen por defecto.

    - - 
    #!/usr/bin/perl
-use strict;
-use warnings;
-
-print "Content-type: text/html\n\n";
-          
-foreach my $key (keys %ENV) {
-    print "$key --> $ENV{$key}<br>";
-}
    - - - -

    STDIN y STDOUT

    - - -

    Otra comunicación entre el servidor y el cliente ocurre en la - entrada estándar (STDIN) y la salida estándar - (STDOUT). En el contexto normal de cada día, - STDIN es la entrada con el teclado, o un fichero que se - le da a un programa para que actúe sobre él, y STDOUT - generalmente es la consola o la pantalla.

    - -

    Cuando hace POST con un formulario de web a un programa - CGI, los datos en ese formulario se empaquetan en un formato especial - que se entrega a su programa CGI en el STDIN. - Entonces el programa puede procesar la información como si le llegara - desde el teclado, o desde un fichero.

    - -

    El "formato especial" es muy sencillo. Un nombre de campo y su - valor se asocian juntos con el signo igual (=), y pares de valores - se asocian juntos con el ampersand ó et en español (&). - Caracteres inconvenientes como los espacios, ampersands y signos de - igual, se convierten en su equivalente hexadecimal para no impidan - el funcionamiento correcto del programa. La cadena de datos al - completo será algo como:

    - -

    - name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey -

    - -

    A veces tendrá este tipo de cadena de caracteres al final de una - URL. Cuando esto ocurre, el servidor pone esa cadena en una variable - de entorno que se llama QUERY_STRING. Esto se llama - solicitud GET. Su formulario HTML especifica si se usa - un GET o un POST para entregar la - información, configurando el atributo METHOD en la - etiqueta FORM.

    - -

    Su programa es el responsable de convertir esa cadena de - caracteres en información útil. Afortunadamente, hay librerías y - módulos disponibles que ayudan a procesar la información, así como a - gestionar los distintos aspectos de su programa CGI.

    - -
    top
    -
    -

    Módulos/librerías CGI

    - - -

    Cuando escribe programas CGI, debería considerar usar una librería de - código, o módulo, para hacer todo el trabajo más arduo por usted. - Esto lleva a tener menos errores y un desarrollo de código más - rápido.

    - -

    Si está escribiendo un programa CGI en Perl, existen módulos - disponibles en CPAN. El módulo más - conocido para este propósito es CGI.pm. Quizás quiera - considerar CGI::Lite, que implementa una funcionalidad - mínima, que es todo lo que se necesita en la mayoría de los programas.

    - -

    Si está escribiendo programas CGI en C, hay varidad de opciones. Una - de estas es la librería CGIC, de - http://www.boutell.com/cgic/. -

    -
    top
    -
    -

    Para más información

    - - -

    La especificación actual de CGI está disponible en el - RFC de Common Gateway - Interface.

    - -

    Cuando envíe una pregunta sobre un problema de CGI, o bien a una - lista de correo, o a un grupo de noticias, asegúrese de que facilita suficiente - información de lo que ha ocurrido, de lo que espera que ocurra, y de - lo que está ocurriendo en su lugar que es diferente, el servidor que - está ejecutando, en qué lenguaje CGI está hecho su programa, y si es - posible, el código que falla. Esto hará encontrar el problema mucho más - fácil.

    - -

    Tenga en cuenta que las preguntas sobre problemas CGI - nunca deberían enviarse a la base de datos de bugs de - bugs de Apache a menos que esté seguro de haber encontrado un - problema en el código fuente de Apache.

    -
    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko 

    -
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    + --> +Tutorial de Apache: Contenido Dinámico con CGI - Servidor Apache HTTP Versión 2.4 + + + + + + +
    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    +
    +
    <-
    +

    Tutorial de Apache: Contenido Dinámico con CGI

    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko 

    +
    +
    + +
    top
    +
    +

    Introducción

    + +
    Módulos RelacionadosDirectivas Relacionadas
    + +

    CGI (Common Gateway Interface) es un método por el cual + un servidor web puede interactuar con programas externos de + generación de contenido, a ellos nos referimos comúnmente como + programas CGI o scripts CGI. Es el método más común y sencillo de + mostrar contenido dinámico en su sitio web. Este documento es una + introducción para configurar CGI en su servidor web Apache, y de + iniciación para escribir programas CGI.

    +
    top
    +
    +

    Configurando Apache para permitir CGI

    + + +

    Para conseguir que sus programas CGI funcionen correctamente, + deberá configurar Apache para que permita la ejecución de CGI. Hay + distintas formas de hacerlo.

    + +
    Nota: Si Apache ha sido compilado con soporte + de módulos compartidos, necesitará que el módulo de CGI esté cargado; + en su httpd.conf tiene que asegurarse de que la directiva + LoadModule + no ha sido comentada. Una directiva configurada correctamente sería así: + + 
    LoadModule cgid_module modules/mod_cgid.so
    + + + En Windows, o si usa un mpm que no es multihilo, como prefork, una + directiva configurada correctamente podría definirse así: + + 
    LoadModule cgi_module modules/mod_cgi.so
    +
    + +

    ScriptAlias

    + + +

    La directiva + ScriptAlias + indica a Apache que un directorio se ha configurado específicamente + para programas CGI. Apache asumirá que cada fichero en este + directorio es un programa CGI, e intentará ejecutarlos cuando un + cliente solicita este recurso.

    + +

    La directiva + ScriptAlias se puede + definir así:

    + + 
    ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"
    + + +

    El ejemplo que se muestra es de un archivo de configuración + httpd.conf por defecto si usted instaló Apache + en la ubicación por defecto. La directiva + ScriptAlias es muy + parecida a la directiva Alias, + ésta define un prefijo de URL que se enlaza a un directorio + en particular. Alias y + ScriptAlias se usan generalmente para + directorios que se encuentran fuera del directorio + DocumentRoot. La diferencia + entre Alias y ScriptAlias + es que en ScriptAlias cualquier elemento + debajo de ese prefijo de URL será considerado un programa CGI. Así, + el ejemplo de más arriba le indica a Apache que + cualquier solicitud para un recurso que comience con + /cgi-bin/ debería servirse desde el directorio + /usr/local/apache2/cgi-bin/, y debería tratarse como un + programa CGI.

    + +

    Por ejemplo, si se solicita la URL + http://www.example.com/cgi-bin/test.pl, + Apache intentará ejecutar el archivo + /usr/local/apache2/cgi-bin/test.pl y dar + el resultado. Por supuesto el archivo debe existir y ser ejecutable, + y dar el resultado de una manera específica o Apache devolverá + un mensaje de error.

    + + +

    CGI fuera de directorios ScriptAlias

    + + +

    Los programas CGI habitualmente se restringen a los directorios de + ScriptAlias por razones de + seguridad. De esta manera, los administradores pueden controlar de una + manera más segura quien puede ejecutar programas CGI. Aun así, si no + se toman suficientes precauciones, no hay ninguna razón por la que + programas CGI no se puedan ejecutar desde directorios seleccionados de + manera arbitraria. Por ejemplo, quizás quiera permitir que usuarios del + sistema tengan contenido web en sus directorios home con la directiva + UserDir. Si quieren + tener sus propios programas CGI, pero no tienen acceso al directorio + principal cgi-bin, necesitarán ser capaces de + ejecutar sus scripts CGI en algún otro sitio.

    + +

    Hay dos pasos a seguir para permitir la ejecución CGI en directorios + seleccionados de manera arbitraria. Primero, el handler + cgi-script debe estar activado usando la directiva + AddHandler o la directiva + SetHandler. Segundo, el parámetro + ExecCGI debe estar definido en la directiva + Options.

    + + +

    Usando Options de manera explícita para permitir ejecución de + CGI

    + + +

    Puede usar la directiva + Options, en el archivo de + configuración principal para especificar que se permite la ejecución + de CGI en un directorio en particular:

    + + 
    <Directory "/usr/local/apache2/htdocs/somedir">
+    Options +ExecCGI
+</Directory>
    + + +

    Esta directiva de aquí arriba le indica a Apache que debe + permitir la ejecución de archivos CGI. También necesitará indicarle + al servidor que los archivos son archivos CGI. La directiva + AddHandler le indica al + servidor que debe tratar a todos los archivos con la extensión + cgi o pl como programas CGI:

    + + 
    AddHandler cgi-script .cgi .pl
    + + + +

    Ficheros .htaccess

    + + +

    El tutorial .htaccess + enseña como activar programas CGI si no tienes acceso a + httpd.conf.

    + + +

    Directorios de Usuario

    + + +

    Para permitir la ejecución de programas CGI para cualquier + archivo que acabe en .cgi en directorios de usuario, + puedes usar la siguiente configuración:

    + + 
    <Directory "/home/*/public_html">
+    Options +ExecCGI
+    AddHandler cgi-script .cgi
+</Directory>
    + + +

    Si quiere designar un subdirectorio cgi-bin dentro + de un directorio de usuario en el que todos los ficheros serán + tratados como un programa CGI, puede usar lo siguiente:

    + + 
    <Directory "/home/*/public_html/cgi-bin">
+    Options ExecCGI
+    SetHandler cgi-script
+</Directory>
    + + +
    top
    +
    +

    Escribiendo un programa CGI

    + + +

    Hay dos diferencias principales entre programación ``regular'' y + programación en CGI.

    + +

    Primera, el resultado al completo de tu programa CGI debe estar + precedido de una cabecera MIME-type. Esta + cabecera HTTP le indica al cliente que tipo de contenido está + recibiendo. La mayor parte de las veces, ésto será algo como:

    + +

    + Content-type: text/html +

    + +

    Segunda, el resultado debe estar en formato HTML, o cualquier + otro formato que su navegador sea capaz de mostrar. La mayor + parte de las veces, será HTML, pero otras escribirá un programa + CGI que devuelve una imagen gif, u otro contenido no-HTML.

    + +

    Aparte de estas dos cosas, escribir un programa en CGI se + parecerá bastante a cualquier otro programa que vaya a escribir. +

    + + +

    Su primer programa CGI

    + + +

    A continuación podrá ver un ejemplo de programa CGI que muestra + una línea de texto en su navegador. Escriba lo siguiente, + guárdelo en un archivo con el nombre first.pl, y + póngalo en su directorio cgi-bin.

    + + 
    #!/usr/bin/perl
+print "Content-type: text/html\n\n";
+print "Hola, Mundo.";
    + + +

    Incluso si Perl no le resulta familiar, podrá ver lo que está + ocurriendo aquí. La primera línea le dice a Apache (o a + cualquier shell en la que se esté ejecutando) que este programa + puede ejecutarse con el intérprete en la ubicación + /usr/bin/perl. La segunda línea imprime la + declaración de Content-Type que mencionamos antes, seguida de + dos pares de retornos de carro. Esto pone una línea en blanco + después de la cabecera para indicar el final de las cabeceras + HTTP, y el comienzo del cuerpo del contenido. La tercera + imprime la cadena de caracteres "Hola, Mundo.". Y ese es el + final del programa.

    + +

    Si lo abre con su navegador favorito y le dice que solicite la + dirección

    + +

    + http://www.example.com/cgi-bin/first.pl +

    + +

    o donde quiera que pusiera el archivo, verá una línea + Hola, Mundo. aparecerán la ventana del navegador. No es + muy emocionante, pero una vez que consiga que funcione podrá hacer + lo mismo con casi cualquier programa.

    + +
    top
    +
    +

    ¡Pero todavía no funciona!

    + + +

    Hay 4 cosas básicas que puede llegar a ver en su navegador cuando + intenta acceder a un programa CGI desde la web:

    + +
    +
    El resultado del programa CGI
    +
    ¡Genial! Esto indica que todo funcionó correctamente. Si el + resultado es correcto, pero el navegador no lo procesa + correctamente, asegúrese de que tiene especificado + correctamente el Content-Type en su programa + CGI.
    + +
    El código fuente de su programa CGI o un mensaje del tipo + "POST Method Not Allowed".
    + +
    Eso significa que no ha configurado Apache de manera + apropiada para interpretar su programa CGI. Relea la sección + de Configurando Apache e intente + encontrar qué le falta.
    + +
    Un mensaje que empieza con "Forbidden"
    +
    Eso significa que hay un problema de permisos. Compruebe el + Log de Errores de Apache y la + sección de más abajo de Permisos de + Fichero.
    + +
    Un mensaje indicando "Internal Server Error"
    +
    Si comprueba el Log de errores de + Apache, probablemente encontrará que indica "Premature + end of script headers", posiblemente acompañado de otro + mensaje de error generado por su programa CGI. En este caso, + querrá comprobar cada una de las secciones de más adelante + para ver qué impide que su programa CGI genere las cabeceras + HTTP adecuadas.
    +
    + +

    Permisos de Fichero

    + + +

    Recuerde que el servidor no se ejecuta con su usuario. Es decir, + cuando el servidor arranca, está funcionando con un usuario sin + privilegios, generalmente el usuario nobody, o + www-data, así que necesitará permisos extra para + ejecutar los archivos de los que usted es dueño. Generalmente, + el método para dar permisos suficientes para que se pueda + ejecutar con nobody es dar permisos de ejecución a + todo el mundo en el fichero:

    + +

    + chmod a+x first.pl +

    + +

    Además, si su programa lee desde o escribe a cualquier otro/s + archivo/s, esos archivos necesitarán tener los permisos correctos + para permitir esas acciones.

    + + + +

    Información de Ruta y Entorno

    + + +

    Cuando ejecuta un programa desde la línea de comandos, usted tiene + cierta información que se le pasa a la shell sin que usted se + percate de ello. Por ejemplo, usted tiene un PATH, + que le indica a la shell dónde debe buscar archivos a los que usted + hace referencia.

    + +

    Cuando un programa se ejecuta a través del servidor web como un + programa CGI, puede que no tenga el mismo PATH. + Cualquier programa que invoque desde su programa CGI (como por + ejemplo sendmail) necesitará que se le indique la + ruta absoluta, así la shell puede encontrarlos cuando intenta + ejecutar su programa CGI.

    + +

    Una manifestación común de esto es la ruta del intérprete del + script (a menudo perl) indicado en la primera línea + de su programa CGI, que parecerá algo como:

    + + 
    #!/usr/bin/perl
    + + +

    Asegúrese de que éste es de hecho el path de su intérprete.

    +
    + Cuando edita scripts CGI en Windows, los caracteres de retorno de + carro podrían añadirse a la línea donde se especifica el intérprete. + Asegúrese de que los archivos se transfieren al servidor en modo + ASCII. Fallar en esto puede acabar con avisos del tipo "Command not + found" del Sistema Operativo, debido a que éste no reconoce los + caracteres de final de línea interpretados como parte del nombre + de fichero del intérprete. +
    + + +

    Faltan Variables de Entorno

    + + +

    Si su programa CGI depende de variables de entorno no estándar, necesitará + asegurarse de que Apache pasa esas variables.

    + +

    Cuando no encuentra ciertas cabeceras HTTP del entorno, asegúrese + de que están formateadas según el + RFC 2616, + sección 4.2: Nombres de Cabeceras deben empezar con una letra, + seguida solo de letras, números o guión. Cualquier cabecera + que no cumpla esta regla será ignorada de manera silenciosa.

    + + + +

    Errores de Programa

    + + +

    La mayor parte de las veces cuando un programa CGI falla, es por un + problema en el programa mismo. Esto ocurre generalmente cuando se + maneja bien con "esto del CGI", y ya no comete los dos errores + mencionados más arriba. Lo primero que hay que hacer es asegurarse + de que su programa se ejecuta correctamente en línea de comandos + antes de probarlo a través del servidor web. Por ejemplo, + intente:

    + +

    + cd /usr/local/apache2/cgi-bin
    + ./first.pl +

    + +

    (No llame al intérprete de perl. La consola y Apache + tienen que poder encontrar el intérprete usando línea + línea de información en la primera + línea del script.)

    + +

    Lo primero que debe ver escrito por su programa es un conjunto de + cabeceras HTTP, incluyendo el Content-Type, + seguido de una línea en blanco. Si ve alguna otra cosa, Apache + devolverá el error Premature end of script headers si + intenta lanzar el script en el servidor web. Vea + Escribiendo un programa CGI más arriba para + más detalle.

    + + +

    Log de Errores

    + + +

    El log de errores es su amigo. Cualquier cosa que vaya mal generará + un mensaje en el log de errores. Debería mirar siempre ahí primero. + Si el lugar donde está alojando su sitio web no permite que acceda + al log de errores, probablemente debería alojarlo en otro sitio. + Aprenda a leer el log de errores y se dará cuenta de que enseguida + averiguará el motivo del error y lo solucionará rápidamente.

    + + +

    Suexec

    + + +

    El programa de soporte suexec permite + que programas CGI se ejecuten con permisos de usuario distintos, + dependiendo del virtualhost o el directorio home donde se + encuentren. Suexec tiene una comprobación de permisos muy estricta, + y cualquier fallo en esa comprobación dará como resultado un error + con el mensaje Premature end of script headers.

    + +

    Para comprobar si está usando Suexec, ejecute + apachectl -V y compruebe la ubicación de + SUEXEC_BIN. Si Apache encuentra un binario + suexec al arrancar, suexec se activará.

    + +

    A menos que comprenda suxec perfectamente, no debería usarlo. + Para desactivar suexec, basta con eliminar el binario + suexec al que apunta SUEXEC_BIN y + reiniciar el servidor. Si después de leer sobre + suexec todavía quiere usarlo, entonces + ejecute suexec -V para encontrar la ubicación del + fichero log de suexec, y use ese log para encontrar que política no + está cumpliendo.

    + +
    top
    +
    +

    ¿Qué ocurre entre bastidores?

    + + +

    En cuanto tenga conocimiento avanzado de programación CGI, le será + útil comprender más de lo que ocurre entre bastidores. + Específicamente, cómo el navegador y el servidor se comunican el uno + con el otro. Porque aunque esté muy bien escribir un programa que + diga "Hola, Mundo.", no tiene una gran utilidad.

    + +

    Variables de Entorno

    + + +

    Las variables de entorno son valores que están ahí cuando + usa el ordenador. Son cosas útiles como el path (donde su ordenador + busca el archivo específico que se lanza cuando usted escribe un + comando), su nombre de usuario, el tipo de terminal que usa, etc. + Para una lista completa de la variables de entorno normales que se + se usan en su día a día escriba env en la línea de + comandos.

    + +

    Durante la transacción CGI, el servidor y el navegador también + configuran variables de entorno, y así pueden comunicarse entre + ellos. Cosas como el tipo de navegador (Netscape, IE, Lynx), el tipo + de servidor (Apache, IIS, WebSite), el nombre del programa CGI que + se está ejecutando, etc.

    + +

    Estas variables están disponibles para el programador de CGI, y son + la mitad de la historia de la comunicación cliente-servidor. La + lista completa de las variables necesarias se encuentra en + el RFC de Common Gateway + Interface.

    + +

    Este sencillo programa CGI en Perl mostrará todas las variables + de entorno que se están pasando entre el cliente y el navegador. Dos + programas similares están incluidos en el directorio + cgi-bin de la distribución de Apache. Tenga en cuenta + que algunas variables son necesarias mientras que otras son + opcionales, así que es posible que vea algunas variables que no + están en la lista oficial. Adicionalmente, Apache aporta distintas + maneras diferentes para que pueda + añadir sus variables de entorno a las + básicas que se proveen por defecto.

    + + 
    #!/usr/bin/perl
+use strict;
+use warnings;
+
+print "Content-type: text/html\n\n";
+          
+foreach my $key (keys %ENV) {
+    print "$key --> $ENV{$key}<br>";
+}
    + + + +

    STDIN y STDOUT

    + + +

    Otra comunicación entre el servidor y el cliente ocurre en la + entrada estándar (STDIN) y la salida estándar + (STDOUT). En el contexto normal de cada día, + STDIN es la entrada con el teclado, o un fichero que se + le da a un programa para que actúe sobre él, y STDOUT + generalmente es la consola o la pantalla.

    + +

    Cuando hace POST con un formulario de web a un programa + CGI, los datos en ese formulario se empaquetan en un formato especial + que se entrega a su programa CGI en el STDIN. + Entonces el programa puede procesar la información como si le llegara + desde el teclado, o desde un fichero.

    + +

    El "formato especial" es muy sencillo. Un nombre de campo y su + valor se asocian juntos con el signo igual (=), y pares de valores + se asocian juntos con el ampersand ó et en español (&). + Caracteres inconvenientes como los espacios, ampersands y signos de + igual, se convierten en su equivalente hexadecimal para no impidan + el funcionamiento correcto del programa. La cadena de datos al + completo será algo como:

    + +

    + name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey +

    + +

    A veces tendrá este tipo de cadena de caracteres al final de una + URL. Cuando esto ocurre, el servidor pone esa cadena en una variable + de entorno que se llama QUERY_STRING. Esto se llama + solicitud GET. Su formulario HTML especifica si se usa + un GET o un POST para entregar la + información, configurando el atributo METHOD en la + etiqueta FORM.

    + +

    Su programa es el responsable de convertir esa cadena de + caracteres en información útil. Afortunadamente, hay librerías y + módulos disponibles que ayudan a procesar la información, así como a + gestionar los distintos aspectos de su programa CGI.

    + +
    top
    +
    +

    Módulos/librerías CGI

    + + +

    Cuando escribe programas CGI, debería considerar usar una librería de + código, o módulo, para hacer todo el trabajo más arduo por usted. + Esto lleva a tener menos errores y un desarrollo de código más + rápido.

    + +

    Si está escribiendo un programa CGI en Perl, existen módulos + disponibles en CPAN. El módulo más + conocido para este propósito es CGI.pm. Quizás quiera + considerar CGI::Lite, que implementa una funcionalidad + mínima, que es todo lo que se necesita en la mayoría de los programas.

    + +

    Si está escribiendo programas CGI en C, hay varidad de opciones. Una + de estas es la librería CGIC, de + http://www.boutell.com/cgic/. +

    +
    top
    +
    +

    Para más información

    + + +

    La especificación actual de CGI está disponible en el + RFC de Common Gateway + Interface.

    + +

    Cuando envíe una pregunta sobre un problema de CGI, o bien a una + lista de correo, o a un grupo de noticias, asegúrese de que facilita suficiente + información de lo que ha ocurrido, de lo que espera que ocurra, y de + lo que está ocurriendo en su lugar que es diferente, el servidor que + está ejecutando, en qué lenguaje CGI está hecho su programa, y si es + posible, el código que falla. Esto hará encontrar el problema mucho más + fácil.

    + +

    Tenga en cuenta que las preguntas sobre problemas CGI + nunca deberían enviarse a la base de datos de bugs de + bugs de Apache a menos que esté seguro de haber encontrado un + problema en el código fuente de Apache.

    +
    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko 

    +
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    +//--> \ No newline at end of file diff --git a/docs/manual/howto/cgi.html.ja.utf8 b/docs/manual/howto/cgi.html.ja.utf8 index 629eceed1d..cedc13247c 100644 --- a/docs/manual/howto/cgi.html.ja.utf8 +++ b/docs/manual/howto/cgi.html.ja.utf8 @@ -24,6 +24,7 @@ Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.4 > How-To / チュートリアル

    Apache Tutorial: CGI による動的コンテンツ

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko 

    @@ -561,6 +562,7 @@

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko 

    diff --git a/docs/manual/howto/cgi.html.ko.euc-kr b/docs/manual/howto/cgi.html.ko.euc-kr index 69385a681f..f935e99e9e 100644 --- a/docs/manual/howto/cgi.html.ko.euc-kr +++ b/docs/manual/howto/cgi.html.ko.euc-kr @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4 > How-To / Tutorials

    ¾ÆÆÄÄ¡ ÅõÅ丮¾ó: CGI¸¦ »ç¿ëÇÑ µ¿Àû ÆäÀÌÁö »ý¼º

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko 

    @@ -501,6 +502,7 @@

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko 

    diff --git a/docs/manual/howto/htaccess.html.en b/docs/manual/howto/htaccess.html.en index 436bfae26d..5ff3baf656 100644 --- a/docs/manual/howto/htaccess.html.en +++ b/docs/manual/howto/htaccess.html.en @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4 > How-To / Tutorials

    Apache HTTP Server Tutorial: .htaccess files

    Available Languages:  en  | + es  |  fr  |  ja  |  ko  | @@ -432,6 +433,7 @@ SetHandler cgi-script

    Available Languages:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/htaccess.html.es b/docs/manual/howto/htaccess.html.es index f4db6d769c..c6e7458540 100644 --- a/docs/manual/howto/htaccess.html.es +++ b/docs/manual/howto/htaccess.html.es @@ -1,443 +1,443 @@ - - - - + + + + -Tutorial del Servidor Apache HTTP: Ficheros .htaccess - Servidor Apache HTTP Versión 2.4 - - - - - - -

    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    -
    -
    <-
    -

    Tutorial del Servidor Apache HTTP: Ficheros .htaccess

    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko  | - pt-br 

    -
    - -

    Los ficheros .htaccess facilitan una forma de realizar - cambios en la configuración en contexto directorio.

    -
    - -
    top
    -
    -

    Ficheros .htaccess

    -
    Módulos RelacionadosDirectivas Relacionadas
    - -
    Debería evitar usar ficheros .htaccess completamente si - tiene acceso al fichero de configuración principal de httpd. Usar ficheros - .htaccess ralentiza su servidor Apache http. Cualquier - directiva que pueda incluir en un fichero .htaccess - estará mejor configurada dentro de una sección - Directory, tendrá el mismo efecto y - mejor rendimiento.
    -
    top
    -
    -

    Qué son/Cómo usarlos

    - - -

    Los ficheros .htaccess (o "ficheros de configuración - distribuida") facilitan una forma de realizar cambios en la configuración - en contexto directorio. Un fichero, que contiene una o más directivas, se - coloca en un documento específico de un directorio, y estas directivas - aplican a ese directorio y todos sus subdirectorios.

    - -

    Nota:

    -

    Si quiere llamar a su fichero .htaccess de otra manera, - puede cambiar el nombre del fichero usando la directiva AccessFileName. Por ejemplo, si usted prefiere - llamar al fichero .config, entonces puede poner lo siguiente - en el fichero de configuración de su servidor:

    - - 
    AccessFileName ".config"
    - -
    - -

    Generalmente, los ficheros .htaccess usan la misma sintáxis - que los ficheros de la configuración - principal. Lo que puede utilizar en estos ficheros lo determina la - directiva AllowOverride. Esta directiva - especifica, en categorías, qué directivas tendrán efecto si se encuentran en - un fichero .htaccess. Si se permite una directiva en un fichero - .htaccess, la documentación para esa directiva contendrá una - sección Override, especificando qué valor debe ir en - AllowOverride para que se permita esa - directiva.

    - -

    Por ejemplo, si busca en la documentación la directiva AddDefaultCharset, encontrará que se permite en - ficheros .htaccess. (Vea la línea de Contexto en el sumario de - la directiva.) La línea Override muestra - FileInfo. De este modo, debe tener al menos - AllowOverride FileInfo para que esta directiva se aplique en - ficheros .htaccess.

    - -

    Ejemplo:

    - - - - - - - - - -
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    - -

    Si no está seguro de cuándo, una directiva en concreto, se puede usar en un - fichero .htaccess, consulte la documentación para esa directiva, - y compruebe la línea Context buscando ".htaccess".

    -
    top
    -
    -

    Cuando (no) usar ficheros .htaccess

    - -

    Generalmente, solo debería usar ficheros .htaccess cuando no - tiene acceso al fichero principal de configuración del servidor. Hay, por - ejemplo, una creencia errónea de que la autenticación de usuario debería - hacerse siempre dentro de ficheros .htaccess, y, más recientemente, otra creencia errónea de que las directivas de - mod_rewrite deben ir en ficheros .htaccess. - Esto sencillamente no es el caso. Puede poner las configuraciones de - autenticación de usuario en la configuración principal del servidor, y esto - es de hecho, el método preferido de configurar Apache. Del mismo modo, las - directivas mod_rewrite funcionan mejor, en muchos sentidos, en - el fichero de configuración principal del servidor.

    - -

    Los ficheros .htaccess deberían usarse cuando su proveedor - de contenidos le permite hacer modificaciones de configuración - en contexto directorio, pero usted no tiene acceso de root en el servidor. - En el caso de que el administrador no esté dispuesto a hacer cambios - frecuentes en la configuración, puede que sea necesario permitir a usuarios - individuales realizar estos cambios de configuración en ficheros - .htaccess por ellos mismos. Lo cual ocurre a menudo, por - ejemplo, en casos donde los ISP están albergando múltiples sitios web de - usuario en una sola máquina, y quieren que sus usuarios tengan la - posibilidad de modificar sus configuraciones.

    - -

    Aun así, generalmente, el uso de ficheros .htaccess debería - evitarse cuando sea posible. Cualquier configuración que consideraría poner - en un fichero .htaccess, puede usarse con la misma efectividad - en una sección <Directory> en el fichero de configuración - del servidor.

    - -

    Hay dos razones para evitar el uso de ficheros .htaccess.

    - -

    La primera es el rendimiento. Cuando AllowOverride - está configurado para permitir el uso de ficheros .htaccess, - httpd buscará ficheros .htaccess en cada directorio. Así, - permitiendo ficheros .htaccess provoca una pérdida de - rendimiento, ¡incluso aunque no los use! Además, los ficheros - .htaccess se cargan cada vez que se solicita un documento.

    - -

    Además tenga en cuenta que httpd debe buscar ficheros - .htaccess en todos los directorios de mayor jerarquía, - para poder terner la lista completa de directivas que debe aplicar. (Vea - la sección sobre Cómo se aplican las directivas.) Así, si - se solicita un fichero de un directorio /www/htdocs/example, - httpd debe buscar los siguientes ficheros:

    - -

    - /.htaccess
    - /www/.htaccess
    - /www/htdocs/.htaccess
    - /www/htdocs/example/.htaccess -

    - -

    De esta manera, por cada acceso a un fichero de ese directorio, hay 4 - accesos adicionales al sistema de ficheros, incluso si ninguno de esos - ficheros está presente. (Tenga en cuenta que este caso solo se daría si los - ficheros .htaccess están activados en /, que - generalmente no es el caso.).

    - -

    En el caso de las directivas RewriteRule, en el contexto de - .htaccess estas expresiones regulares deben recompilarse con - cada solicitud a ese directorio, cuando en el contexto de configuración del - servidor solo se compilan una vez y se cachean. Adicionalmente, las reglas - en sí mismas son más complicadas, puesto que uno debe sortear las - restricciones que vienen acompañadas del contexto directorio y - mod_rewrite. Consulte la Guía de Rewrite para un mayor - detalle sobre este tema.

    - -

    La segunda consideración es de seguridad. Estará permitiendo que usuarios - modifiquen la configuración del servidor, lo cual puede dar lugar a cambios sobre los que usted no tendrá ningún control. Medite profundamente si debe - dar a sus usuarios ese privilegio. Además tenga en cuenta que dar a los usuarios menos privilegios de los que necesitan dará lugar a más peticiones - de soporte. Asegúrese de que le indica a sus usuarios claramente el nivel de privilegios que les está dando. Especificando exactamente cómo ha - configurado AllowOverride, e invíteles - a revisar la documentación relacionada, lo cual le ahorrará - bastantes confusiones más adelante.

    - -

    Tenga en cuenta que esto es equivalente por completo a poner un fichero - .htaccess en un directorio /www/htdocs/example - con una directiva, y poner la misma directiva en una sección - Directory <Directory "/www/htdocs/example"> en su - configuración principal del servidor:

    - -

    Fichero .htaccess en /www/htdocs/example:

    - -

    Contenido de fichero .htaccess en - /www/htdocs/example

    AddType text/example ".exm"
    -
    - -

    Sección de su fichero httpd.conf

    <Directory "/www/htdocs/example">
-    AddType text/example ".exm"
-</Directory>
    -
    - -

    Aun así, poniendo ésta en el fichero de configuración dará como resultado - una menor pérdida de rendimiento, y como la configuración se carga una vez - cuando el httpd arranca, en lugar de cada vez que se solicita un fichero.

    - -

    El uso de ficheros .htaccess puede desactivarse por completo - configurando la directiva AllowOverride - a none:

    - - 
    AllowOverride None
    - -
    top
    -
    -

    How directives are applied

    - -

    Las directivas de configuración que se encuentran en el fichero - .htaccess se aplican al directorio en el que el fichero - .htaccess se encuentra, y a todos sus subdirectorios. Sin - embargo, es importante recordar que puede haber otros ficheros - .htaccess en directorios previos. Las directivas se aplican en - el orden en el que se encuentran. Por lo tanto, un fichero - .htaccess puede sobrescribir directivas que se encuentran - en ficheros .htaccess que se encuentran en directorios previos - del árbol de directorios. Y estos, en cambio, pueden haber sobrescrito - directivas que se encontraban más arriba, o en el fichero principal de - configuración del servidor mismo.

    - -

    Ejemplo:

    - -

    En el directorio /www/htdocs/example1 tenemos un fichero - .htaccess que contiene lo siguiente:

    - - 
    Options +ExecCGI
    - - -

    (Nota: debe terner "AllowOverride Options" configurado para - permitir el uso de la directiva "Options" en ficheros - .htaccess files.)

    - -

    En el directorio /www/htdocs/example1/example2 tenemos un - fichero .htaccess que contiene:

    - - 
    Options Includes
    - - -

    Por este segundo fichero .htaccess, en el directorio - /www/htdocs/example1/example2, la ejecución de CGI execution no - está permitida, porque solo se ha definido Options Includes, - que sobrescribe completamente una configuración previa que se pudiera haber - definido.

    - -

    Incorporando el .htaccess en los ficheros de - configuración principal

    - -

    Como se ha comentado en la documentación en las Secciones de Configuración, los ficheros - .htaccess pueden sobrescribir las secciones <Directory> por el directorio - correspondiente, pero se sobrescribirán por otros tipos de secciones de - configuración de los ficheros de configuración principal. Este hecho se - puede usar para forzar ciertas configuraciones, incluso en presencia - de una configuración laxa de - AllowOverride. Por ejemplo, para - prevenir la ejecución de un script mientras se permite cualquier otra cosa - en .htaccess puede usar:

    - - 
    <Directory "/www/htdocs">
-    AllowOverride All
-</Directory>
-
-<Location "/">
-    Options +IncludesNoExec -ExecCGI
-</Location>
    - - -
    Este ejemplo asume que su DocumentRoot es /www/htdocs.
    - - -
    top
    -
    -

    Ejemplo de Autenticación

    - -

    Si saltó directamente a esta parte del documento para averiguar como - hacer la autenticación, es important que tenga en cuenta una cosa. Hay una - creencia errónea de que necesita usar ficheros .htaccess para - configurar autenticación con contraseña. Este no es el caso. Colocar las - directivas de autenticación en una sección - <Directory>, en su fichero - de configuración principal, es el método recomendado para configurar esto, - y los ficheros .htaccess deberían usarse solamente si no tiene - acceso al fichero de configuración principal del servidor. Vea más arriba una explicación de cuando debería y cuando no - debería usar ficheros .htaccess.

    - -

    Dicho esto, si todavía cree que debe usar el fichero - .htaccess, podrá ver que una configuración como la que sigue - podría servirle.

    - -

    Contenido del fichero .htaccess:

    - - 
    AuthType Basic
-AuthName "Password Required"
-AuthUserFile "/www/passwords/password.file"
-AuthGroupFile "/www/passwords/group.file"
-Require group admins
    - - -

    Tenga en cuenta que AllowOverride AuthConfig debe estar - habilitado para que estas directivas tengan algún efecto.

    - -

    Por favor vea el tutorial de autenticación para - una explicación más completa de la autenticación y la autorización.

    -
    top
    -
    -

    Ejemplo de Server Side Includes

    - -

    Otro uso común de ficheros .htaccess es activar Server Side - Includes para un directorio en particular. Esto puede hacerse - con las siguientes directivas de configuración, colocadas en un fichero - .htaccess y el directorio deseado:

    - - 
    Options +Includes
-AddType text/html "shtml"
-AddHandler server-parsed shtml
    - - -

    Tenga en cuenta que AllowOverride Options y - AllowOverride FileInfo deben estar activadas para que estas - directivas tengan efecto.

    - -

    Por favor vea el tutorial de SSI para una - explicación más completa de server-side includes.

    -
    top
    -
    -

    Reglas de Rewrite en ficheros .htaccess

    -

    Cuando use RewriteRule en - ficheros .htaccess, tenga en cuenta que el contexto - directorio cambia las cosas un poco. En concreto, las reglas son - relativas al directorio actual, en lugar de serlo de la petición de URI - solicitada originalmente. - Considere los siguientes ejemplos:

    - -
    # En httpd.conf
-RewriteRule "^/images/(.+)\.jpg" "/images/$1.png"
-
-# En .htaccess en el directorio raíz
-RewriteRule "^images/(.+)\.jpg" "images/$1.png"
-
-# En .htaccess en images/
-RewriteRule "^(.+)\.jpg" "$1.png"
    - - -

    En un .htaccess en cualquier directorio del DocumentRoot, la - barra ("/") inicial se elimina del valor facilitado a RewriteRule, y en el subdirectorio - images, se elimina /images/ también de este valor. - Así, su expresión regular necesita omitir también esa parte.

    - -

    Consulte la documentación de mod_rewrite para - más detalles al usar mod_rewrite.

    - -
    top
    -
    -

    Ejemplo de CGI

    - -

    Finalmente, puede que quiera usar un fichero .htaccess para - permitir la ejecución de programas CGI en un directorio en particular. Esto - se puede implementar con la siguiente configuración:

    - - 
    Options +ExecCGI
-AddHandler cgi-script "cgi" "pl"
    - - -

    Alternativamente, si quiere considerar como programas CGI todos los - ficheros de un directorio concreto, esto se puede conseguir con la siguiente - configuración:

    - - 
    Options +ExecCGI
-SetHandler cgi-script
    - - -

    Tenga en cuenta que AllowOverride Options y - AllowOverride FileInfo deben estar ambas activadas para que - estas directivas tengan efecto.

    - -

    Por favor vea el tutorial CGI para mayor detalle - sobre programación y configuración de CGI.

    - -
    top
    -
    -

    Resolución de problemas

    - -

    Cuando pone directivas en un fichero .htaccess y no obtiene - el efecto deseado hay una serie de cosas que pueden haber ido mal.

    - -

    El problema más común es que AllowOverride - no está configurada para que sus directivas puedan surtir - efecto. Asegúrese de que no tiene AllowOverride None - configurado para el directorio en cuestión. Una buena forma de probar esto - es poner "basura" en su fichero .htaccess y recargar la página. - Si no se genera un error en el servidor, casi seguro que tiene configurado - AllowOverride None.

    - -

    Si, por otro lado, obtiene errores de servidor al intentar acceder a - documentos, compruebe el log de errores de httpd. Seguramente le indiquen - que la directiva en uso en su fichero .htaccess no está - permitida.

    - -

    - [Fri Sep 17 18:43:16 2010] [alert] [client 192.168.200.51] /var/www/html/.htaccess: DirectoryIndex not allowed here -

    - -

    Esto indicará que o bien ha usado una directiva que no se permite nunca - en ficheros .htaccess, o que simplementa no tiene - AllowOverride configurado - a un nivel suficiente para la directiva que ha usado. Consulte la - documentación para esa directiva en particular para determinar cual es el - caso.

    - -

    Alternativamente, puede que le indique que hay un error de sintaxis en - el uso de la propia directiva.

    - -

    - [Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters -

    - -

    En este caso, el mensaje de error debería ser específico para el error de - sintaxis concreto que ha cometido.

    - -
    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko  | - pt-br 

    -
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    + --> +Tutorial del Servidor Apache HTTP: Ficheros .htaccess - Servidor Apache HTTP Versión 2.4 + + + + + + +
    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    +
    +
    <-
    +

    Tutorial del Servidor Apache HTTP: Ficheros .htaccess

    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko  | + pt-br 

    +
    + +

    Los ficheros .htaccess facilitan una forma de realizar + cambios en la configuración en contexto directorio.

    +
    + +
    top
    +
    +

    Ficheros .htaccess

    +
    Módulos RelacionadosDirectivas Relacionadas
    + +
    Debería evitar usar ficheros .htaccess completamente si + tiene acceso al fichero de configuración principal de httpd. Usar ficheros + .htaccess ralentiza su servidor Apache http. Cualquier + directiva que pueda incluir en un fichero .htaccess + estará mejor configurada dentro de una sección + Directory, tendrá el mismo efecto y + mejor rendimiento.
    +
    top
    +
    +

    Qué son/Cómo usarlos

    + + +

    Los ficheros .htaccess (o "ficheros de configuración + distribuida") facilitan una forma de realizar cambios en la configuración + en contexto directorio. Un fichero, que contiene una o más directivas, se + coloca en un documento específico de un directorio, y estas directivas + aplican a ese directorio y todos sus subdirectorios.

    + +

    Nota:

    +

    Si quiere llamar a su fichero .htaccess de otra manera, + puede cambiar el nombre del fichero usando la directiva AccessFileName. Por ejemplo, si usted prefiere + llamar al fichero .config, entonces puede poner lo siguiente + en el fichero de configuración de su servidor:

    + + 
    AccessFileName ".config"
    + +
    + +

    Generalmente, los ficheros .htaccess usan la misma sintáxis + que los ficheros de la configuración + principal. Lo que puede utilizar en estos ficheros lo determina la + directiva AllowOverride. Esta directiva + especifica, en categorías, qué directivas tendrán efecto si se encuentran en + un fichero .htaccess. Si se permite una directiva en un fichero + .htaccess, la documentación para esa directiva contendrá una + sección Override, especificando qué valor debe ir en + AllowOverride para que se permita esa + directiva.

    + +

    Por ejemplo, si busca en la documentación la directiva AddDefaultCharset, encontrará que se permite en + ficheros .htaccess. (Vea la línea de Contexto en el sumario de + la directiva.) La línea Override muestra + FileInfo. De este modo, debe tener al menos + AllowOverride FileInfo para que esta directiva se aplique en + ficheros .htaccess.

    + +

    Ejemplo:

    + + + + + + + + + +
    Context:server config, virtual host, directory, .htaccess
    Override:FileInfo
    + +

    Si no está seguro de cuándo, una directiva en concreto, se puede usar en un + fichero .htaccess, consulte la documentación para esa directiva, + y compruebe la línea Context buscando ".htaccess".

    +
    top
    +
    +

    Cuando (no) usar ficheros .htaccess

    + +

    Generalmente, solo debería usar ficheros .htaccess cuando no + tiene acceso al fichero principal de configuración del servidor. Hay, por + ejemplo, una creencia errónea de que la autenticación de usuario debería + hacerse siempre dentro de ficheros .htaccess, y, más recientemente, otra creencia errónea de que las directivas de + mod_rewrite deben ir en ficheros .htaccess. + Esto sencillamente no es el caso. Puede poner las configuraciones de + autenticación de usuario en la configuración principal del servidor, y esto + es de hecho, el método preferido de configurar Apache. Del mismo modo, las + directivas mod_rewrite funcionan mejor, en muchos sentidos, en + el fichero de configuración principal del servidor.

    + +

    Los ficheros .htaccess deberían usarse cuando su proveedor + de contenidos le permite hacer modificaciones de configuración + en contexto directorio, pero usted no tiene acceso de root en el servidor. + En el caso de que el administrador no esté dispuesto a hacer cambios + frecuentes en la configuración, puede que sea necesario permitir a usuarios + individuales realizar estos cambios de configuración en ficheros + .htaccess por ellos mismos. Lo cual ocurre a menudo, por + ejemplo, en casos donde los ISP están albergando múltiples sitios web de + usuario en una sola máquina, y quieren que sus usuarios tengan la + posibilidad de modificar sus configuraciones.

    + +

    Aun así, generalmente, el uso de ficheros .htaccess debería + evitarse cuando sea posible. Cualquier configuración que consideraría poner + en un fichero .htaccess, puede usarse con la misma efectividad + en una sección <Directory> en el fichero de configuración + del servidor.

    + +

    Hay dos razones para evitar el uso de ficheros .htaccess.

    + +

    La primera es el rendimiento. Cuando AllowOverride + está configurado para permitir el uso de ficheros .htaccess, + httpd buscará ficheros .htaccess en cada directorio. Así, + permitiendo ficheros .htaccess provoca una pérdida de + rendimiento, ¡incluso aunque no los use! Además, los ficheros + .htaccess se cargan cada vez que se solicita un documento.

    + +

    Además tenga en cuenta que httpd debe buscar ficheros + .htaccess en todos los directorios de mayor jerarquía, + para poder terner la lista completa de directivas que debe aplicar. (Vea + la sección sobre Cómo se aplican las directivas.) Así, si + se solicita un fichero de un directorio /www/htdocs/example, + httpd debe buscar los siguientes ficheros:

    + +

    + /.htaccess
    + /www/.htaccess
    + /www/htdocs/.htaccess
    + /www/htdocs/example/.htaccess +

    + +

    De esta manera, por cada acceso a un fichero de ese directorio, hay 4 + accesos adicionales al sistema de ficheros, incluso si ninguno de esos + ficheros está presente. (Tenga en cuenta que este caso solo se daría si los + ficheros .htaccess están activados en /, que + generalmente no es el caso.).

    + +

    En el caso de las directivas RewriteRule, en el contexto de + .htaccess estas expresiones regulares deben recompilarse con + cada solicitud a ese directorio, cuando en el contexto de configuración del + servidor solo se compilan una vez y se cachean. Adicionalmente, las reglas + en sí mismas son más complicadas, puesto que uno debe sortear las + restricciones que vienen acompañadas del contexto directorio y + mod_rewrite. Consulte la Guía de Rewrite para un mayor + detalle sobre este tema.

    + +

    La segunda consideración es de seguridad. Estará permitiendo que usuarios + modifiquen la configuración del servidor, lo cual puede dar lugar a cambios sobre los que usted no tendrá ningún control. Medite profundamente si debe + dar a sus usuarios ese privilegio. Además tenga en cuenta que dar a los usuarios menos privilegios de los que necesitan dará lugar a más peticiones + de soporte. Asegúrese de que le indica a sus usuarios claramente el nivel de privilegios que les está dando. Especificando exactamente cómo ha + configurado AllowOverride, e invíteles + a revisar la documentación relacionada, lo cual le ahorrará + bastantes confusiones más adelante.

    + +

    Tenga en cuenta que esto es equivalente por completo a poner un fichero + .htaccess en un directorio /www/htdocs/example + con una directiva, y poner la misma directiva en una sección + Directory <Directory "/www/htdocs/example"> en su + configuración principal del servidor:

    + +

    Fichero .htaccess en /www/htdocs/example:

    + +

    Contenido de fichero .htaccess en + /www/htdocs/example

    AddType text/example ".exm"
    +
    + +

    Sección de su fichero httpd.conf

    <Directory "/www/htdocs/example">
+    AddType text/example ".exm"
+</Directory>
    +
    + +

    Aun así, poniendo ésta en el fichero de configuración dará como resultado + una menor pérdida de rendimiento, y como la configuración se carga una vez + cuando el httpd arranca, en lugar de cada vez que se solicita un fichero.

    + +

    El uso de ficheros .htaccess puede desactivarse por completo + configurando la directiva AllowOverride + a none:

    + + 
    AllowOverride None
    + +
    top
    +
    +

    How directives are applied

    + +

    Las directivas de configuración que se encuentran en el fichero + .htaccess se aplican al directorio en el que el fichero + .htaccess se encuentra, y a todos sus subdirectorios. Sin + embargo, es importante recordar que puede haber otros ficheros + .htaccess en directorios previos. Las directivas se aplican en + el orden en el que se encuentran. Por lo tanto, un fichero + .htaccess puede sobrescribir directivas que se encuentran + en ficheros .htaccess que se encuentran en directorios previos + del árbol de directorios. Y estos, en cambio, pueden haber sobrescrito + directivas que se encontraban más arriba, o en el fichero principal de + configuración del servidor mismo.

    + +

    Ejemplo:

    + +

    En el directorio /www/htdocs/example1 tenemos un fichero + .htaccess que contiene lo siguiente:

    + + 
    Options +ExecCGI
    + + +

    (Nota: debe terner "AllowOverride Options" configurado para + permitir el uso de la directiva "Options" en ficheros + .htaccess files.)

    + +

    En el directorio /www/htdocs/example1/example2 tenemos un + fichero .htaccess que contiene:

    + + 
    Options Includes
    + + +

    Por este segundo fichero .htaccess, en el directorio + /www/htdocs/example1/example2, la ejecución de CGI execution no + está permitida, porque solo se ha definido Options Includes, + que sobrescribe completamente una configuración previa que se pudiera haber + definido.

    + +

    Incorporando el .htaccess en los ficheros de + configuración principal

    + +

    Como se ha comentado en la documentación en las Secciones de Configuración, los ficheros + .htaccess pueden sobrescribir las secciones <Directory> por el directorio + correspondiente, pero se sobrescribirán por otros tipos de secciones de + configuración de los ficheros de configuración principal. Este hecho se + puede usar para forzar ciertas configuraciones, incluso en presencia + de una configuración laxa de + AllowOverride. Por ejemplo, para + prevenir la ejecución de un script mientras se permite cualquier otra cosa + en .htaccess puede usar:

    + + 
    <Directory "/www/htdocs">
+    AllowOverride All
+</Directory>
+
+<Location "/">
+    Options +IncludesNoExec -ExecCGI
+</Location>
    + + +
    Este ejemplo asume que su DocumentRoot es /www/htdocs.
    + + +
    top
    +
    +

    Ejemplo de Autenticación

    + +

    Si saltó directamente a esta parte del documento para averiguar como + hacer la autenticación, es important que tenga en cuenta una cosa. Hay una + creencia errónea de que necesita usar ficheros .htaccess para + configurar autenticación con contraseña. Este no es el caso. Colocar las + directivas de autenticación en una sección + <Directory>, en su fichero + de configuración principal, es el método recomendado para configurar esto, + y los ficheros .htaccess deberían usarse solamente si no tiene + acceso al fichero de configuración principal del servidor. Vea más arriba una explicación de cuando debería y cuando no + debería usar ficheros .htaccess.

    + +

    Dicho esto, si todavía cree que debe usar el fichero + .htaccess, podrá ver que una configuración como la que sigue + podría servirle.

    + +

    Contenido del fichero .htaccess:

    + + 
    AuthType Basic
+AuthName "Password Required"
+AuthUserFile "/www/passwords/password.file"
+AuthGroupFile "/www/passwords/group.file"
+Require group admins
    + + +

    Tenga en cuenta que AllowOverride AuthConfig debe estar + habilitado para que estas directivas tengan algún efecto.

    + +

    Por favor vea el tutorial de autenticación para + una explicación más completa de la autenticación y la autorización.

    +
    top
    +
    +

    Ejemplo de Server Side Includes

    + +

    Otro uso común de ficheros .htaccess es activar Server Side + Includes para un directorio en particular. Esto puede hacerse + con las siguientes directivas de configuración, colocadas en un fichero + .htaccess y el directorio deseado:

    + + 
    Options +Includes
+AddType text/html "shtml"
+AddHandler server-parsed shtml
    + + +

    Tenga en cuenta que AllowOverride Options y + AllowOverride FileInfo deben estar activadas para que estas + directivas tengan efecto.

    + +

    Por favor vea el tutorial de SSI para una + explicación más completa de server-side includes.

    +
    top
    +
    +

    Reglas de Rewrite en ficheros .htaccess

    +

    Cuando use RewriteRule en + ficheros .htaccess, tenga en cuenta que el contexto + directorio cambia las cosas un poco. En concreto, las reglas son + relativas al directorio actual, en lugar de serlo de la petición de URI + solicitada originalmente. + Considere los siguientes ejemplos:

    + +
    # En httpd.conf
+RewriteRule "^/images/(.+)\.jpg" "/images/$1.png"
+
+# En .htaccess en el directorio raíz
+RewriteRule "^images/(.+)\.jpg" "images/$1.png"
+
+# En .htaccess en images/
+RewriteRule "^(.+)\.jpg" "$1.png"
    + + +

    En un .htaccess en cualquier directorio del DocumentRoot, la + barra ("/") inicial se elimina del valor facilitado a RewriteRule, y en el subdirectorio + images, se elimina /images/ también de este valor. + Así, su expresión regular necesita omitir también esa parte.

    + +

    Consulte la documentación de mod_rewrite para + más detalles al usar mod_rewrite.

    + +
    top
    +
    +

    Ejemplo de CGI

    + +

    Finalmente, puede que quiera usar un fichero .htaccess para + permitir la ejecución de programas CGI en un directorio en particular. Esto + se puede implementar con la siguiente configuración:

    + + 
    Options +ExecCGI
+AddHandler cgi-script "cgi" "pl"
    + + +

    Alternativamente, si quiere considerar como programas CGI todos los + ficheros de un directorio concreto, esto se puede conseguir con la siguiente + configuración:

    + + 
    Options +ExecCGI
+SetHandler cgi-script
    + + +

    Tenga en cuenta que AllowOverride Options y + AllowOverride FileInfo deben estar ambas activadas para que + estas directivas tengan efecto.

    + +

    Por favor vea el tutorial CGI para mayor detalle + sobre programación y configuración de CGI.

    + +
    top
    +
    +

    Resolución de problemas

    + +

    Cuando pone directivas en un fichero .htaccess y no obtiene + el efecto deseado hay una serie de cosas que pueden haber ido mal.

    + +

    El problema más común es que AllowOverride + no está configurada para que sus directivas puedan surtir + efecto. Asegúrese de que no tiene AllowOverride None + configurado para el directorio en cuestión. Una buena forma de probar esto + es poner "basura" en su fichero .htaccess y recargar la página. + Si no se genera un error en el servidor, casi seguro que tiene configurado + AllowOverride None.

    + +

    Si, por otro lado, obtiene errores de servidor al intentar acceder a + documentos, compruebe el log de errores de httpd. Seguramente le indiquen + que la directiva en uso en su fichero .htaccess no está + permitida.

    + +

    + [Fri Sep 17 18:43:16 2010] [alert] [client 192.168.200.51] /var/www/html/.htaccess: DirectoryIndex not allowed here +

    + +

    Esto indicará que o bien ha usado una directiva que no se permite nunca + en ficheros .htaccess, o que simplementa no tiene + AllowOverride configurado + a un nivel suficiente para la directiva que ha usado. Consulte la + documentación para esa directiva en particular para determinar cual es el + caso.

    + +

    Alternativamente, puede que le indique que hay un error de sintaxis en + el uso de la propia directiva.

    + +

    + [Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters +

    + +

    En este caso, el mensaje de error debería ser específico para el error de + sintaxis concreto que ha cometido.

    + +
    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko  | + pt-br 

    +
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    +//--> \ No newline at end of file diff --git a/docs/manual/howto/htaccess.html.ja.utf8 b/docs/manual/howto/htaccess.html.ja.utf8 index 253a6c0767..306bb35e2c 100644 --- a/docs/manual/howto/htaccess.html.ja.utf8 +++ b/docs/manual/howto/htaccess.html.ja.utf8 @@ -24,6 +24,7 @@ Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.4 > How-To / チュートリアル

    Apache チュートリアル: .htaccess ファイル

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko  | @@ -384,6 +385,7 @@ Options +IncludesNoExec -ExecCGI

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/htaccess.html.ko.euc-kr b/docs/manual/howto/htaccess.html.ko.euc-kr index 2fb8a349dd..1d5bff4af2 100644 --- a/docs/manual/howto/htaccess.html.ko.euc-kr +++ b/docs/manual/howto/htaccess.html.ko.euc-kr @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4 > How-To / Tutorials

    ¾ÆÆÄÄ¡ ÅõÅ丮¾ó: .htaccess ÆÄÀÏ

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko  | @@ -330,6 +331,7 @@

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/htaccess.html.pt-br b/docs/manual/howto/htaccess.html.pt-br index bde0a93549..3281d4463f 100644 --- a/docs/manual/howto/htaccess.html.pt-br +++ b/docs/manual/howto/htaccess.html.pt-br @@ -24,6 +24,7 @@ Apache > Servidor HTTP > Documentação > Versão 2.4 > How-To / Tutoriais

    Tutorial do Apache: arquivos .htaccess

    Línguas Disponíveis:  en  | + es  |  fr  |  ja  |  ko  | @@ -374,6 +375,7 @@

    Línguas Disponíveis:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/http2.html.en b/docs/manual/howto/http2.html.en index d88b34ba1e..a614284ede 100644 --- a/docs/manual/howto/http2.html.en +++ b/docs/manual/howto/http2.html.en @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4 > How-To / Tutorials

    HTTP/2 guide

    Available Languages:  en  | + es  |  fr 

    @@ -243,6 +244,7 @@

    Available Languages:  en  | + es  |  fr 

    top

    Comments

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    - - -
    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    -
    -
    <-
    -

    Guía HTTP/2

    -
    -

    Idiomas disponibles:  en  | - es  | - fr 

    -
    - -

    Esta es la guía para configurar HTTP/2 en Apache httpd. Ésta - característica es experimental así que es de esperar que algunas - directivas e interfaces cambien con nuevas versiones. -

    -
    - -
    top
    -
    -

    El protocolo HTTP/2

    - - -

    HTTP/2 es la evolución del protocolo de la capa de aplicación con más - éxito, HTTP. Se centra en hacer un uso más eficiente de los recursos de red. No cambia la característica fundamental de HTTP, la semántica. Todavía hay solicitudes, respuestas, cabeceras y todo los elementos típicos de HTTP/1. Así que, si ya conoce HTTP/1, también conoce el 95% de HTTP/2.

    - -

    Se ha escrito mucho sobre HTTP/2 y de cómo funciona. La norma más - estándar es, por supuesto, su - RFC 7540 - ( también disponible en un - formato más legible, YMMV). Así que, ahí encontrará toda la especificación del protocolo.

    - -

    Pero, como con todos los RFC, no es ideal como primera lectura. Es mejor - entender primero qué se quiere hacer y después leer el RFC sobre - cómo hacerlo. Un documento mucho mejor con el que empezar es - http2 explicado - por Daniel Stenberg, el autor de curl. - ¡También está disponible cada vez en un mayor número lenguajes!

    - -

    Si le parece demasiado largo, o no lo ha leido, hay algunos términos - y elementos a tener en cuenta cuando lea este documento:

    -
      -
    • HTTP/2 es un protocolo binario, al contrario que HTTP 1.1 que es texto plano. La intención para HTTP 1.1 es que sea legible (por ejemplo capturando el tráfico de red) mientras que para HTTP/2 no. Más información en el FAQ oficial ¿Por qué es binario HTTP/2?
      • - -
    • h2 es HTTP/2 sobre TLS (negociación de protocolo a través de ALPN).
      • - -
    • h2c es HTTP/2 sobre TCP.
      • - -
    • Un frame es la unidad más pequeña de comunicación dentro de una conexión HTTP/2, que consiste en una cabecera y una secuencia de octetos de longitud variable estructurada de acuerdo con el tipo de frame. Más información en la documentación oficial Sección de Capa de Frame.
      • - -
    • Un stream es un flujo bidireccional de frames dentro de una conexión HTTP/2. El concepto correspondiente en HTTP 1.1 es un intercambio de mensajes de solicitud/respuesta. Más información en la documentación oficial Sección Capa de Stream.
      • - -
    • HTTP/2 es capaz de llevar múltiples streams de datos sobre la misma conexión TCP, evitando la clásica solicitud lenta "head-of-line blocking" de HTTP 1.1 y evitando generar múltiples conexiones TCP para cada solicitud/respuesta (KeepAlive parcheó el problema en HTTP 1.1 pero no lo resolvió completamente).
      • -
    -
    top
    -
    -

    HTTP/2 en Apache httpd

    - -

    El protocolo HTTP/2 se implementa con su propio módulo httpd, llamado acertadamente mod_http2. Incluye el set completo de características descritas por el RFC 7540 y soporta HTTP/2 sobre texto plano (http:), así como conexiones seguras (https:). La variante de texto plano se llama 'h2c', la segura 'h2'. Para h2c permite el modo direct - y el Upgrade: a través de una solicitud inicial HTTP/1.

    - -

    Una característica de HTTP/2 que ofrece capacidades nuevas para desarrolladores de web es Server Push. Vea esa sección para saber como su aplicación web puede hacer uso de ella.

    -
    top
    -
    -

    Compilar httpd con soporte HTTP/2

    - -

    mod_http2 usa la librería nghttp2 - como su implementación base. Para compilar mod_http2 necesita al menos la versión 1.2.1 de libnghttp2 instalada en su sistema.

    - -

    Cuando usted ejecuta ./configure en el código fuente de Apache HTTPD, necesita indicarle '--enable-http2' como una opción adicional para activar la compilación de este módulo. Si su libnghttp2 está ubicado en una ruta no habitual (cualquiera que sea en su sistema operativo), puede indicar su ubicación con '--with-nghttp2=<path>' para ./configure.

    - -

    Aunque puede que eso sirva para la mayoría, habrá quien prefiera un nghttp2 compilado estáticamente para este módulo. Para ellos existe la opción --enable-nghttp2-staticlib-deps. Funciona de manera muy similar a como uno debe enlazar openssl estáticamente para mod_ssl.

    - -

    Hablando de SSL, necesita estar al tanto de que la mayoría de los navegadores hablan HTTP/2 solo con URLs https:. Así que necesita un servidor con soporte SSL. Pero no solo eso, necesitará una librería SSL que de soporte a la extensión ALPN. Si usa OpenSSL, necesita al menos la versión 1.0.2.

    -
    top
    -
    -

    Configuración básica

    - - -

    Cuando tiene un httpd compilado con mod_http2 necesita una configuración básica para activarlo. Lo primero, como con cualquier otro módulo de Apache, es que necesita cargarlo:

    - - 
    LoadModule http2_module modules/mod_http2.so
    - - -

    La segunda directiva que necesita añadir a la configuración de su servidor es:

    - - 
    Protocols h2 http/1.1
    - - -

    Esto permite h2, la variante segura, para ser el protocolo preferido de las conexiones en su servidor. Cuando quiera habilitar todas las variantes de HTTP/2, entonces simplemente configure:

    - - 
    Protocols h2 h2c http/1.1
    - - -

    Dependiendo de dónde pone esta directiva, afecta a todas las conexiones o solo a las de ciertos host virtuales. La puede anidar, como en:

    - - 
    Protocols http/1.1
-<VirtualHost ...>
-    ServerName test.example.org
-    Protocols h2 http/1.1
-</VirtualHost>
    - - -

    Esto solo permite HTTP/1, excepto conexiones SSL hacia test.example.org que ofrecen HTTP/2.

    - -

    Escoger un SSLCipherSuite seguro

    -

    Es necesario configurar SSLCipherSuite con una suite segura de cifrado TLS. La versión actual de mod_http2 no fuerza ningún cifrado pero la mayoría de los clientes si lo hacen. Encaminar un navegador hacia un servidor con h2 activado con una suite inapropiada de cifrados forzará al navegador a rehusar e intentar conectar por HTTP 1.1. Esto es un error común cuando se configura httpd con HTTP/2 por primera vez, ¡así que por favor tenga en cuenta que debe evitar largas sesiones de depuración! Si quiere estar seguro de la suite de cifrados que escoja, por favor evite los listados en la Lista Negra de TLS para HTTP/2.

    -
    - -

    El orden de los protocolos mencionados también es relevante. Por defecto, el primero es el protocolo preferido. Cuando un cliente ofrece múltiples opciones, la que esté más a la izquierda será la escogida. En

    - 
    Protocols http/1.1 h2
    - - -

    el protocolo preferido es HTTP/1 y siempre será seleccionado a menos que el cliente sólo soporte h2. Puesto que queremos hablar HTTP/2 con clientes que lo soporten, el orden correcto es:

    - - 
    Protocols h2 h2c http/1.1
    - - -

    Hay algo más respecto al orden: el cliente también tiene sus propias preferencias. Si quiere, puede configurar su servidor para seleccionar el protocolo preferido por el cliente:

    - - 
    ProtocolsHonorOrder Off
    - - -

    Hace que el orden en que usted escribió los Protocols sea irrelevante y sólo el orden de preferencia del cliente será decisorio.

    - -

    Una última cosa: cuando usted configura los protocolos no se comprueba si son correctos o están bien escritos. Puede mencionar protocolos que no existen, así que no hay necesidad de proteger Protocols con ningún IfModule de comprobación.

    - -

    Para más consejos avanzados de configuración, vea la - sección de módulos sobre dimensionamiento y - como gestionar multiples hosts con el mismo certificado.

    -
    top
    -
    -

    Configuración MPM

    - - -

    HTTP/2 está soportado en todos los módulos de multi-proceso que se ofrecen con httpd. Aun así, si usa el mpm prefork, habrá restricciones severas.

    - -

    En prefork, mod_http2 solo procesará una solicitud cada vez por conexión. Pero los clientes, como los navegadores, enviarán muchas solicitudes al mismo tiempo. Si una de ellas tarda mucho en procesarse (o hace un sondeo que dura más de la cuenta), las otras solicitudes se quedarán atascadas.

    - -

    mod_http2 no evitará este límite por defecto. El motivo es que prefork hoy en día solo se escoge si ejecuta motores de proceso que no están preparados para multi-hilo, p.ej. fallará con más de una solicitud.

    - -

    Si su configuración lo soporta, hoy en día event es el mejor mpm que puede usar.

    - -

    Si realmente está obligado a usar prefork y quiere multiples solicitudes, puede configurar la directiva H2MinWorkers para hacerlo posible. Sin embargo, si esto falla, es bajo su cuenta y riesgo.

    -
    top
    -
    -

    Clientes

    - - -

    Casi todos los navegadores modernos dan soporte a HTTP/2, pero solo en conexiones SSL: Firefox (v43), Chrome (v45), Safari (since v9), iOS Safari (v9), Opera (v35), Chrome para Android (v49) e Internet Explorer (v11 en Windows10) (Fuente).

    - -

    Otros clientes, así cómo otros servidores, están listados en la - wiki de Implementaciones, entre ellos, implementaciones para c, c++, common lisp, dart, erlang, haskell, java, nodejs, php, python, perl, ruby, rust, scala y swift.

    - -

    Muchos de las implementaciones de clientes que no son navegadores soportan HTTP/2 sobre texto plano, h2c. La más versátil es curl.

    -
    top
    -
    -

    Herramientas útiles para depurar HTTP/2

    - - -

    La primera herramienta a mencionar es por supuesto curl. Por favor asegúrese de que su versión soporta HTTP/2 comprobando sus Características:

    - 
        $ curl -V
-    curl 7.45.0 (x86_64-apple-darwin15.0.0) libcurl/7.45.0 OpenSSL/1.0.2d zlib/1.2.8 nghttp2/1.3.4
-    Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 [...] 
-    Features: IPv6 Largefile NTLM NTLM_WB SSL libz TLS-SRP HTTP2
-
    - -

    Notas sobre Mac OS homebrew

    - brew install curl --with-openssl --with-nghttp2 -
    -

    Y para una inspección en gran profundidad wireshark.

    -

    El paquete nghttp2 también incluye clientes, tales como:

    -
      -
    • nghttp - - util para visualizar la frames de HTTP/2 y tener una mejor idea de como funciona el protocolo.
      • -
    • h2load - útil para hacer un stress-test de su servidor.
      • -
    - -

    Chrome ofrece logs detallados de HTTP/2 en sus conexiones a través de la página especial de net-internals. También hay una extensión interesante para Chrome y Firefox con la que visualizar cuando su navegador usa HTTP/2.

    -
    top
    -
    -

    Server Push

    - - -

    El protocolo HTTP/2 permite al servidor hacer PUSH de respuestas a un cliente que nunca las solicitó. El tono de la conversación es: "Aquí tiene una solicitud que nunca envió y la respuesta llegará pronto..."

    - -

    Pero hay restricciones: el cliente puede deshabilitar esta característica y el servidor entonces solo podrá hacer PUSH en una solicitud que hizo previamente del cliente.

    - -

    La intención es permitir al servidor enviar recursos que el cliente seguramente vaya a necesitar, p. ej. un recurso css o javascript que pertenece a una página html que el cliente solicitó, un grupo de imágenes a las que se hace referencia en un css, etc.

    - -

    La ventaja para el cliente es que ahorra tiempo para solicitudes que pueden tardar desde unos pocos milisegundos a medio segundo, dependiendo de la distancia entre el cliente y el servidor. La desventaja es que el cliente puede recibir cosas que ya tiene en su cache. Por supuesto que HTTP/2 soporta cancelación previa de tales solicitudes, pero aun así se malgastan recursos.

    - -

    Resumiendo: no hay una estrategia mejor sobre cómo usar esta característica de HTTP/2 y todo el mundo está experimentando con ella. Así que, ¿cómo experimenta usted con ella en Apache httpd?

    - -

    mod_http2 busca e inspecciona las cabeceras de respuesta - Link con cierto formato:

    - - 
    Link </xxx.css>;rel=preload, </xxx.js>; rel=preload
    - - -

    Si la conexión soporta PUSH, estos dos recursos se enviarán al cliente. Como desarrollador web, puede configurar estas cabeceras o bien directamente en la respuesta de su aplicación o configurar su servidor con:

    - - 
    <Location /xxx.html>
-    Header add Link "</xxx.css>;rel=preload"
-    Header add Link "</xxx.js>;rel=preload"
-</Location>
    - - -

    Si quiere usar enlaces con preload sin activar un PUSH, puede usar el parámetro nopush, como en:

    - - 
    Link </xxx.css>;rel=preload;nopush
    - - -

    o puede desactivar PUSH para su servidor por completo con la directiva

    - - 
    H2Push Off
    - - -

    Y hay más:

    - -

    El módulo mantiene un registro de lo que se ha enviado con PUSH para cada conexión (hashes de URLs, básicamente) y no hará PUSH del mismo recurso dos veces. Cuando la conexión se cierra, la información es descartada.

    - -

    Hay gente pensando cómo un cliente puede decirle al servidor lo que ya tiene, para evitar los PUSH de esos elementos, pero eso algo muy experimental ahora mismo.

    - -

    Otro borrador experimental que ha sido implementado en - mod_http2 es el Campo de Cabecera - Accept-Push-Policy en la que un cliente puede, para cada solicitud, definir qué tipo de PUSH acepta.

    -
    -
    -

    Idiomas disponibles:  en  | - es  | - fr 

    -
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    + --> +Guía HTTP/2 - Servidor Apache HTTP Versión 2.4 + + + + + + +
    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    +
    +
    <-
    +

    Guía HTTP/2

    +
    +

    Idiomas disponibles:  en  | + es  | + fr 

    +
    + +

    Esta es la guía para configurar HTTP/2 en Apache httpd. Ésta + característica es experimental así que es de esperar que algunas + directivas e interfaces cambien con nuevas versiones. +

    +
    + +
    top
    +
    +

    El protocolo HTTP/2

    + + +

    HTTP/2 es la evolución del protocolo de la capa de aplicación con más + éxito, HTTP. Se centra en hacer un uso más eficiente de los recursos de red. No cambia la característica fundamental de HTTP, la semántica. Todavía hay solicitudes, respuestas, cabeceras y todo los elementos típicos de HTTP/1. Así que, si ya conoce HTTP/1, también conoce el 95% de HTTP/2.

    + +

    Se ha escrito mucho sobre HTTP/2 y de cómo funciona. La norma más + estándar es, por supuesto, su + RFC 7540 + ( también disponible en un + formato más legible, YMMV). Así que, ahí encontrará toda la especificación del protocolo.

    + +

    Pero, como con todos los RFC, no es ideal como primera lectura. Es mejor + entender primero qué se quiere hacer y después leer el RFC sobre + cómo hacerlo. Un documento mucho mejor con el que empezar es + http2 explicado + por Daniel Stenberg, el autor de curl. + ¡También está disponible cada vez en un mayor número lenguajes!

    + +

    Si le parece demasiado largo, o no lo ha leido, hay algunos términos + y elementos a tener en cuenta cuando lea este documento:

    +
      +
    • HTTP/2 es un protocolo binario, al contrario que HTTP 1.1 que es texto plano. La intención para HTTP 1.1 es que sea legible (por ejemplo capturando el tráfico de red) mientras que para HTTP/2 no. Más información en el FAQ oficial ¿Por qué es binario HTTP/2?
      • + +
    • h2 es HTTP/2 sobre TLS (negociación de protocolo a través de ALPN).
      • + +
    • h2c es HTTP/2 sobre TCP.
      • + +
    • Un frame es la unidad más pequeña de comunicación dentro de una conexión HTTP/2, que consiste en una cabecera y una secuencia de octetos de longitud variable estructurada de acuerdo con el tipo de frame. Más información en la documentación oficial Sección de Capa de Frame.
      • + +
    • Un stream es un flujo bidireccional de frames dentro de una conexión HTTP/2. El concepto correspondiente en HTTP 1.1 es un intercambio de mensajes de solicitud/respuesta. Más información en la documentación oficial Sección Capa de Stream.
      • + +
    • HTTP/2 es capaz de llevar múltiples streams de datos sobre la misma conexión TCP, evitando la clásica solicitud lenta "head-of-line blocking" de HTTP 1.1 y evitando generar múltiples conexiones TCP para cada solicitud/respuesta (KeepAlive parcheó el problema en HTTP 1.1 pero no lo resolvió completamente).
      • +
    +
    top
    +
    +

    HTTP/2 en Apache httpd

    + +

    El protocolo HTTP/2 se implementa con su propio módulo httpd, llamado acertadamente mod_http2. Incluye el set completo de características descritas por el RFC 7540 y soporta HTTP/2 sobre texto plano (http:), así como conexiones seguras (https:). La variante de texto plano se llama 'h2c', la segura 'h2'. Para h2c permite el modo direct + y el Upgrade: a través de una solicitud inicial HTTP/1.

    + +

    Una característica de HTTP/2 que ofrece capacidades nuevas para desarrolladores de web es Server Push. Vea esa sección para saber como su aplicación web puede hacer uso de ella.

    +
    top
    +
    +

    Compilar httpd con soporte HTTP/2

    + +

    mod_http2 usa la librería nghttp2 + como su implementación base. Para compilar mod_http2 necesita al menos la versión 1.2.1 de libnghttp2 instalada en su sistema.

    + +

    Cuando usted ejecuta ./configure en el código fuente de Apache HTTPD, necesita indicarle '--enable-http2' como una opción adicional para activar la compilación de este módulo. Si su libnghttp2 está ubicado en una ruta no habitual (cualquiera que sea en su sistema operativo), puede indicar su ubicación con '--with-nghttp2=<path>' para ./configure.

    + +

    Aunque puede que eso sirva para la mayoría, habrá quien prefiera un nghttp2 compilado estáticamente para este módulo. Para ellos existe la opción --enable-nghttp2-staticlib-deps. Funciona de manera muy similar a como uno debe enlazar openssl estáticamente para mod_ssl.

    + +

    Hablando de SSL, necesita estar al tanto de que la mayoría de los navegadores hablan HTTP/2 solo con URLs https:. Así que necesita un servidor con soporte SSL. Pero no solo eso, necesitará una librería SSL que de soporte a la extensión ALPN. Si usa OpenSSL, necesita al menos la versión 1.0.2.

    +
    top
    +
    +

    Configuración básica

    + + +

    Cuando tiene un httpd compilado con mod_http2 necesita una configuración básica para activarlo. Lo primero, como con cualquier otro módulo de Apache, es que necesita cargarlo:

    + + 
    LoadModule http2_module modules/mod_http2.so
    + + +

    La segunda directiva que necesita añadir a la configuración de su servidor es:

    + + 
    Protocols h2 http/1.1
    + + +

    Esto permite h2, la variante segura, para ser el protocolo preferido de las conexiones en su servidor. Cuando quiera habilitar todas las variantes de HTTP/2, entonces simplemente configure:

    + + 
    Protocols h2 h2c http/1.1
    + + +

    Dependiendo de dónde pone esta directiva, afecta a todas las conexiones o solo a las de ciertos host virtuales. La puede anidar, como en:

    + + 
    Protocols http/1.1
+<VirtualHost ...>
+    ServerName test.example.org
+    Protocols h2 http/1.1
+</VirtualHost>
    + + +

    Esto solo permite HTTP/1, excepto conexiones SSL hacia test.example.org que ofrecen HTTP/2.

    + +

    Escoger un SSLCipherSuite seguro

    +

    Es necesario configurar SSLCipherSuite con una suite segura de cifrado TLS. La versión actual de mod_http2 no fuerza ningún cifrado pero la mayoría de los clientes si lo hacen. Encaminar un navegador hacia un servidor con h2 activado con una suite inapropiada de cifrados forzará al navegador a rehusar e intentar conectar por HTTP 1.1. Esto es un error común cuando se configura httpd con HTTP/2 por primera vez, ¡así que por favor tenga en cuenta que debe evitar largas sesiones de depuración! Si quiere estar seguro de la suite de cifrados que escoja, por favor evite los listados en la Lista Negra de TLS para HTTP/2.

    +
    + +

    El orden de los protocolos mencionados también es relevante. Por defecto, el primero es el protocolo preferido. Cuando un cliente ofrece múltiples opciones, la que esté más a la izquierda será la escogida. En

    + 
    Protocols http/1.1 h2
    + + +

    el protocolo preferido es HTTP/1 y siempre será seleccionado a menos que el cliente sólo soporte h2. Puesto que queremos hablar HTTP/2 con clientes que lo soporten, el orden correcto es:

    + + 
    Protocols h2 h2c http/1.1
    + + +

    Hay algo más respecto al orden: el cliente también tiene sus propias preferencias. Si quiere, puede configurar su servidor para seleccionar el protocolo preferido por el cliente:

    + + 
    ProtocolsHonorOrder Off
    + + +

    Hace que el orden en que usted escribió los Protocols sea irrelevante y sólo el orden de preferencia del cliente será decisorio.

    + +

    Una última cosa: cuando usted configura los protocolos no se comprueba si son correctos o están bien escritos. Puede mencionar protocolos que no existen, así que no hay necesidad de proteger Protocols con ningún IfModule de comprobación.

    + +

    Para más consejos avanzados de configuración, vea la + sección de módulos sobre dimensionamiento y + como gestionar multiples hosts con el mismo certificado.

    +
    top
    +
    +

    Configuración MPM

    + + +

    HTTP/2 está soportado en todos los módulos de multi-proceso que se ofrecen con httpd. Aun así, si usa el mpm prefork, habrá restricciones severas.

    + +

    En prefork, mod_http2 solo procesará una solicitud cada vez por conexión. Pero los clientes, como los navegadores, enviarán muchas solicitudes al mismo tiempo. Si una de ellas tarda mucho en procesarse (o hace un sondeo que dura más de la cuenta), las otras solicitudes se quedarán atascadas.

    + +

    mod_http2 no evitará este límite por defecto. El motivo es que prefork hoy en día solo se escoge si ejecuta motores de proceso que no están preparados para multi-hilo, p.ej. fallará con más de una solicitud.

    + +

    Si su configuración lo soporta, hoy en día event es el mejor mpm que puede usar.

    + +

    Si realmente está obligado a usar prefork y quiere multiples solicitudes, puede configurar la directiva H2MinWorkers para hacerlo posible. Sin embargo, si esto falla, es bajo su cuenta y riesgo.

    +
    top
    +
    +

    Clientes

    + + +

    Casi todos los navegadores modernos dan soporte a HTTP/2, pero solo en conexiones SSL: Firefox (v43), Chrome (v45), Safari (since v9), iOS Safari (v9), Opera (v35), Chrome para Android (v49) e Internet Explorer (v11 en Windows10) (Fuente).

    + +

    Otros clientes, así cómo otros servidores, están listados en la + wiki de Implementaciones, entre ellos, implementaciones para c, c++, common lisp, dart, erlang, haskell, java, nodejs, php, python, perl, ruby, rust, scala y swift.

    + +

    Muchos de las implementaciones de clientes que no son navegadores soportan HTTP/2 sobre texto plano, h2c. La más versátil es curl.

    +
    top
    +
    +

    Herramientas útiles para depurar HTTP/2

    + + +

    La primera herramienta a mencionar es por supuesto curl. Por favor asegúrese de que su versión soporta HTTP/2 comprobando sus Características:

    + 
        $ curl -V
+    curl 7.45.0 (x86_64-apple-darwin15.0.0) libcurl/7.45.0 OpenSSL/1.0.2d zlib/1.2.8 nghttp2/1.3.4
+    Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 [...] 
+    Features: IPv6 Largefile NTLM NTLM_WB SSL libz TLS-SRP HTTP2
+
    + +

    Notas sobre Mac OS homebrew

    + brew install curl --with-openssl --with-nghttp2 +
    +

    Y para una inspección en gran profundidad wireshark.

    +

    El paquete nghttp2 también incluye clientes, tales como:

    +
      +
    • nghttp + - util para visualizar la frames de HTTP/2 y tener una mejor idea de como funciona el protocolo.
      • +
    • h2load - útil para hacer un stress-test de su servidor.
      • +
    + +

    Chrome ofrece logs detallados de HTTP/2 en sus conexiones a través de la página especial de net-internals. También hay una extensión interesante para Chrome y Firefox con la que visualizar cuando su navegador usa HTTP/2.

    +
    top
    +
    +

    Server Push

    + + +

    El protocolo HTTP/2 permite al servidor hacer PUSH de respuestas a un cliente que nunca las solicitó. El tono de la conversación es: "Aquí tiene una solicitud que nunca envió y la respuesta llegará pronto..."

    + +

    Pero hay restricciones: el cliente puede deshabilitar esta característica y el servidor entonces solo podrá hacer PUSH en una solicitud que hizo previamente del cliente.

    + +

    La intención es permitir al servidor enviar recursos que el cliente seguramente vaya a necesitar, p. ej. un recurso css o javascript que pertenece a una página html que el cliente solicitó, un grupo de imágenes a las que se hace referencia en un css, etc.

    + +

    La ventaja para el cliente es que ahorra tiempo para solicitudes que pueden tardar desde unos pocos milisegundos a medio segundo, dependiendo de la distancia entre el cliente y el servidor. La desventaja es que el cliente puede recibir cosas que ya tiene en su cache. Por supuesto que HTTP/2 soporta cancelación previa de tales solicitudes, pero aun así se malgastan recursos.

    + +

    Resumiendo: no hay una estrategia mejor sobre cómo usar esta característica de HTTP/2 y todo el mundo está experimentando con ella. Así que, ¿cómo experimenta usted con ella en Apache httpd?

    + +

    mod_http2 busca e inspecciona las cabeceras de respuesta + Link con cierto formato:

    + + 
    Link </xxx.css>;rel=preload, </xxx.js>; rel=preload
    + + +

    Si la conexión soporta PUSH, estos dos recursos se enviarán al cliente. Como desarrollador web, puede configurar estas cabeceras o bien directamente en la respuesta de su aplicación o configurar su servidor con:

    + + 
    <Location /xxx.html>
+    Header add Link "</xxx.css>;rel=preload"
+    Header add Link "</xxx.js>;rel=preload"
+</Location>
    + + +

    Si quiere usar enlaces con preload sin activar un PUSH, puede usar el parámetro nopush, como en:

    + + 
    Link </xxx.css>;rel=preload;nopush
    + + +

    o puede desactivar PUSH para su servidor por completo con la directiva

    + + 
    H2Push Off
    + + +

    Y hay más:

    + +

    El módulo mantiene un registro de lo que se ha enviado con PUSH para cada conexión (hashes de URLs, básicamente) y no hará PUSH del mismo recurso dos veces. Cuando la conexión se cierra, la información es descartada.

    + +

    Hay gente pensando cómo un cliente puede decirle al servidor lo que ya tiene, para evitar los PUSH de esos elementos, pero eso algo muy experimental ahora mismo.

    + +

    Otro borrador experimental que ha sido implementado en + mod_http2 es el Campo de Cabecera + Accept-Push-Policy en la que un cliente puede, para cada solicitud, definir qué tipo de PUSH acepta.

    +
    +
    +

    Idiomas disponibles:  en  | + es  | + fr 

    +
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    +//--> \ No newline at end of file diff --git a/docs/manual/howto/index.html.en b/docs/manual/howto/index.html.en index 311e1b2603..f62884f569 100644 --- a/docs/manual/howto/index.html.en +++ b/docs/manual/howto/index.html.en @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4

    How-To / Tutorials

    Available Languages:  en  | + es  |  fr  |  ja  |  ko  | @@ -154,6 +155,7 @@

    Available Languages:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/index.html.es b/docs/manual/howto/index.html.es index bfa15fbf27..8cea301966 100644 --- a/docs/manual/howto/index.html.es +++ b/docs/manual/howto/index.html.es @@ -1,163 +1,163 @@ - - - - + + + + -How-To / Tutoriales - Servidor Apache HTTP Versión 2.4 - - - - - - -

    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    -
    -
    <-
    -

    How-To / Tutoriales

    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko  | - zh-cn 

    -
    -
    -
    top
    -
    -

    How-To / Tutoriales

    - - - -
    -
    Autenticación y Autorización
    -
    -

    Autenticación es un proceso en el cual se verifica - que alguien es quien afirma ser. Autorización es cualquier - proceso en el que se permite a alguien acceder donde quiere ir, - o a obtener la información que desea tener.

    - -

    Ver: Autenticación, Autorización

    -
    -
    - -
    -
    Control de Acceso
    -
    -

    Control de acceso hace referencia al proceso de restringir, o - garantizar el acceso a un recurso en base a un criterio arbitrario. - Esto se puede conseguir de distintas formas.

    - -

    Ver: Control de Acceso

    -
    -
    - -
    -
    Contenido Dinámico con CGI
    -
    -

    El CGI (Common Gateway Interface) es un método por el cual - un servidor web puede interactuar con programas externos de - generación de contenido, a ellos nos referimos comúnmente como - programas CGI o scripts CGI. Es un método sencillo para mostrar - contenido dinámico en tu sitio web. Este documento es una - introducción para configurar CGI en tu servidor web Apache, y de - inicio para escribir programas CGI.

    - -

    Ver: CGI: Contenido Dinámico

    -
    -
    - -
    -
    Ficheros .htaccess
    -
    -

    Los ficheros .htaccess facilitan una forma de - hacer configuraciones por-directorio. Un archivo, que - contiene una o más directivas de configuración, se coloca en un - directorio específico y las directivas especificadas solo aplican - sobre ese directorio y los subdirectorios del mismo.

    - -

    Ver: .htaccess files

    -
    -
    - -
    -
    HTTP/2 con httpd
    -
    -

    HTTP/2 es la evolución del protocolo de capa de aplicación más conocido, HTTP. - Se centra en hacer un uso más eficiente de los recursos de red sin cambiar la - semántica de HTTP. Esta guía explica como se implementa HTTP/2 en httpd, - mostrando buenas prácticas y consejos de configuración básica. -

    - -

    Ver: Guía HTTP/2

    -
    -
    - - -
    -
    Introducción a los SSI
    -
    -

    Los SSI (Server Side Includes) son directivas que se colocan - en las páginas HTML, y son evaluadas por el servidor mientras - éste las sirve. Le permiten añadir contenido generado - dinámicamente a una página HTML existente, sin tener que servir - la página entera a través de un programa CGI u otro método - dinámico.

    - -

    Ver: Server Side Includes (SSI)

    -
    -
    - -
    -
    Directorios web Por-usuario
    -
    -

    En sistemas con múltiples usuarios, cada usuario puede tener - su directorio "home" compartido usando la directiva - UserDir. Aquellos - que visiten la URL http://example.com/~username/ - obtendrán contenido del directorio del usuario "username" - que se encuentra en el directorio "home" del sistema.

    - -

    Ver: - Directorios Web de Usuario (public_html)

    -
    -
    - -
    -
    Guía de Proxy Inverso
    -
    -

    Apache httpd ofrece muchas posibilidades como proxy inverso. Usando la - directiva ProxyPass así como - BalancerMember puede crear - sofisticadas configuraciones de proxy inverso que proveen de alta - disponibilidad, balanceo de carga, clustering basado en la nube y - reconfiguración dinámica en caliente.

    - -

    Ver: Guía de Proxy Inverso

    -
    -
    - -
    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko  | - zh-cn 

    -
    + + +
    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    +
    +
    <-
    +

    How-To / Tutoriales

    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko  | + zh-cn 

    +
    +
    +
    top
    +
    +

    How-To / Tutoriales

    + + + +
    +
    Autenticación y Autorización
    +
    +

    Autenticación es un proceso en el cual se verifica + que alguien es quien afirma ser. Autorización es cualquier + proceso en el que se permite a alguien acceder donde quiere ir, + o a obtener la información que desea tener.

    + +

    Ver: Autenticación, Autorización

    +
    +
    + +
    +
    Control de Acceso
    +
    +

    Control de acceso hace referencia al proceso de restringir, o + garantizar el acceso a un recurso en base a un criterio arbitrario. + Esto se puede conseguir de distintas formas.

    + +

    Ver: Control de Acceso

    +
    +
    + +
    +
    Contenido Dinámico con CGI
    +
    +

    El CGI (Common Gateway Interface) es un método por el cual + un servidor web puede interactuar con programas externos de + generación de contenido, a ellos nos referimos comúnmente como + programas CGI o scripts CGI. Es un método sencillo para mostrar + contenido dinámico en tu sitio web. Este documento es una + introducción para configurar CGI en tu servidor web Apache, y de + inicio para escribir programas CGI.

    + +

    Ver: CGI: Contenido Dinámico

    +
    +
    + +
    +
    Ficheros .htaccess
    +
    +

    Los ficheros .htaccess facilitan una forma de + hacer configuraciones por-directorio. Un archivo, que + contiene una o más directivas de configuración, se coloca en un + directorio específico y las directivas especificadas solo aplican + sobre ese directorio y los subdirectorios del mismo.

    + +

    Ver: .htaccess files

    +
    +
    + +
    +
    HTTP/2 con httpd
    +
    +

    HTTP/2 es la evolución del protocolo de capa de aplicación más conocido, HTTP. + Se centra en hacer un uso más eficiente de los recursos de red sin cambiar la + semántica de HTTP. Esta guía explica como se implementa HTTP/2 en httpd, + mostrando buenas prácticas y consejos de configuración básica. +

    + +

    Ver: Guía HTTP/2

    +
    +
    + + +
    +
    Introducción a los SSI
    +
    +

    Los SSI (Server Side Includes) son directivas que se colocan + en las páginas HTML, y son evaluadas por el servidor mientras + éste las sirve. Le permiten añadir contenido generado + dinámicamente a una página HTML existente, sin tener que servir + la página entera a través de un programa CGI u otro método + dinámico.

    + +

    Ver: Server Side Includes (SSI)

    +
    +
    + +
    +
    Directorios web Por-usuario
    +
    +

    En sistemas con múltiples usuarios, cada usuario puede tener + su directorio "home" compartido usando la directiva + UserDir. Aquellos + que visiten la URL http://example.com/~username/ + obtendrán contenido del directorio del usuario "username" + que se encuentra en el directorio "home" del sistema.

    + +

    Ver: + Directorios Web de Usuario (public_html)

    +
    +
    + +
    +
    Guía de Proxy Inverso
    +
    +

    Apache httpd ofrece muchas posibilidades como proxy inverso. Usando la + directiva ProxyPass así como + BalancerMember puede crear + sofisticadas configuraciones de proxy inverso que proveen de alta + disponibilidad, balanceo de carga, clustering basado en la nube y + reconfiguración dinámica en caliente.

    + +

    Ver: Guía de Proxy Inverso

    +
    +
    + +
    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko  | + zh-cn 

    +
    +//--> \ No newline at end of file diff --git a/docs/manual/howto/index.html.ja.utf8 b/docs/manual/howto/index.html.ja.utf8 index a9aad377b2..72f3dbe8f9 100644 --- a/docs/manual/howto/index.html.ja.utf8 +++ b/docs/manual/howto/index.html.ja.utf8 @@ -24,6 +24,7 @@ Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.4

    How-To / チュートリアル

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko  | @@ -116,6 +117,7 @@

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/index.html.ko.euc-kr b/docs/manual/howto/index.html.ko.euc-kr index 60b3f50880..8fe5e27fed 100644 --- a/docs/manual/howto/index.html.ko.euc-kr +++ b/docs/manual/howto/index.html.ko.euc-kr @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4

    How-To / ÅõÅ丮¾ó

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko  | @@ -108,6 +109,7 @@

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/index.html.zh-cn.utf8 b/docs/manual/howto/index.html.zh-cn.utf8 index 36ae690bf7..2b375a389f 100644 --- a/docs/manual/howto/index.html.zh-cn.utf8 +++ b/docs/manual/howto/index.html.zh-cn.utf8 @@ -24,6 +24,7 @@ Apache > HTTP 服务器 > 文档 > 版本 2.4

    常见操作/教程

    可用语言:  en  | + es  |  fr  |  ja  |  ko  | @@ -105,6 +106,7 @@

    可用语言:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/public_html.html.en b/docs/manual/howto/public_html.html.en index 1893ccf3f4..e494ff568c 100644 --- a/docs/manual/howto/public_html.html.en +++ b/docs/manual/howto/public_html.html.en @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4 > How-To / Tutorials

    Per-user web directories

    Available Languages:  en  | + es  |  fr  |  ja  |  ko  | @@ -185,6 +186,7 @@ UserDir enabled rbowen krietz

    Available Languages:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/public_html.html.es b/docs/manual/howto/public_html.html.es index d69a2a3e7f..e2349a8a18 100644 --- a/docs/manual/howto/public_html.html.es +++ b/docs/manual/howto/public_html.html.es @@ -1,195 +1,195 @@ - - - - + + + + -Directorios web por usuario - Servidor Apache HTTP Versión 2.4 - - - - - - -

    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    -
    -
    <-
    -

    Directorios web por usuario

    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko  | - tr 

    -
    - -

    En sistemas con múltiples usuarios, cada usuario puede tener un website - en su directorio home usando la directiva UserDir. Los visitantes de una URL - http://example.com/~username/ recibirán el contenido del - directorio home del usuario "username", en el subdirectorio - especificado por la directiva UserDir.

    - -

    Tenga en cuenta que, por defecto, el acceso a estos directorios - NO está activado. Puede permitir acceso cuando usa - UserDir quitando el comentario de la línea:

    - - 
    #Include conf/extra/httpd-userdir.conf
    - - -

    En el fichero por defecto de configuración conf/httpd.conf, - y adaptando el fichero httpd-userdir.conf según sea necesario, - o incluyendo las directivas apropiadas en un bloque - <Directory> dentro del fichero - principal de configuración.

    -
    - -
    top
    -
    -

    Directorios web por usuario

    - -
    Módulos RelacionadosDirectivas Relacionadas
    -
    top
    -
    -

    Configurando la ruta del fichero con UserDir

    - - -

    La directiva UserDir - especifica un directorio del que cargar contenido por usuario. Esta directiva - puede tener muchas formas distintas.

    - -

    Si se especifica una ruta que no empieza con una barra ("/"), se asume que - va a ser una ruta de directorio relativa al directorio home del usuario - especificado. Dada ésta configuración:

    - - 
    UserDir public_html
    - - -

    La URL http://example.com/~rbowen/file.html se traducirá en - la ruta del fichero /home/rbowen/public_html/file.html

    - -

    Si la ruta que se especifica comienza con una barra ("/"), la ruta del - directorio se construirá usando esa ruta, más el usuario especificado en la - configuración:

    - - 
    UserDir /var/html
    - - -

    La URL http://example.com/~rbowen/file.html se traducirá en - la ruta del fichero /var/html/rbowen/file.html

    - -

    Si se especifica una ruta que contiene un asterisco (*), se usará una ruta - en la que el asterisco se reemplaza con el nombre de usuario. Dada ésta configuración:

    - - 
    UserDir /var/www/*/docs
    - - -

    La URL http://example.com/~rbowen/file.html se traducirá en - la ruta del fichero /var/www/rbowen/docs/file.html

    - -

    También se pueden configurar múltiples directorios o rutas de directorios.

    - - 
    UserDir public_html /var/html
    - - -

    Para la URL http://example.com/~rbowen/file.html, - Apache buscará ~rbowen. Si no lo encuentra, Apache buscará - rbowen en /var/html. Si lo encuentra, la URL de más - arriba se traducirá en la ruta del fichero - /var/html/rbowen/file.html

    - -
    top
    -
    -

    Redirigiendo a URLs externas

    - -

    La directiva UserDir puede - usarse para redirigir solcitudes de directorios de usuario a URLs externas.

    - - 
    UserDir http://example.org/users/*/
    - - -

    El ejemplo de aquí arriba redirigirá una solicitud para - http://example.com/~bob/abc.html hacia - http://example.org/users/bob/abc.html.

    -
    top
    -
    -

    Restringiendo qué usuarios pueden usar esta característica

    - - -

    Usando la sintaxis que se muestra en la documentación de UserDir, usted - puede restringir a qué usuarios se les permite usar esta funcionalidad:

    - - 
    UserDir disabled root jro fish
    - - -

    La configuración de aquí arriba permitirá a todos los usuarios excepto a - los que se listan con la declaración disabled. Usted puede, - del mismo modo, deshabilitar esta característica para todos excepto algunos - usuarios usando una configuración como la siguiente:

    - - 
    UserDir disabled
-UserDir enabled rbowen krietz
    - - -

    Vea la documentación de UserDir para más - ejemplos.

    - -
    top
    -
    -

    Activando un directorio cgi para cada usuario

    - - -

    Para dar a cada usuario su propio directorio cgi-bin, puede usar una directiva - <Directory> - para activar cgi en un subdirectorio en particular del directorio home del usuario.

    - - 
    <Directory "/home/*/public_html/cgi-bin/">
-    Options ExecCGI
-    SetHandler cgi-script
-</Directory>
    - - -

    Entonces, asumiendo que UserDir está configurado con la - declaración public_html, un programa cgi example.cgi - podría cargarse de ese directorio así:

    - -

    - http://example.com/~rbowen/cgi-bin/example.cgi -

    - -
    top
    -
    -

    Permitiendo a usuarios cambiar la configuración

    - - -

    Si quiere permitir que usuarios modifiquen la configuración del servidor en - su espacio web, necesitarán usar ficheros .htaccess para hacer - estos cambios. Asegúrese de tener configurado AllowOverride con un valor suficiente que permita a - los usuarios modificar las directivas que quiera permitir. - Vea el tutorial de .htaccess para obtener detalles adicionales sobre cómo funciona.

    - -
    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko  | - tr 

    -
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    + --> +Directorios web por usuario - Servidor Apache HTTP Versión 2.4 + + + + + + +
    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    +
    +
    <-
    +

    Directorios web por usuario

    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko  | + tr 

    +
    + +

    En sistemas con múltiples usuarios, cada usuario puede tener un website + en su directorio home usando la directiva UserDir. Los visitantes de una URL + http://example.com/~username/ recibirán el contenido del + directorio home del usuario "username", en el subdirectorio + especificado por la directiva UserDir.

    + +

    Tenga en cuenta que, por defecto, el acceso a estos directorios + NO está activado. Puede permitir acceso cuando usa + UserDir quitando el comentario de la línea:

    + + 
    #Include conf/extra/httpd-userdir.conf
    + + +

    En el fichero por defecto de configuración conf/httpd.conf, + y adaptando el fichero httpd-userdir.conf según sea necesario, + o incluyendo las directivas apropiadas en un bloque + <Directory> dentro del fichero + principal de configuración.

    +
    + +
    top
    +
    +

    Directorios web por usuario

    + +
    Módulos RelacionadosDirectivas Relacionadas
    +
    top
    +
    +

    Configurando la ruta del fichero con UserDir

    + + +

    La directiva UserDir + especifica un directorio del que cargar contenido por usuario. Esta directiva + puede tener muchas formas distintas.

    + +

    Si se especifica una ruta que no empieza con una barra ("/"), se asume que + va a ser una ruta de directorio relativa al directorio home del usuario + especificado. Dada ésta configuración:

    + + 
    UserDir public_html
    + + +

    La URL http://example.com/~rbowen/file.html se traducirá en + la ruta del fichero /home/rbowen/public_html/file.html

    + +

    Si la ruta que se especifica comienza con una barra ("/"), la ruta del + directorio se construirá usando esa ruta, más el usuario especificado en la + configuración:

    + + 
    UserDir /var/html
    + + +

    La URL http://example.com/~rbowen/file.html se traducirá en + la ruta del fichero /var/html/rbowen/file.html

    + +

    Si se especifica una ruta que contiene un asterisco (*), se usará una ruta + en la que el asterisco se reemplaza con el nombre de usuario. Dada ésta configuración:

    + + 
    UserDir /var/www/*/docs
    + + +

    La URL http://example.com/~rbowen/file.html se traducirá en + la ruta del fichero /var/www/rbowen/docs/file.html

    + +

    También se pueden configurar múltiples directorios o rutas de directorios.

    + + 
    UserDir public_html /var/html
    + + +

    Para la URL http://example.com/~rbowen/file.html, + Apache buscará ~rbowen. Si no lo encuentra, Apache buscará + rbowen en /var/html. Si lo encuentra, la URL de más + arriba se traducirá en la ruta del fichero + /var/html/rbowen/file.html

    + +
    top
    +
    +

    Redirigiendo a URLs externas

    + +

    La directiva UserDir puede + usarse para redirigir solcitudes de directorios de usuario a URLs externas.

    + + 
    UserDir http://example.org/users/*/
    + + +

    El ejemplo de aquí arriba redirigirá una solicitud para + http://example.com/~bob/abc.html hacia + http://example.org/users/bob/abc.html.

    +
    top
    +
    +

    Restringiendo qué usuarios pueden usar esta característica

    + + +

    Usando la sintaxis que se muestra en la documentación de UserDir, usted + puede restringir a qué usuarios se les permite usar esta funcionalidad:

    + + 
    UserDir disabled root jro fish
    + + +

    La configuración de aquí arriba permitirá a todos los usuarios excepto a + los que se listan con la declaración disabled. Usted puede, + del mismo modo, deshabilitar esta característica para todos excepto algunos + usuarios usando una configuración como la siguiente:

    + + 
    UserDir disabled
+UserDir enabled rbowen krietz
    + + +

    Vea la documentación de UserDir para más + ejemplos.

    + +
    top
    +
    +

    Activando un directorio cgi para cada usuario

    + + +

    Para dar a cada usuario su propio directorio cgi-bin, puede usar una directiva + <Directory> + para activar cgi en un subdirectorio en particular del directorio home del usuario.

    + + 
    <Directory "/home/*/public_html/cgi-bin/">
+    Options ExecCGI
+    SetHandler cgi-script
+</Directory>
    + + +

    Entonces, asumiendo que UserDir está configurado con la + declaración public_html, un programa cgi example.cgi + podría cargarse de ese directorio así:

    + +

    + http://example.com/~rbowen/cgi-bin/example.cgi +

    + +
    top
    +
    +

    Permitiendo a usuarios cambiar la configuración

    + + +

    Si quiere permitir que usuarios modifiquen la configuración del servidor en + su espacio web, necesitarán usar ficheros .htaccess para hacer + estos cambios. Asegúrese de tener configurado AllowOverride con un valor suficiente que permita a + los usuarios modificar las directivas que quiera permitir. + Vea el tutorial de .htaccess para obtener detalles adicionales sobre cómo funciona.

    + +
    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko  | + tr 

    +
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    +//--> \ No newline at end of file diff --git a/docs/manual/howto/public_html.html.ja.utf8 b/docs/manual/howto/public_html.html.ja.utf8 index 1cee03c76b..22501ed9a6 100644 --- a/docs/manual/howto/public_html.html.ja.utf8 +++ b/docs/manual/howto/public_html.html.ja.utf8 @@ -24,6 +24,7 @@ Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.4 > How-To / チュートリアル

    ユーザ毎のウェブディレクトリ

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko  | @@ -195,6 +196,7 @@

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/public_html.html.ko.euc-kr b/docs/manual/howto/public_html.html.ko.euc-kr index a764b858d8..cf8eb85558 100644 --- a/docs/manual/howto/public_html.html.ko.euc-kr +++ b/docs/manual/howto/public_html.html.ko.euc-kr @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4 > How-To / Tutorials

    »ç¿ëÀÚº° À¥µð·ºÅ丮

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko  | @@ -157,6 +158,7 @@

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/howto/public_html.html.tr.utf8 b/docs/manual/howto/public_html.html.tr.utf8 index fff6be5268..7d6e81b3f8 100644 --- a/docs/manual/howto/public_html.html.tr.utf8 +++ b/docs/manual/howto/public_html.html.tr.utf8 @@ -24,6 +24,7 @@ Apache > HTTP Sunucusu > Belgeleme > Sürüm 2.4 > Nasıllar ve Öğreticiler

    Kullanıcı Dizinleri (public_html)

    Mevcut Diller:  en  | + es  |  fr  |  ja  |  ko  | @@ -196,6 +197,7 @@ UserDir enabled orhan yasar

    Mevcut Diller:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/index.html.es b/docs/manual/index.html.es index aa56a1a0f0..1c5106c125 100644 --- a/docs/manual/index.html.es +++ b/docs/manual/index.html.es @@ -7,7 +7,7 @@ This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> -Versión 2.4 de la documentación del Servidor de HTTP Apache - Servidor Apache HTTP Versión 2.4 +Versión 2.4 de la documentación del Servidor de HTTP Apache - Servidor Apache HTTP Versión 2.4 @@ -17,81 +17,81 @@

    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    <-
    -

    Versión 2.4 de la documentación del Servidor de HTTP Apache

    +Apache > Servidor HTTP > Documentación
    +

    Versión 2.4 de la documentación del Servidor de HTTP Apache

    Idiomas disponibles:  da  |  de  |  en  | - es  | - fr  | + es  | + fr  |  ja  |  ko  | - pt-br  | - tr  | + pt-br  | + tr  |  zh-cn 

    -

    -

    Notas de la Versión

    +

    + - + + + + + - - - - - - - + + + + + - - + - - - - + + + - - - + - - + - - - - - + + + + - - + - - - + - - - - + - - - - - - - - - + + + + - - - - - - - - + + + + + - - + - - - - - - + + + + + - - - - - - + + + + + - - - - - - - - - - + + + + + + + + + - - - + - - - - - - + + + + + - - - - + + + - - - + - - - - + - - - - + + + - - - - - - + - - - + + - - - - + - - - - + + + - - - - - - - + + + + - - - - + - - + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + @@ -995,8 +999,10 @@ handshake - - + + + + diff --git a/docs/manual/mod/quickreference.html.en b/docs/manual/mod/quickreference.html.en index 94f8f34375..59a1250975 100644 --- a/docs/manual/mod/quickreference.html.en +++ b/docs/manual/mod/quickreference.html.en @@ -263,229 +263,233 @@ authentication succeeds but authorization fails - + + + + + - - - - - - - + + + + + - - + - - - - + + + - - - + - - + - - - - - + + + + - - + - - - + - - - - + - - - - - - - - - + + + + - - - - - - - - + + + + + - - + - - - - - - + + + + + - - - - - - + + + + + - - - - - - - - - - + + + + + + + + + - - - + - - - - - - + + + + + - - - - + + + - - - + - - - - + - - - - + + + - - - - - - + + + - - - + + - - - - + - - - - + + + - - - - - - - + + + + - - - - + - - + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + @@ -983,8 +987,10 @@ handshake - - + + + + diff --git a/docs/manual/mod/quickreference.html.es b/docs/manual/mod/quickreference.html.es index 21ae6dd13d..b7dce8e475 100644 --- a/docs/manual/mod/quickreference.html.es +++ b/docs/manual/mod/quickreference.html.es @@ -7,7 +7,7 @@ This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> -Guía Rápida de Referencia de Directivas - Servidor Apache HTTP Versión 2.4 +Guía Rápida de Referencia de Directivas - Servidor Apache HTTP Versión 2.4 @@ -17,39 +17,39 @@
    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    <-
    -

    Guía Rápida de Referencia de Directivas

    +Apache > Servidor HTTP > Documentación > Versión 2.4 > Módulos
    +

    Guía Rápida de Referencia de Directivas

    Idiomas disponibles:  de  |  en  | - es  | - fr  | + es  | + fr  |  ja  |  ko  | - tr  | + tr  |  zh-cn 

    -

    La Guía Rápida de Referencia de Directivas muestra el uso, las +

    La Guía Rápida de Referencia de Directivas muestra el uso, las opciones por defecto, el estado y el contexto de cada directiva de - configuración de Apache. Para más información sobre cada + configuración de Apache. Para más información sobre cada directiva, consulte el Diccionario de Directivas.

    La primera columna muestra el nombre y el uso de la directiva. La segunda columna muestra el valor por defecto de la directiva, si existe ese valor por defecto. Si el valor por defecto es - demasiado largo para mostrarlo, el primer carácter va seguido de + demasiado largo para mostrarlo, el primer carácter va seguido de un signo "+".

    La tercera y la cuarta columna listan los contextos en los que la directiva puede funcionar y el estado de la directiva de - acuerdo con las notas que detallan más abajo.

    + acuerdo con las notas que detallan más abajo.

    Notas de la Versión

    Manual de Referencia

    -

    Guía del Usuario

    +

    Guía del Usuario

    How-To / Tutoriales

    -

    Notas específicas sobre plataformas

    +

    Notas específicas sobre plataformas

    Otros Temas

    @@ -111,16 +111,16 @@ ejecución

    Idiomas disponibles:  da  |  de  |  en  | - es  | - fr  | + es  | + fr  |  ja  |  ko  | - pt-br  | - tr  | + pt-br  | + tr  |  zh-cn 

    - - -
    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    -
    -
    <-
    -

    Términos que se Usan para Describir Directivas

    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko  | - tr 

    -
    - -

    Este documento describe los términos que se usan para describir - cada directiva de configuración de - Apache.

    -
    - -
    top
    -
    -

    Descripción

    - -

    Una breve descripción del propósito de la directiva.

    -
    top
    -
    -

    Sintaxis

    - -

    Indica el formato de la directiva tal y como aparecería en un fichero de - configuración. Esta sintaxis es muy específica de cada directiva, y se - describe con detalle en la definición de la directiva. Generalmente, el - nombre de la directiva va seguido de una serie de uno o más parámetros - separados por un espacio. Si un parámetro contiene un espacio, éste debe - especificarse entre comillas dobles. Los parámetros opcionales van - especificados entre corchetes. Donde un parámetro puede tener uno o más - valores, los valores posibles se separan con barras verticales "|". El Texto - Literal se muestra con la fuente por defecto, mientras que los distintos - tipos de parámetros para los que una sustitución resulta necesaria son - enfatizados. Las directivas que pueden tomar una lista variada de - parámetros acaban en "..." indicando que el último parámetro se repite.

    - -

    Las Directivas usan un gran número de diferentes tipos de parámetros. A - continuación definimos algunos de los más comunes.

    - -
    -
    URL
    -
    Un Localizador de Recursos Uniforme, incluye un esquema, - nombre de host, y un path opcional como en - http://www.example.com/path/to/file.html
    - -
    Ruta de URL
    -
    La parte de una url que sigue al esquema y el - nombre de host como en /path/to/file.html. El - url-path representa una vista-web de un recurso, en - contraposición a una vista de sistema-de-ficheros.
    - -
    Ruta del Fichero
    -
    La ruta a un fichero en el sistema de ficheros local que - comienza desde el directorio raíz como en - /usr/local/apache/htdocs/path/to/file.html. - A menos que se especifique, una ruta de fichero que no comienza - con una barra "/" se tratará como una ruta relativa a ServerRoot.
    - -
    Ruta del Directorio
    - -
    La ruta a un directorio en el sistema de ficheros local que - comienza con el directorio ráiz como en - /usr/local/apache/htdocs/path/to/.
    - -
    Nombre del Fichero
    - -
    El nombre de un fichero sin ir acompañado de información de la ruta - como en file.html.
    - -
    regex
    - -
    Una - expresión regular compatible con Perl. La definición - de directiva especificará contra qué se compara la - regex.
    - -
    extensión
    - -
    En general, esta es la parte del nombre de fichero - que sigue al último punto. Sin embargo, Apache reconoce múltiples - extensiones de fichero, así que si un nombre de fichero - contiene más de un punto, cada parte separada por un punto del - nombre de fichero después del primer punto es una extensión. - Por ejemplo, el nombre de fichero file.html.en - contiene dos extensiones: .html y - .en. Para las directivas de Apache, podrá especificar - la extensiones con o sin el punto inicial. Además, las - extensiones no son sensibles a mayúsculas o minúsculas.
    - -
    Tipo MIME
    - -
    Un método de describir el formato de un fichero que está formado - por un tipo de formato mayor y un tipo de formato menor, separados de - de una barra como en text/html.
    - -
    Variable de Entorno
    - -
    El nombre de una variable de entorno - definida en el proceso de configuración de Apache. Tenga en cuenta - que esto no es necesariamente lo mismo que la variable de entorno - de un sistema operativo. Vea la documentación de variable de entorno para - más detalles.
    -
    -
    top
    -
    -

    Por defecto

    - -

    Si la directiva tiene un valor por defecto (p.ej., si - la omite de la configuración completamente, el servidor Web Apache - se comportará como si la hubiera configurado con un valor en - particular), se describe aquí. Si no tiene valor por defecto, esta - sección debería indicar "Ninguno". Tenga en cuenta que el - valor por defecto listado aquí no es necesariamente el mismo que el - valor que toma la directiva en el httpd.conf por defecto distribuido - con el servidor.

    -
    top
    -
    -

    Contexto

    - -

    Esto indica dónde se acepta la directiva en los ficheros de - configuración. Es una lista separada por comas para uno o más de los - siguientes valores:

    - -
    -
    server config
    - -
    Esto indica que la directiva puede usarse en los ficheros de - configuración del servidor (p.ej., httpd.conf), - pero not dentro de cualquier contenedor - <VirtualHost> - o <Directory>. - No se permite en ficheros .htaccess de ninguna - manera.
    - -
    virtual host
    - -
    Este contexto significa que la directiva puede aparecer dentro de un - contenedor <VirtualHost> - en el fichero de configuración del servidor.
    - -
    directory
    - -
    Una directiva marcada como válida en este contexto puede usarse dentro - de contenedores <Directory>, <Location>, <Files>, <If>, <Proxy> en los ficheros de - configuración del servidor, sujeta a las restricciones destacadas en - las Secciones de Configuración.
    - -
    .htaccess
    - -
    Si una directiva es válida en este contexto, significa que puede - aparecer dentro de ficheros .htaccess de contexto de - directorio. Aunque podría no ser procesada, dependiendo de la - configuración activa de AllowOverride en ese - momento.
    -
    - -

    La directiva solo se permite dentro del contexto designado; si - intenta usarlo en algún otro, obtendrá un error de configuración que - impedirá que el servidor gestione correctamente las solicitudes en ese - contexto, o impedirá que el servidor pueda funcionar completamente -- - p.ej., el servidor no arrancará.

    - -

    Las ubicaciones válidas para la directiva son actualmente el resultado de - un Boolean OR de todos los contextos listados. En otras palabras, una - directiva que está marcada como válida en - "server config, .htaccess" puede usarse en el fichero - httpd.conf y en ficheros .htaccess, pero no dentro - de contenedores <Directory> - o <VirtualHost>.

    -
    top
    -
    -

    Override

    - -

    Este atributo de directiva indica qué Override de configuración debe - estar activo para que la directiva se procese cuando aparece en un fichero - .htaccess. Si el contexto de la - directiva no permite que aparezca en ficheros .htaccess, - entonces no se listará ningún contexto.

    - -

    Los Override se activan con la directiva AllowOverride, si se aplican a un ámbito en - particular (como por ejemplo un directorio) y todos sus descendientes, a - menos que se modifique más adelante por otras directivas - AllowOverride en niveles - inferiores. La documentación para la directiva también muestra una lista de - los posibles nombres de Override disponibles.

    -
    top
    -
    -

    Estado

    - -

    Esto indica cuan vinculada está esta directiva al servidor Web de Apache; - o en otras palabras, puede que necesite recompilar el servidor con un - conjunto mejor de módulos para obtener acceso a esta directiva y su - funcionalidad. Valores posibles para estar directiva son:

    - -
    -
    Core
    - -
    Si una directiva aparece listada con estado "Core", eso significa - que forma parte de las partes más internas del Servidor Apache Web, y que - siempre está disponible.
    - -
    MPM
    - -
    La directivas facilitadas por un - Módulo de Multi-Proceso están etiquetadas con - Estado "MPM". Este tipo de directiva estará disponible si y sólo si está - usando uno de los MPM listados en la línea Módulo - de la definición de la directiva.
    - -
    Base
    - -
    Una directiva listada con estado "Base" está facilitada por uno - de los módulos estándar de Apache que están compilados con el servidor - por defecto, y por tanto está normalmente disponible a menos que usted - haga las acciones necesarias para eliminar este módulo de su - configuración.
    - -
    Extensión
    - -
    Una directiva con estado "Extensión" está facilitada por uno de los - módulos incluidos en el kit del servidor Apache, pero el módulo no - está compilado generalmente dentro del servidor. Para activar esta y su - funcionalidad, necesirará cambiar la configuración de compilación - del servidor y recompilar Apache.
    - -
    Experimental
    - -
    El estado "Experimental" indica que la directiva está disponible como - parte del kit de Apache, pero usted tendrá que ir por su cuenta si intenta - usarla. La directiva se documenta para aportar información, pero no tiene - por qué estar soportada de manera oficial. El módulo que provee esta - directiva puede o puede que no esté compilado por defecto, compruebe - la parte superior de la página que describe la direcitiva y el módulo para - ver las anotaciones sobre su disponibilidad.
    -
    -
    top
    -
    -

    Módulo

    - -

    Esto simplemente hace referencia al nombre del módulo original que provee - la directiva.

    -
    top
    -
    -

    Compatibilidad

    - -

    Si la directiva no era parte de la distribución original de Apache - versión 2, la versión en la que se introdujo debería estar referida aquí. - Además, si la direcitva solo está disponible en ciertas plataformas, se verá - anotado aquí.

    -
    -
    -

    Idiomas disponibles:  en  | - es  | - fr  | - ja  | - ko  | - tr 

    -
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    + --> +Términos que se Usan para Describir Directivas - Servidor Apache HTTP Versión 2.4 + + + + + + +
    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    +
    +
    <-
    +

    Términos que se Usan para Describir Directivas

    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko  | + tr 

    +
    + +

    Este documento describe los términos que se usan para describir + cada directiva de configuración de + Apache.

    +
    + +
    top
    +
    +

    Descripción

    + +

    Una breve descripción del propósito de la directiva.

    +
    top
    +
    +

    Sintaxis

    + +

    Indica el formato de la directiva tal y como aparecería en un fichero de + configuración. Esta sintaxis es muy específica de cada directiva, y se + describe con detalle en la definición de la directiva. Generalmente, el + nombre de la directiva va seguido de una serie de uno o más parámetros + separados por un espacio. Si un parámetro contiene un espacio, éste debe + especificarse entre comillas dobles. Los parámetros opcionales van + especificados entre corchetes. Donde un parámetro puede tener uno o más + valores, los valores posibles se separan con barras verticales "|". El Texto + Literal se muestra con la fuente por defecto, mientras que los distintos + tipos de parámetros para los que una sustitución resulta necesaria son + enfatizados. Las directivas que pueden tomar una lista variada de + parámetros acaban en "..." indicando que el último parámetro se repite.

    + +

    Las Directivas usan un gran número de diferentes tipos de parámetros. A + continuación definimos algunos de los más comunes.

    + +
    +
    URL
    +
    Un Localizador de Recursos Uniforme, incluye un esquema, + nombre de host, y un path opcional como en + http://www.example.com/path/to/file.html
    + +
    Ruta de URL
    +
    La parte de una url que sigue al esquema y el + nombre de host como en /path/to/file.html. El + url-path representa una vista-web de un recurso, en + contraposición a una vista de sistema-de-ficheros.
    + +
    Ruta del Fichero
    +
    La ruta a un fichero en el sistema de ficheros local que + comienza desde el directorio raíz como en + /usr/local/apache/htdocs/path/to/file.html. + A menos que se especifique, una ruta de fichero que no comienza + con una barra "/" se tratará como una ruta relativa a ServerRoot.
    + +
    Ruta del Directorio
    + +
    La ruta a un directorio en el sistema de ficheros local que + comienza con el directorio ráiz como en + /usr/local/apache/htdocs/path/to/.
    + +
    Nombre del Fichero
    + +
    El nombre de un fichero sin ir acompañado de información de la ruta + como en file.html.
    + +
    regex
    + +
    Una + expresión regular compatible con Perl. La definición + de directiva especificará contra qué se compara la + regex.
    + +
    extensión
    + +
    En general, esta es la parte del nombre de fichero + que sigue al último punto. Sin embargo, Apache reconoce múltiples + extensiones de fichero, así que si un nombre de fichero + contiene más de un punto, cada parte separada por un punto del + nombre de fichero después del primer punto es una extensión. + Por ejemplo, el nombre de fichero file.html.en + contiene dos extensiones: .html y + .en. Para las directivas de Apache, podrá especificar + la extensiones con o sin el punto inicial. Además, las + extensiones no son sensibles a mayúsculas o minúsculas.
    + +
    Tipo MIME
    + +
    Un método de describir el formato de un fichero que está formado + por un tipo de formato mayor y un tipo de formato menor, separados de + de una barra como en text/html.
    + +
    Variable de Entorno
    + +
    El nombre de una variable de entorno + definida en el proceso de configuración de Apache. Tenga en cuenta + que esto no es necesariamente lo mismo que la variable de entorno + de un sistema operativo. Vea la documentación de variable de entorno para + más detalles.
    +
    +
    top
    +
    +

    Por defecto

    + +

    Si la directiva tiene un valor por defecto (p.ej., si + la omite de la configuración completamente, el servidor Web Apache + se comportará como si la hubiera configurado con un valor en + particular), se describe aquí. Si no tiene valor por defecto, esta + sección debería indicar "Ninguno". Tenga en cuenta que el + valor por defecto listado aquí no es necesariamente el mismo que el + valor que toma la directiva en el httpd.conf por defecto distribuido + con el servidor.

    +
    top
    +
    +

    Contexto

    + +

    Esto indica dónde se acepta la directiva en los ficheros de + configuración. Es una lista separada por comas para uno o más de los + siguientes valores:

    + +
    +
    server config
    + +
    Esto indica que la directiva puede usarse en los ficheros de + configuración del servidor (p.ej., httpd.conf), + pero not dentro de cualquier contenedor + <VirtualHost> + o <Directory>. + No se permite en ficheros .htaccess de ninguna + manera.
    + +
    virtual host
    + +
    Este contexto significa que la directiva puede aparecer dentro de un + contenedor <VirtualHost> + en el fichero de configuración del servidor.
    + +
    directory
    + +
    Una directiva marcada como válida en este contexto puede usarse dentro + de contenedores <Directory>, <Location>, <Files>, <If>, <Proxy> en los ficheros de + configuración del servidor, sujeta a las restricciones destacadas en + las Secciones de Configuración.
    + +
    .htaccess
    + +
    Si una directiva es válida en este contexto, significa que puede + aparecer dentro de ficheros .htaccess de contexto de + directorio. Aunque podría no ser procesada, dependiendo de la + configuración activa de AllowOverride en ese + momento.
    +
    + +

    La directiva solo se permite dentro del contexto designado; si + intenta usarlo en algún otro, obtendrá un error de configuración que + impedirá que el servidor gestione correctamente las solicitudes en ese + contexto, o impedirá que el servidor pueda funcionar completamente -- + p.ej., el servidor no arrancará.

    + +

    Las ubicaciones válidas para la directiva son actualmente el resultado de + un Boolean OR de todos los contextos listados. En otras palabras, una + directiva que está marcada como válida en + "server config, .htaccess" puede usarse en el fichero + httpd.conf y en ficheros .htaccess, pero no dentro + de contenedores <Directory> + o <VirtualHost>.

    +
    top
    +
    +

    Override

    + +

    Este atributo de directiva indica qué Override de configuración debe + estar activo para que la directiva se procese cuando aparece en un fichero + .htaccess. Si el contexto de la + directiva no permite que aparezca en ficheros .htaccess, + entonces no se listará ningún contexto.

    + +

    Los Override se activan con la directiva AllowOverride, si se aplican a un ámbito en + particular (como por ejemplo un directorio) y todos sus descendientes, a + menos que se modifique más adelante por otras directivas + AllowOverride en niveles + inferiores. La documentación para la directiva también muestra una lista de + los posibles nombres de Override disponibles.

    +
    top
    +
    +

    Estado

    + +

    Esto indica cuan vinculada está esta directiva al servidor Web de Apache; + o en otras palabras, puede que necesite recompilar el servidor con un + conjunto mejor de módulos para obtener acceso a esta directiva y su + funcionalidad. Valores posibles para estar directiva son:

    + +
    +
    Core
    + +
    Si una directiva aparece listada con estado "Core", eso significa + que forma parte de las partes más internas del Servidor Apache Web, y que + siempre está disponible.
    + +
    MPM
    + +
    La directivas facilitadas por un + Módulo de Multi-Proceso están etiquetadas con + Estado "MPM". Este tipo de directiva estará disponible si y sólo si está + usando uno de los MPM listados en la línea Módulo + de la definición de la directiva.
    + +
    Base
    + +
    Una directiva listada con estado "Base" está facilitada por uno + de los módulos estándar de Apache que están compilados con el servidor + por defecto, y por tanto está normalmente disponible a menos que usted + haga las acciones necesarias para eliminar este módulo de su + configuración.
    + +
    Extensión
    + +
    Una directiva con estado "Extensión" está facilitada por uno de los + módulos incluidos en el kit del servidor Apache, pero el módulo no + está compilado generalmente dentro del servidor. Para activar esta y su + funcionalidad, necesirará cambiar la configuración de compilación + del servidor y recompilar Apache.
    + +
    Experimental
    + +
    El estado "Experimental" indica que la directiva está disponible como + parte del kit de Apache, pero usted tendrá que ir por su cuenta si intenta + usarla. La directiva se documenta para aportar información, pero no tiene + por qué estar soportada de manera oficial. El módulo que provee esta + directiva puede o puede que no esté compilado por defecto, compruebe + la parte superior de la página que describe la direcitiva y el módulo para + ver las anotaciones sobre su disponibilidad.
    +
    +
    top
    +
    +

    Módulo

    + +

    Esto simplemente hace referencia al nombre del módulo original que provee + la directiva.

    +
    top
    +
    +

    Compatibilidad

    + +

    Si la directiva no era parte de la distribución original de Apache + versión 2, la versión en la que se introdujo debería estar referida aquí. + Además, si la direcitva solo está disponible en ciertas plataformas, se verá + anotado aquí.

    +
    +
    +

    Idiomas disponibles:  en  | + es  | + fr  | + ja  | + ko  | + tr 

    +
    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    +//--> \ No newline at end of file diff --git a/docs/manual/mod/directive-dict.html.ja.utf8 b/docs/manual/mod/directive-dict.html.ja.utf8 index 807be8fea9..1db0f3603b 100644 --- a/docs/manual/mod/directive-dict.html.ja.utf8 +++ b/docs/manual/mod/directive-dict.html.ja.utf8 @@ -24,6 +24,7 @@ Apache > HTTP サーバ > ドキュメンテーション > バージョン 2.4

    ディレクティブの解説に使われる用語

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko  | @@ -301,6 +302,7 @@

    翻訳済み言語:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/mod/directive-dict.html.ko.euc-kr b/docs/manual/mod/directive-dict.html.ko.euc-kr index b59bd9a797..e869fd666a 100644 --- a/docs/manual/mod/directive-dict.html.ko.euc-kr +++ b/docs/manual/mod/directive-dict.html.ko.euc-kr @@ -24,6 +24,7 @@ Apache > HTTP Server > Documentation > Version 2.4

    Áö½Ã¾î¸¦ ¼³¸íÇϴµ¥ »ç¿ëÇÑ ¿ë¾îµé

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko  | @@ -251,6 +252,7 @@

    °¡´ÉÇÑ ¾ð¾î:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/mod/directive-dict.html.tr.utf8 b/docs/manual/mod/directive-dict.html.tr.utf8 index 28f4ef24d4..cc17ffcb22 100644 --- a/docs/manual/mod/directive-dict.html.tr.utf8 +++ b/docs/manual/mod/directive-dict.html.tr.utf8 @@ -24,6 +24,7 @@ Apache > HTTP Sunucusu > Belgeleme > Sürüm 2.4

    Yönergeleri Tanımlamakta Kullanılan Terimler

    Mevcut Diller:  en  | + es  |  fr  |  ja  |  ko  | @@ -272,6 +273,7 @@

    Mevcut Diller:  en  | + es  |  fr  |  ja  |  ko  | diff --git a/docs/manual/mod/directives.html.de b/docs/manual/mod/directives.html.de index dddf454be9..158f510d83 100644 --- a/docs/manual/mod/directives.html.de +++ b/docs/manual/mod/directives.html.de @@ -155,6 +155,11 @@

  • BalancerInherit
  • BalancerMember
  • BalancerPersist
    • +
  • BrotliAlterETag
    • +
  • BrotliCompressionMaxInputBlock
    • +
  • BrotliCompressionQuality
    • +
  • BrotliCompressionWindow
    • +
  • BrotliFilterNote
  • BrowserMatch
  • BrowserMatchNoCase
  • BufferedLogs
    • @@ -297,7 +302,6 @@
  • H2PushPriority
  • H2PushResource
  • H2SerializeHeaders
    • -
  • H2SessionExtraFiles
  • H2StreamMaxMemSize
  • H2TLSCoolDownSecs
  • H2TLSWarmUpSize
    • @@ -599,8 +603,10 @@
  • SSLInsecureRenegotiation
  • SSLOCSPDefaultResponder
  • SSLOCSPEnable
    • +
  • SSLOCSPNoverify
  • SSLOCSPOverrideResponder
  • SSLOCSPProxyURL
    • +
  • SSLOCSPResponderCertificateFile
  • SSLOCSPResponderTimeout
  • SSLOCSPResponseMaxAge
  • SSLOCSPResponseTimeSkew
    • diff --git a/docs/manual/mod/directives.html.en b/docs/manual/mod/directives.html.en index e8d0dff7a0..308b1c4f70 100644 --- a/docs/manual/mod/directives.html.en +++ b/docs/manual/mod/directives.html.en @@ -156,6 +156,11 @@
  • BalancerInherit
  • BalancerMember
  • BalancerPersist
    • +
  • BrotliAlterETag
    • +
  • BrotliCompressionMaxInputBlock
    • +
  • BrotliCompressionQuality
    • +
  • BrotliCompressionWindow
    • +
  • BrotliFilterNote
  • BrowserMatch
  • BrowserMatchNoCase
  • BufferedLogs
    • @@ -298,7 +303,6 @@
  • H2PushPriority
  • H2PushResource
  • H2SerializeHeaders
    • -
  • H2SessionExtraFiles
  • H2StreamMaxMemSize
  • H2TLSCoolDownSecs
  • H2TLSWarmUpSize
    • @@ -600,8 +604,10 @@
  • SSLInsecureRenegotiation
  • SSLOCSPDefaultResponder
  • SSLOCSPEnable
    • +
  • SSLOCSPNoverify
  • SSLOCSPOverrideResponder
  • SSLOCSPProxyURL
    • +
  • SSLOCSPResponderCertificateFile
  • SSLOCSPResponderTimeout
  • SSLOCSPResponseMaxAge
  • SSLOCSPResponseTimeSkew
    • diff --git a/docs/manual/mod/directives.html.es b/docs/manual/mod/directives.html.es index 1722d01660..b479b75f61 100644 --- a/docs/manual/mod/directives.html.es +++ b/docs/manual/mod/directives.html.es @@ -7,7 +7,7 @@ This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> -Índice de Directivas - Servidor Apache HTTP Versión 2.4 +Índice de Directivas - Servidor Apache HTTP Versión 2.4 @@ -16,35 +16,35 @@
    -

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    -

    Versión 2.4 del Servidor HTTP Apache

    +

    Módulos | Directivas | Preguntas Frecuentes | Glosario | Mapa del sitio web

    +

    Versión 2.4 del Servidor HTTP Apache

    <-

    Índice de Directivas

    Idiomas disponibles:  de  |  en  | - es  | - fr  | + es  | + fr  |  ja  |  ko  | - tr  | + tr  |  zh-cn 

    - Todas las directivas disponibles en la distribución - estándar de Apache están en la lista que se muestra más + Todas las directivas disponibles en la distribución + estándar de Apache están en la lista que se muestra más abajo. Cada una se describe usando un formato uniforme, y existe un glosario - de los términos usados en las descripciones que puede + de los términos usados en las descripciones que puede consultar.

    - También existe una Guía Rápida de - Referencia de Directivas con información de cada + También existe una Guía Rápida de + Referencia de Directivas con información de cada directiva de forma resumida.

    @@ -158,6 +158,11 @@
  • BalancerInherit
  • BalancerMember
  • BalancerPersist
    • +
  • BrotliAlterETag
    • +
  • BrotliCompressionMaxInputBlock
    • +
  • BrotliCompressionQuality
    • +
  • BrotliCompressionWindow
    • +
  • BrotliFilterNote
  • BrowserMatch
  • BrowserMatchNoCase
  • BufferedLogs
    • @@ -601,8 +606,10 @@
  • SSLInsecureRenegotiation
  • SSLOCSPDefaultResponder
  • SSLOCSPEnable
    • +
  • SSLOCSPNoverify
  • SSLOCSPOverrideResponder
  • SSLOCSPProxyURL
    • +
  • SSLOCSPResponderCertificateFile
  • SSLOCSPResponderTimeout
  • SSLOCSPResponseMaxAge
  • SSLOCSPResponseTimeSkew
    • @@ -693,11 +700,11 @@

    Idiomas disponibles:  de  |  en  | - es  | - fr  | + es  | + fr  |  ja  |  ko  | - tr  | + tr  |  zh-cn 

    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    + + + +
    +

    Modules | Directives | FAQ | Glossary | Sitemap

    +

    Apache HTTP Server Version 2.4

    +
    +
    <-
    + +
    +

    Apache Module mod_brotli

    +
    +

    Available Languages:  en 

    +
    + + + + +
    Description:Compress content via Brotli before it is delivered to the +client
    Status:Extension
    Module Identifier:brotli_module
    Source File:mod_brotli.c
    Compatibility:Available in version 2.4.26 and later.
    +

    Summary

    + +

    The mod_brotli module provides + the BROTLI_COMPRESS output filter that allows output from + your server to be compressed using the brotli compression format before being sent to the client over + the network. This module uses the Brotli library found at + https://github.com/google/brotli.

    +
    + +
    top
    +
    +

    Sample Configurations

    +

    Compression and TLS

    +

    Some web applications are vulnerable to an information disclosure + attack when a TLS connection carries compressed data. For more + information, review the details of the "BREACH" family of attacks.

    +
    +

    This is a simple configuration that compresses common text-based content types.

    + +

    Compress only a few types

    AddOutputFilterByType BROTLI_COMPRESS text/html text/plain text/xml text/css text/javascript application/javascript
    +
    + +
    top
    +
    +

    Enabling Compression

    +

    Compression and TLS

    +

    Some web applications are vulnerable to an information disclosure + attack when a TLS connection carries compressed data. For more + information, review the details of the "BREACH" family of attacks.

    +
    + +

    Output Compression

    +

    Compression is implemented by the BROTLI_COMPRESS + filter. The following directive + will enable compression for documents in the container where it + is placed:

    + + 
    SetOutputFilter BROTLI_COMPRESS
+SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-brotli
    + + +

    If you want to restrict the compression to particular MIME types + in general, you may use the AddOutputFilterByType directive. Here is an example of + enabling compression only for the html files of the Apache + documentation:

    + + 
    <Directory "/your-server-root/manual">
+    AddOutputFilterByType BROTLI_COMPRESS text/html
+</Directory>
    + + +

    Note

    + The BROTLI_COMPRESS filter is always inserted after RESOURCE + filters like PHP or SSI. It never touches internal subrequests. +
    +

    Note

    + There is an environment variable no-brotli, + set via SetEnv, which + will disable brotli compression for a particular request, even if + it is supported by the client. +
    + + + +
    top
    +
    +

    Dealing with proxy servers

    + +

    The mod_brotli module sends a Vary: + Accept-Encoding HTTP response header to alert proxies that + a cached response should be sent only to clients that send the + appropriate Accept-Encoding request header. This + prevents compressed content from being sent to a client that will + not understand it.

    + +

    If you use some special exclusions dependent + on, for example, the User-Agent header, you must + manually configure an addition to the Vary header + to alert proxies of the additional restrictions. For example, + in a typical configuration where the addition of the BROTLI_COMPRESS + filter depends on the User-Agent, you should add:

    + + 
    Header append Vary User-Agent
    + + +

    If your decision about compression depends on other information + than request headers (e.g. HTTP version), you have to set the + Vary header to the value *. This prevents + compliant proxies from caching entirely.

    + +

    Example

    Header set Vary *
    +
    +
    top
    +
    +

    Serving pre-compressed +content

    + +

    Since mod_brotli re-compresses content each + time a request is made, some performance benefit can be derived by + pre-compressing the content and telling mod_brotli to serve them + without re-compressing them. This may be accomplished using a + configuration like the following:

    + + 
    <IfModule mod_headers.c>
+    # Serve brotli compressed CSS files if they exist
+    # and the client accepts brotli.
+    RewriteCond "%{HTTP:Accept-encoding}" "br"
+    RewriteCond "%{REQUEST_FILENAME}\.br" "-s"
+    RewriteRule "^(.*)\.css"              "$1\.css\.br" [QSA]
+
+    # Serve brotli compressed JS files if they exist
+    # and the client accepts brotli.
+    RewriteCond "%{HTTP:Accept-encoding}" "br"
+    RewriteCond "%{REQUEST_FILENAME}\.br" "-s"
+    RewriteRule "^(.*)\.js"               "$1\.js\.br" [QSA]
+
+
+    # Serve correct content types, and prevent double compression.
+    RewriteRule "\.css\.br$" "-" [T=text/css,E=no-brotli:1]
+    RewriteRule "\.js\.br$"  "-" [T=text/javascript,E=no-brotli:1]
+
+
+    <FilesMatch "(\.js\.br|\.css\.br)$">
+      # Serve correct encoding type.
+      Header append Content-Encoding br
+
+      # Force proxies to cache brotli &
+      # non-brotli css/js files separately.
+      Header append Vary Accept-Encoding
+    </FilesMatch>
+</IfModule>
    + + +
    +
    top
    +

    BrotliAlterETag Directive

    + + + + + + + +
    Description:How the outgoing ETag header should be modified during compression
    Syntax:BrotliAlterETag AddSuffix|NoChange|Remove
    Default:BrotliAlterETag AddSuffix
    Context:server config, virtual host
    Status:Extension
    Module:mod_brotli
    +

    The BrotliAlterETag directive specifies + how the ETag hader should be altered when a response is compressed.

    +
    +
    AddSuffix
    +

    Append the compression method onto the end of the ETag, causing + compressed and uncompressed representations to have unique ETags. + In another dynamic compression module, mod_deflate, this has been + the default since 2.4.0. This setting prevents serving "HTTP Not + Modified" (304) responses to conditional requests for compressed + content.

    +
    NoChange
    +

    Don't change the ETag on a compressed response. In another dynamic + compression module, mod_deflate, this has been the default prior to + 2.4.0. This setting does not satisfy the HTTP/1.1 property that all + representations of the same resource have unique ETags.

    +
    Remove
    +

    Remove the ETag header from compressed responses. This prevents + some conditional requests from being possible, but avoids the + shortcomings of the preceding options.

    +
    + +
    +
    top
    +

    BrotliCompressionMaxInputBlock Directive

    + + + + + + + +
    Description:Maximum input block size
    Syntax:BrotliCompressionMaxInputBlock value
    Default:(automatic)
    Context:server config, virtual host
    Status:Extension
    Module:mod_brotli
    +

    The BrotliCompressionMaxInputBlock directive specifies + the maximum input block size between 16 and 24, with the caveat that + larger block sizes require more memory.

    + +
    +
    top
    +

    BrotliCompressionQuality Directive

    + + + + + + + +
    Description:Compression quality
    Syntax:BrotliCompressionQuality value
    Default:BrotliCompressionQuality 5
    Context:server config, virtual host
    Status:Extension
    Module:mod_brotli
    +

    The BrotliCompressionQuality directive specifies + the compression quality (a value between 0 and 11). Higher quality values + result in better, but also slower compression. +

    + +
    +
    top
    +

    BrotliCompressionWindow Directive

    + + + + + + + +
    Description:Brotli sliding compression window size
    Syntax:BrotliCompressionWindow value
    Default:BrotliCompressionWindow 18
    Context:server config, virtual host
    Status:Extension
    Module:mod_brotli
    +

    The BrotliCompressionWindow directive specifies the + brotli sliding compression window size (a value between 10 and 24). Larger + window sizes can improve compression quality, but require more memory.

    + +
    +
    top
    +

    BrotliFilterNote Directive

    + + + + + + +
    Description:Places the compression ratio in a note for logging
    Syntax:BrotliFilterNote [type] notename
    Context:server config, virtual host
    Status:Extension
    Module:mod_brotli
    +

    The BrotliFilterNote directive + specifies that a note about compression ratios should be attached + to the request. The name of the note is the value specified for + the directive. You can use that note for statistical purposes by + adding the value to your access log.

    + +

    Example

    BrotliFilterNote ratio
+
+LogFormat '"%r" %b (%{ratio}n) "%{User-agent}i"' brotli
+CustomLog "logs/brotli_log" brotli
    +
    + +

    If you want to extract more accurate values from your logs, you + can use the type argument to specify the type of data + left as a note for logging. type can be one of:

    + +
    +
    Input
    +
    Store the byte count of the filter's input stream in the note.
    + +
    Output
    +
    Store the byte count of the filter's output stream in the note.
    + +
    Ratio
    +
    Store the compression ratio (output/input * 100) + in the note. This is the default, if the type argument + is omitted.
    +
    + +

    Thus you may log it this way:

    + +

    Accurate Logging

    BrotliFilterNote Input instream
+BrotliFilterNote Output outstream
+BrotliFilterNote Ratio ratio
+
+LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' brotli
+CustomLog "logs/brotli_log" brotli
    +
    + +

    See also

    + +
    +
    +
    +

    Available Languages:  en 

    +
    top

    Comments

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.
    +
    + \ No newline at end of file diff --git a/docs/manual/mod/mod_brotli.xml.meta b/docs/manual/mod/mod_brotli.xml.meta new file mode 100644 index 0000000000..8dc14b10a5 --- /dev/null +++ b/docs/manual/mod/mod_brotli.xml.meta @@ -0,0 +1,12 @@ + + + + + mod_brotli + /mod/ + .. + + + en + + diff --git a/docs/manual/mod/mod_http2.html.en b/docs/manual/mod/mod_http2.html.en index 4a152d6fe4..9964eb3cb0 100644 --- a/docs/manual/mod/mod_http2.html.en +++ b/docs/manual/mod/mod_http2.html.en @@ -95,7 +95,6 @@
  • H2PushPriority
  • H2PushResource
  • H2SerializeHeaders
    • -
  • H2SessionExtraFiles
  • H2StreamMaxMemSize
  • H2TLSCoolDownSecs
  • H2TLSWarmUpSize
    • @@ -167,17 +166,6 @@ the connection will buffer this amount of data and then suspend the H2Worker.

    -

    - If you serve a lot of static files, H2SessionExtraFiles - is of interest. This tells the server how many file handles per - HTTP/2 connection it is allowed to waste for better performance. Because - when a request produces a static file as the response, the file handle - gets passed around and is buffered and not the file contents. That allows - to serve many large files without wasting memory or copying data - unnecessarily. However file handles are a limited resource for a process, - and if too many are used this way, requests may fail under load as - the amount of open handles has been exceeded. -

    Multiple Hosts and Misdirected Requests

    @@ -722,41 +710,6 @@ H2PushPriority text/css interleaved # weight 256 default

    Example

    H2SerializeHeaders on
    -
    -
    top
    -

    H2SessionExtraFiles Directive

    - - - - - - -
    Description:Number of Extra File Handles
    Syntax:H2SessionExtraFiles n
    Context:server config, virtual host
    Status:Extension
    Module:mod_http2
    -

    - This directive sets maximum number of extra file handles - a HTTP/2 session is allowed to use. A file handle is counted as - extra when it is transferred from a h2 worker thread to - the main HTTP/2 connection handling. This commonly happens when - serving static files. -

    - Depending on the processing model configured on the server, the - number of connections times number of active streams may exceed - the number of file handles for the process. On the other hand, - converting every file into memory bytes early results in too - many buffer writes. This option helps to mitigate that. -

    - The number of file handles used by a server process is then in - the order of: -

    - 
    (h2_connections * extra_files) + (h2_max_worker)
    -

    Example

    H2SessionExtraFiles 10
    -
    -

    - If nothing is configured, the module tries to make a conservative - guess how many files are safe to use. This depends largely on the - MPM chosen. -

    -
    top

    H2StreamMaxMemSize Directive

    diff --git a/docs/manual/mod/mod_ssl.html.en b/docs/manual/mod/mod_ssl.html.en index c15f0e6a16..c318d1551a 100644 --- a/docs/manual/mod/mod_ssl.html.en +++ b/docs/manual/mod/mod_ssl.html.en @@ -73,8 +73,10 @@ to provide the cryptography engine.

  • SSLInsecureRenegotiation
  • SSLOCSPDefaultResponder
  • SSLOCSPEnable
    • +
  • SSLOCSPNoverify
  • SSLOCSPOverrideResponder
  • SSLOCSPProxyURL
    • +
  • SSLOCSPResponderCertificateFile
  • SSLOCSPResponderTimeout
  • SSLOCSPResponseMaxAge
  • SSLOCSPResponseTimeSkew
    • @@ -1092,6 +1094,21 @@ SSLOCSPDefaultResponder "http://responder.example.com:8888/responder" SSLOCSPOverrideResponder on
    +
    +
    top
    +

    SSLOCSPNoverify Directive

    + + + + + + + + +
    Description:skip the OCSP responder certificates verification
    Syntax:SSLOCSPNoverify On/Off
    Default:SSLOCSPNoverify Off
    Context:server config, virtual host
    Status:Extension
    Module:mod_ssl
    Compatibility:Available in httpd 2.5 and later, if using OpenSSL 0.9.7 or later
    +

    Skip the OCSP responder certificates verification, mostly useful when +testing an OCSP server.

    +
    top

    SSLOCSPOverrideResponder Directive

    @@ -1121,6 +1138,23 @@ certificate being validated references an OCSP responder.

    This option allows to set the URL of a HTTP proxy that should be used for all queries to OCSP responders.

    +
    +
    top
    +

    SSLOCSPResponderCertificateFile Directive

    + + + + + + + +
    Description:Set of trusted PEM encoded OCSP responder certificates
    Syntax:SSLOCSPResponderCertificateFile file
    Context:server config, virtual host
    Status:Extension
    Module:mod_ssl
    Compatibility:Available in httpd 2.5 and later, if using OpenSSL 0.9.7 or later
    +

    This supplies a list of trusted OCSP responder certificates to be used +during OCSP responder certificate validation. The supplied certificates are +implicitly trusted without any further validation. This is typically used +where the OCSP responder certificate is self signed or omitted from the OCSP +response.

    +
    top

    SSLOCSPResponderTimeout Directive

    diff --git a/docs/manual/mod/quickreference.html.de b/docs/manual/mod/quickreference.html.de index 93ce3a795e..dbabce2c95 100644 --- a/docs/manual/mod/quickreference.html.de +++ b/docs/manual/mod/quickreference.html.de @@ -267,230 +267,234 @@ authentication succeeds but authorization fails
    BalancerInherit On|Off On svE
    Inherit ProxyPassed Balancers/Workers from the main server
    BalancerMember [balancerurl] url [key=value [key=value ...]]dE
    Add a member to a load balancing group
    BalancerPersist On|Off Off svE
    Attempt to persist changes made by the Balancer Manager across restarts.
    BrowserMatch regex [!]env-variable[=value] -[[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on HTTP User-Agent +
    BrotliAlterETag AddSuffix|NoChange|Remove AddSuffix svE
    How the outgoing ETag header should be modified during compression
    BrotliCompressionMaxInputBlock valuesvE
    Maximum input block size
    BrotliCompressionQuality value 5 svE
    Compression quality
    BrotliCompressionWindow value 18 svE
    Brotli sliding compression window size
    BrotliFilterNote [type] notenamesvE
    Places the compression ratio in a note for logging
    BrowserMatch regex [!]env-variable[=value] +[[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on HTTP User-Agent
    BrowserMatchNoCase regex [!]env-variable[=value] - [[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on User-Agent without +
    BrowserMatchNoCase regex [!]env-variable[=value] + [[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on User-Agent without respect to case
    BufferedLogs On|Off Off sB
    Buffer log entries in memory before writing to disk
    BufferSize integer 131072 svdhE
    Maximum size in bytes to buffer by the buffer filter
    CacheDefaultExpire seconds 3600 (one hour) svdhE
    The default duration to cache a document when no expiry date is specified.
    CacheDetailHeader on|off off svdhE
    Add an X-Cache-Detail header to the response.
    CacheDirLength length 2 svE
    The number of characters in subdirectory names
    CacheDirLevels levels 2 svE
    The number of levels of subdirectories in the +
    BufferedLogs On|Off Off sB
    Buffer log entries in memory before writing to disk
    BufferSize integer 131072 svdhE
    Maximum size in bytes to buffer by the buffer filter
    CacheDefaultExpire seconds 3600 (one hour) svdhE
    The default duration to cache a document when no expiry date is specified.
    CacheDetailHeader on|off off svdhE
    Add an X-Cache-Detail header to the response.
    CacheDirLength length 2 svE
    The number of characters in subdirectory names
    CacheDirLevels levels 2 svE
    The number of levels of subdirectories in the cache.
    CacheDisable url-string | onsvdhE
    Disable caching of specified URLs
    CacheEnable cache_type [url-string]svdE
    Enable caching of specified URLs using a specified storage +
    CacheDisable url-string | onsvdhE
    Disable caching of specified URLs
    CacheEnable cache_type [url-string]svdE
    Enable caching of specified URLs using a specified storage manager
    CacheFile file-path [file-path] ...sX
    Cache a list of file handles at startup time
    CacheHeader on|off off svdhE
    Add an X-Cache header to the response.
    CacheIgnoreCacheControl On|Off Off svE
    Ignore request to not serve cached content to client
    CacheIgnoreHeaders header-string [header-string] ... None svE
    Do not store the given HTTP header(s) in the cache. +
    CacheFile file-path [file-path] ...sX
    Cache a list of file handles at startup time
    CacheHeader on|off off svdhE
    Add an X-Cache header to the response.
    CacheIgnoreCacheControl On|Off Off svE
    Ignore request to not serve cached content to client
    CacheIgnoreHeaders header-string [header-string] ... None svE
    Do not store the given HTTP header(s) in the cache.
    CacheIgnoreNoLastMod On|Off Off svdhE
    Ignore the fact that a response has no Last Modified +
    CacheIgnoreNoLastMod On|Off Off svdhE
    Ignore the fact that a response has no Last Modified header.
    CacheIgnoreQueryString On|Off Off svE
    Ignore query string when caching
    CacheIgnoreURLSessionIdentifiers identifier [identifier] ... None svE
    Ignore defined session identifiers encoded in the URL when caching +
    CacheIgnoreQueryString On|Off Off svE
    Ignore query string when caching
    CacheIgnoreURLSessionIdentifiers identifier [identifier] ... None svE
    Ignore defined session identifiers encoded in the URL when caching
    CacheKeyBaseURL URL http://example.com svE
    Override the base URL of reverse proxied cache keys.
    CacheLastModifiedFactor float 0.1 svdhE
    The factor used to compute an expiry date based on the +
    CacheKeyBaseURL URL http://example.com svE
    Override the base URL of reverse proxied cache keys.
    CacheLastModifiedFactor float 0.1 svdhE
    The factor used to compute an expiry date based on the LastModified date.
    CacheLock on|off off svE
    Enable the thundering herd lock.
    CacheLockMaxAge integer 5 svE
    Set the maximum possible age of a cache lock.
    CacheLockPath directory /tmp/mod_cache-lock +svE
    Set the lock path directory.
    CacheMaxExpire seconds 86400 (one day) svdhE
    The maximum time in seconds to cache a document
    CacheMaxFileSize bytes 1000000 svdhE
    The maximum size (in bytes) of a document to be placed in the +
    CacheLock on|off off svE
    Enable the thundering herd lock.
    CacheLockMaxAge integer 5 svE
    Set the maximum possible age of a cache lock.
    CacheLockPath directory /tmp/mod_cache-lock +svE
    Set the lock path directory.
    CacheMaxExpire seconds 86400 (one day) svdhE
    The maximum time in seconds to cache a document
    CacheMaxFileSize bytes 1000000 svdhE
    The maximum size (in bytes) of a document to be placed in the cache
    CacheMinExpire seconds 0 svdhE
    The minimum time in seconds to cache a document
    CacheMinFileSize bytes 1 svdhE
    The minimum size (in bytes) of a document to be placed in the +
    CacheMinExpire seconds 0 svdhE
    The minimum time in seconds to cache a document
    CacheMinFileSize bytes 1 svdhE
    The minimum size (in bytes) of a document to be placed in the cache
    CacheNegotiatedDocs On|Off Off svB
    Allows content-negotiated documents to be +
    CacheNegotiatedDocs On|Off Off svB
    Allows content-negotiated documents to be cached by proxy servers
    CacheQuickHandler on|off on svE
    Run the cache from the quick handler.
    CacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached +
    CacheQuickHandler on|off on svE
    Run the cache from the quick handler.
    CacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached before sending the data downstream
    CacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading +
    CacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading before data is sent downstream
    CacheRoot directorysvE
    The directory root under which cache files are +
    CacheRoot directorysvE
    The directory root under which cache files are stored
    CacheSocache type[:args]svE
    The shared object cache implementation to use
    CacheSocacheMaxSize bytes 102400 svdhE
    The maximum size (in bytes) of an entry to be placed in the +
    CacheSocache type[:args]svE
    The shared object cache implementation to use
    CacheSocacheMaxSize bytes 102400 svdhE
    The maximum size (in bytes) of an entry to be placed in the cache
    CacheSocacheMaxTime seconds 86400 svdhE
    The maximum time (in seconds) for a document to be placed in the +
    CacheSocacheMaxTime seconds 86400 svdhE
    The maximum time (in seconds) for a document to be placed in the cache
    CacheSocacheMinTime seconds 600 svdhE
    The minimum time (in seconds) for a document to be placed in the +
    CacheSocacheMinTime seconds 600 svdhE
    The minimum time (in seconds) for a document to be placed in the cache
    CacheSocacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached +
    CacheSocacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached before sending the data downstream
    CacheSocacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading +
    CacheSocacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading before data is sent downstream
    CacheStaleOnError on|off on svdhE
    Serve stale content in place of 5xx responses.
    CacheStoreExpired On|Off Off svdhE
    Attempt to cache responses that the server reports as expired
    CacheStoreNoStore On|Off Off svdhE
    Attempt to cache requests or responses that have been marked as no-store.
    CacheStorePrivate On|Off Off svdhE
    Attempt to cache responses that the server has marked as private
    CGIDScriptTimeout time[s|ms]svdhB
    The length of time to wait for more output from the +
    CacheStaleOnError on|off on svdhE
    Serve stale content in place of 5xx responses.
    CacheStoreExpired On|Off Off svdhE
    Attempt to cache responses that the server reports as expired
    CacheStoreNoStore On|Off Off svdhE
    Attempt to cache requests or responses that have been marked as no-store.
    CacheStorePrivate On|Off Off svdhE
    Attempt to cache responses that the server has marked as private
    CGIDScriptTimeout time[s|ms]svdhB
    The length of time to wait for more output from the CGI program
    CGIMapExtension CGI-Pfad .EndungdhC
    Technik zur Bestimmung des Interpreters für +
    CGIMapExtension CGI-Pfad .EndungdhC
    Technik zur Bestimmung des Interpreters für CGI-Skripte
    CGIPassAuth On|Off Off dhC
    Enables passing HTTP authorization headers to scripts as CGI +
    CGIPassAuth On|Off Off dhC
    Enables passing HTTP authorization headers to scripts as CGI variables
    CGIVar variable ruledhC
    Controls how some CGI variables are set
    CharsetDefault charsetsvdhE
    Charset to translate into
    CharsetOptions option [option] ... ImplicitAdd svdhE
    Configures charset translation behavior
    CharsetSourceEnc charsetsvdhE
    Source charset of files
    CheckCaseOnly on|off Off svdhE
    Limits the action of the speling module to case corrections
    CheckSpelling on|off Off svdhE
    Enables the spelling +
    CGIVar variable ruledhC
    Controls how some CGI variables are set
    CharsetDefault charsetsvdhE
    Charset to translate into
    CharsetOptions option [option] ... ImplicitAdd svdhE
    Configures charset translation behavior
    CharsetSourceEnc charsetsvdhE
    Source charset of files
    CheckCaseOnly on|off Off svdhE
    Limits the action of the speling module to case corrections
    CheckSpelling on|off Off svdhE
    Enables the spelling module
    ChrootDir /path/to/directorysB
    Directory for apache to run chroot(8) after startup.
    ContentDigest On|Off Off svdhC
    Aktiviert die Generierung von Content-MD5 +
    ChrootDir /path/to/directorysB
    Directory for apache to run chroot(8) after startup.
    ContentDigest On|Off Off svdhC
    Aktiviert die Generierung von Content-MD5 HTTP-Response-Headern
    CookieDomain domainsvdhE
    The domain to which the tracking cookie applies
    CookieExpires expiry-periodsvdhE
    Expiry time for the tracking cookie
    CookieName token Apache svdhE
    Name of the tracking cookie
    CookieStyle - Netscape|Cookie|Cookie2|RFC2109|RFC2965 Netscape svdhE
    Format of the cookie header field
    CookieTracking on|off off svdhE
    Enables tracking cookie
    CoreDumpDirectory VerzeichnissM
    Verzeichnis, in das der Apache zu wechseln versucht, bevor er +
    CookieDomain domainsvdhE
    The domain to which the tracking cookie applies
    CookieExpires expiry-periodsvdhE
    Expiry time for the tracking cookie
    CookieName token Apache svdhE
    Name of the tracking cookie
    CookieStyle + Netscape|Cookie|Cookie2|RFC2109|RFC2965 Netscape svdhE
    Format of the cookie header field
    CookieTracking on|off off svdhE
    Enables tracking cookie
    CoreDumpDirectory VerzeichnissM
    Verzeichnis, in das der Apache zu wechseln versucht, bevor er einen Hauptspeicherauszug erstellt
    CustomLog file|pipe +
    CustomLog file|pipe format|nickname [env=[!]environment-variable| -expr=expression]svB
    Sets filename and format of log file
    Dav On|Off|provider-name Off dE
    Enable WebDAV HTTP methods
    DavDepthInfinity on|off off svdE
    Allow PROPFIND, Depth: Infinity requests
    DavGenericLockDB file-pathsvdE
    Location of the DAV lock database
    DavLockDB file-pathsvE
    Location of the DAV lock database
    DavMinTimeout seconds 0 svdE
    Minimum amount of time the server holds a lock on +expr=expression]svB
    Sets filename and format of log file
    Dav On|Off|provider-name Off dE
    Enable WebDAV HTTP methods
    DavDepthInfinity on|off off svdE
    Allow PROPFIND, Depth: Infinity requests
    DavGenericLockDB file-pathsvdE
    Location of the DAV lock database
    DavLockDB file-pathsvE
    Location of the DAV lock database
    DavMinTimeout seconds 0 svdE
    Minimum amount of time the server holds a lock on a DAV resource
    DBDExptime time-in-seconds 300 svE
    Keepalive time for idle connections
    DBDInitSQL "SQL statement"svE
    Execute an SQL statement after connecting to a database
    DBDKeep number 2 svE
    Maximum sustained number of connections
    DBDMax number 10 svE
    Maximum number of connections
    DBDMin number 1 svE
    Minimum number of connections
    DBDParams -param1=value1[,param2=value2]svE
    Parameters for database connection
    DBDPersist On|OffsvE
    Whether to use persistent connections
    DBDPrepareSQL "SQL statement" labelsvE
    Define an SQL prepared statement
    DBDriver namesvE
    Specify an SQL driver
    DefaultIcon url-pathsvdhB
    Icon to display for files when no specific icon is +
    DBDExptime time-in-seconds 300 svE
    Keepalive time for idle connections
    DBDInitSQL "SQL statement"svE
    Execute an SQL statement after connecting to a database
    DBDKeep number 2 svE
    Maximum sustained number of connections
    DBDMax number 10 svE
    Maximum number of connections
    DBDMin number 1 svE
    Minimum number of connections
    DBDParams +param1=value1[,param2=value2]svE
    Parameters for database connection
    DBDPersist On|OffsvE
    Whether to use persistent connections
    DBDPrepareSQL "SQL statement" labelsvE
    Define an SQL prepared statement
    DBDriver namesvE
    Specify an SQL driver
    DefaultIcon url-pathsvdhB
    Icon to display for files when no specific icon is configured
    DefaultLanguage language-tagsvdhB
    Defines a default language-tag to be sent in the Content-Language +
    DefaultLanguage language-tagsvdhB
    Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means.
    DefaultRuntimeDir directory-path DEFAULT_REL_RUNTIME +sC
    Base directory for the server run-time files
    DefaultType MIME-Type text/plain svdhC
    MIME-Content-Type, der gesendet wird, wenn der Server den Typ +
    DefaultRuntimeDir directory-path DEFAULT_REL_RUNTIME +sC
    Base directory for the server run-time files
    DefaultType MIME-Type text/plain svdhC
    MIME-Content-Type, der gesendet wird, wenn der Server den Typ nicht auf andere Weise ermitteln kann.
    Define ParameternamesC
    Define the existence of a variable
    DeflateBufferSize value 8096 svE
    Fragment size to be compressed at one time by zlib
    DeflateCompressionLevel valuesvE
    How much compression do we apply to the output
    DeflateFilterNote [type] notenamesvE
    Places the compression ratio in a note for logging
    DeflateInflateLimitRequestBodyvaluesvdhE
    Maximum size of inflated request bodies
    DeflateInflateRatioBurst valuesvdhE
    Maximum number of times the inflation ratio for request bodies +
    Define ParameternamesC
    Define the existence of a variable
    DeflateBufferSize value 8096 svE
    Fragment size to be compressed at one time by zlib
    DeflateCompressionLevel valuesvE
    How much compression do we apply to the output
    DeflateFilterNote [type] notenamesvE
    Places the compression ratio in a note for logging
    DeflateInflateLimitRequestBodyvaluesvdhE
    Maximum size of inflated request bodies
    DeflateInflateRatioBurst valuesvdhE
    Maximum number of times the inflation ratio for request bodies can be crossed
    DeflateInflateRatioLimit valuesvdhE
    Maximum inflation ratio for request bodies
    DeflateMemLevel value 9 svE
    How much memory should be used by zlib for compression
    DeflateWindowSize value 15 svE
    Zlib compression window size
    Deny from all|host|env=[!]env-variable -[host|env=[!]env-variable] ...dhE
    Controls which hosts are denied access to the +
    DeflateInflateRatioLimit valuesvdhE
    Maximum inflation ratio for request bodies
    DeflateMemLevel value 9 svE
    How much memory should be used by zlib for compression
    DeflateWindowSize value 15 svE
    Zlib compression window size
    Deny from all|host|env=[!]env-variable +[host|env=[!]env-variable] ...dhE
    Controls which hosts are denied access to the server
    <Directory Verzeichnispfad> -... </Directory>svC
    Umschließt eine Gruppe von Direktiven, die nur auf +
    <Directory Verzeichnispfad> +... </Directory>svC
    Umschließt eine Gruppe von Direktiven, die nur auf das genannte Verzeichnis des Dateisystems und Unterverzeichnisse angewendet werden
    DirectoryCheckHandler On|Off Off svdhB
    Toggle how this module responds when another handler is configured
    DirectoryIndex - disabled | local-url [local-url] ... index.html svdhB
    List of resources to look for when the client requests +
    DirectoryCheckHandler On|Off Off svdhB
    Toggle how this module responds when another handler is configured
    DirectoryIndex + disabled | local-url [local-url] ... index.html svdhB
    List of resources to look for when the client requests a directory
    DirectoryIndexRedirect on | off | permanent | temp | seeother | +
    DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code - off svdhB
    Configures an external redirect for directory indexes. + off svdhB
    Configures an external redirect for directory indexes.
    <DirectoryMatch regex> -... </DirectoryMatch>svC
    Umschließt eine Gruppe von Direktiven, die auf +
    <DirectoryMatch regex> +... </DirectoryMatch>svC
    Umschließt eine Gruppe von Direktiven, die auf Verzeichnisse des Dateisystems und ihre Unterverzeichnisse abgebildet werden, welche auf einen regulären Ausdruck passen
    DirectorySlash On|Off On svdhB
    Toggle trailing slash redirects on or off
    DocumentRoot Verzeichnis /usr/local/apache/h +svC
    Verzeichnis, welches den Haupt-Dokumentenbaum bildet, der im +
    DirectorySlash On|Off On svdhB
    Toggle trailing slash redirects on or off
    DocumentRoot Verzeichnis /usr/local/apache/h +svC
    Verzeichnis, welches den Haupt-Dokumentenbaum bildet, der im Web sichtbar ist.
    DTracePrivileges On|Off Off sX
    Determines whether the privileges required by dtrace are enabled.
    DumpIOInput On|Off Off sE
    Dump all input data to the error log
    DumpIOOutput On|Off Off sE
    Dump all output data to the error log
    <Else> ... </Else>svdhC
    Contains directives that apply only if the condition of a +
    DTracePrivileges On|Off Off sX
    Determines whether the privileges required by dtrace are enabled.
    DumpIOInput On|Off Off sE
    Dump all input data to the error log
    DumpIOOutput On|Off Off sE
    Dump all output data to the error log
    <Else> ... </Else>svdhC
    Contains directives that apply only if the condition of a previous <If> or <ElseIf> section is not satisfied by a request at runtime
    <ElseIf expression> ... </ElseIf>svdhC
    Contains directives that apply only if a condition is satisfied +
    <ElseIf expression> ... </ElseIf>svdhC
    Contains directives that apply only if a condition is satisfied by a request at runtime while the condition of a previous <If> or <ElseIf> section is not satisfied
    EnableExceptionHook On|Off Off sM
    Aktiviert einen Hook, der nach einem Absturz noch +
    EnableExceptionHook On|Off Off sM
    Aktiviert einen Hook, der nach einem Absturz noch Ausnahmefehler behandeln lassen kann
    EnableMMAP On|Off On svdhC
    Verwende Memory-Mapping, um Dateien während der +
    EnableMMAP On|Off On svdhC
    Verwende Memory-Mapping, um Dateien während der Auslieferung zu lesen
    EnableSendfile On|Off On svdhC
    Verwende die sendfile-Unterstützung des Kernels, um +
    EnableSendfile On|Off On svdhC
    Verwende die sendfile-Unterstützung des Kernels, um Dateien an den Client auszuliefern
    Error messagesvdhC
    Abort configuration parsing with a custom error message
    ErrorDocument Fehlercode DokumentsvdhC
    Das, was der Server im Fehlerfall an den Client +
    Error messagesvdhC
    Abort configuration parsing with a custom error message
    ErrorDocument Fehlercode DokumentsvdhC
    Das, was der Server im Fehlerfall an den Client zurückgibt
    ErrorLog Dateiname|syslog[:facility] logs/error_log (Uni +svC
    Ablageort, an dem der Server Fehler protokolliert
    ErrorLogFormat [connection|request] formatsvC
    Format specification for error log entries
    ExamplesvdhX
    Demonstration directive to illustrate the Apache module +
    ErrorLog Dateiname|syslog[:facility] logs/error_log (Uni +svC
    Ablageort, an dem der Server Fehler protokolliert
    ErrorLogFormat [connection|request] formatsvC
    Format specification for error log entries
    ExamplesvdhX
    Demonstration directive to illustrate the Apache module API
    ExpiresActive On|Off Off svdhE
    Enables generation of Expires +
    ExpiresActive On|Off Off svdhE
    Enables generation of Expires headers
    ExpiresByType MIME-type -<code>secondssvdhE
    Value of the Expires header configured +
    ExpiresByType MIME-type +<code>secondssvdhE
    Value of the Expires header configured by MIME type
    ExpiresDefault <code>secondssvdhE
    Default algorithm for calculating expiration time
    ExtendedStatus On|Off Off[*] sC
    Keep track of extended status information for each +
    ExpiresDefault <code>secondssvdhE
    Default algorithm for calculating expiration time
    ExtendedStatus On|Off Off[*] sC
    Keep track of extended status information for each request
    ExtFilterDefine filtername parameterssE
    Define an external filter
    ExtFilterOptions option [option] ... NoLogStderr dE
    Configure mod_ext_filter options
    FallbackResource disabled | local-urlsvdhB
    Define a default URL for requests that don't map to a file
    FileETag Komponente ... INode MTime Size svdhC
    Dateiattribute, die zur Erstellung des HTTP-Response-Headers +
    ExtFilterDefine filtername parameterssE
    Define an external filter
    ExtFilterOptions option [option] ... NoLogStderr dE
    Configure mod_ext_filter options
    FallbackResource disabled | local-urlsvdhB
    Define a default URL for requests that don't map to a file
    FileETag Komponente ... INode MTime Size svdhC
    Dateiattribute, die zur Erstellung des HTTP-Response-Headers ETag verwendet werden
    <Files Dateiname> ... </Files>svdhC
    Enthält Direktiven, die sich nur auf passende Dateinamen +
    <Files Dateiname> ... </Files>svdhC
    Enthält Direktiven, die sich nur auf passende Dateinamen beziehen
    <FilesMatch regex> ... </FilesMatch>svdhC
    Enthält Direktiven, die für Dateinamen gelten, die +
    <FilesMatch regex> ... </FilesMatch>svdhC
    Enthält Direktiven, die für Dateinamen gelten, die auf einen regulären Ausdruck passen
    FilterChain [+=-@!]filter-name ...svdhB
    Configure the filter chain
    FilterDeclare filter-name [type]svdhB
    Declare a smart filter
    FilterProtocol filter-name [provider-name] - proto-flagssvdhB
    Deal with correct HTTP protocol handling
    FilterProvider filter-name provider-name - expressionsvdhB
    Register a content filter
    FilterTrace filter-name levelsvdB
    Get debug/diagnostic information from +
    FilterChain [+=-@!]filter-name ...svdhB
    Configure the filter chain
    FilterDeclare filter-name [type]svdhB
    Declare a smart filter
    FilterProtocol filter-name [provider-name] + proto-flagssvdhB
    Deal with correct HTTP protocol handling
    FilterProvider filter-name provider-name + expressionsvdhB
    Register a content filter
    FilterTrace filter-name levelsvdB
    Get debug/diagnostic information from mod_filter
    ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] Prefer svdhB
    Action to take if a single acceptable document is not +
    ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] Prefer svdhB
    Action to take if a single acceptable document is not found
    ForceType MIME-Type|NonedhC
    Erzwingt die Auslieferung aller passendenden Dateien mit dem +
    ForceType MIME-Type|NonedhC
    Erzwingt die Auslieferung aller passendenden Dateien mit dem angegebenen MIME-Content-Type
    ForensicLog filename|pipesvE
    Sets filename of the forensic log
    GlobalLogfile|pipe +
    ForensicLog filename|pipesvE
    Sets filename of the forensic log
    GlobalLogfile|pipe format|nickname [env=[!]environment-variable| -expr=expression]sB
    Sets filename and format of log file
    GprofDir /tmp/gprof/|/tmp/gprof/%svC
    Directory to write gmon.out profiling data to.
    GracefulShutdownTimeout seconds 0 sM
    Specify a timeout after which a gracefully shutdown server +expr=expression]sB
    Sets filename and format of log file
    GprofDir /tmp/gprof/|/tmp/gprof/%svC
    Directory to write gmon.out profiling data to.
    GracefulShutdownTimeout seconds 0 sM
    Specify a timeout after which a gracefully shutdown server will exit.
    Group unix-group #-1 sB
    Group under which the server will answer +
    Group unix-group #-1 sB
    Group under which the server will answer requests
    H2CopyFiles on|off off svdhE
    Determine file handling in responses
    H2Direct on|off on for h2c, off for +svE
    H2 Direct Protocol Switch
    H2EarlyHints on|off off svE
    Determine sending of 103 status codes
    H2MaxSessionStreams n 100 svE
    Maximum number of active streams per HTTP/2 session.
    H2MaxWorkerIdleSeconds n 600 sE
    Maximum number of seconds h2 workers remain idle until shut down.
    H2MaxWorkers nsE
    Maximum number of worker threads to use per child process.
    H2MinWorkers nsE
    Minimal number of worker threads to use per child process.
    H2ModernTLSOnly on|off on svE
    Require HTTP/2 connections to be "modern TLS" only
    H2Push on|off on svE
    H2 Server Push Switch
    H2PushDiarySize n 256 svE
    H2 Server Push Diary Size
    H2PushPriority mime-type [after|before|interleaved] [weight] * After 16 svE
    H2 Server Push Priority
    H2PushResource [add] path [critical]svdhE
    Declares resources for early pushing to the client
    H2SerializeHeaders on|off off svE
    Serialize Request/Response Processing Switch
    H2SessionExtraFiles nsvE
    Number of Extra File Handles
    H2CopyFiles on|off off svdhE
    Determine file handling in responses
    H2Direct on|off on for h2c, off for +svE
    H2 Direct Protocol Switch
    H2EarlyHints on|off off svE
    Determine sending of 103 status codes
    H2MaxSessionStreams n 100 svE
    Maximum number of active streams per HTTP/2 session.
    H2MaxWorkerIdleSeconds n 600 sE
    Maximum number of seconds h2 workers remain idle until shut down.
    H2MaxWorkers nsE
    Maximum number of worker threads to use per child process.
    H2MinWorkers nsE
    Minimal number of worker threads to use per child process.
    H2ModernTLSOnly on|off on svE
    Require HTTP/2 connections to be "modern TLS" only
    H2Push on|off on svE
    H2 Server Push Switch
    H2PushDiarySize n 256 svE
    H2 Server Push Diary Size
    H2PushPriority mime-type [after|before|interleaved] [weight] * After 16 svE
    H2 Server Push Priority
    H2PushResource [add] path [critical]svdhE
    Declares resources for early pushing to the client
    H2SerializeHeaders on|off off svE
    Serialize Request/Response Processing Switch
    H2StreamMaxMemSize bytes 65536 svE
    Maximum amount of output data buffered per stream.
    H2TLSCoolDownSecs seconds 1 svE
    -
    H2TLSWarmUpSize amount 1048576 svE
    -
    SSLInsecureRenegotiation on|off off svE
    Option to enable support for insecure renegotiation
    SSLOCSDefaultResponder urisvE
    Set the default responder URI for OCSP validation
    SSLOCSPEnable on|off off svE
    Enable OCSP validation of the client certificate chain
    SSLOCSPOverrideResponder on|off off svE
    Force use of the default responder URI for OCSP validation
    SSLOCSPProxyURL urlsvE
    Proxy URL to use for OCSP requests
    SSLOCSPNoverify On/Off Off svE
    skip the OCSP responder certificates verification
    SSLOCSPOverrideResponder on|off off svE
    Force use of the default responder URI for OCSP validation
    SSLOCSPProxyURL urlsvE
    Proxy URL to use for OCSP requests
    SSLOCSPResponderCertificateFile filesvE
    Set of trusted PEM encoded OCSP responder certificates
    SSLOCSPResponderTimeout seconds 10 svE
    Timeout for OCSP queries
    SSLOCSPResponseMaxAge seconds -1 svE
    Maximum allowable age for OCSP responses
    SSLOCSPResponseTimeSkew seconds 300 svE
    Maximum allowable time skew for OCSP response validation
    BalancerInherit On|Off On svE
    Inherit ProxyPassed Balancers/Workers from the main server
    BalancerMember [balancerurl] url [key=value [key=value ...]]dE
    Add a member to a load balancing group
    BalancerPersist On|Off Off svE
    Attempt to persist changes made by the Balancer Manager across restarts.
    BrowserMatch regex [!]env-variable[=value] -[[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on HTTP User-Agent +
    BrotliAlterETag AddSuffix|NoChange|Remove AddSuffix svE
    How the outgoing ETag header should be modified during compression
    BrotliCompressionMaxInputBlock valuesvE
    Maximum input block size
    BrotliCompressionQuality value 5 svE
    Compression quality
    BrotliCompressionWindow value 18 svE
    Brotli sliding compression window size
    BrotliFilterNote [type] notenamesvE
    Places the compression ratio in a note for logging
    BrowserMatch regex [!]env-variable[=value] +[[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on HTTP User-Agent
    BrowserMatchNoCase regex [!]env-variable[=value] - [[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on User-Agent without +
    BrowserMatchNoCase regex [!]env-variable[=value] + [[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on User-Agent without respect to case
    BufferedLogs On|Off Off sB
    Buffer log entries in memory before writing to disk
    BufferSize integer 131072 svdhE
    Maximum size in bytes to buffer by the buffer filter
    CacheDefaultExpire seconds 3600 (one hour) svdhE
    The default duration to cache a document when no expiry date is specified.
    CacheDetailHeader on|off off svdhE
    Add an X-Cache-Detail header to the response.
    CacheDirLength length 2 svE
    The number of characters in subdirectory names
    CacheDirLevels levels 2 svE
    The number of levels of subdirectories in the +
    BufferedLogs On|Off Off sB
    Buffer log entries in memory before writing to disk
    BufferSize integer 131072 svdhE
    Maximum size in bytes to buffer by the buffer filter
    CacheDefaultExpire seconds 3600 (one hour) svdhE
    The default duration to cache a document when no expiry date is specified.
    CacheDetailHeader on|off off svdhE
    Add an X-Cache-Detail header to the response.
    CacheDirLength length 2 svE
    The number of characters in subdirectory names
    CacheDirLevels levels 2 svE
    The number of levels of subdirectories in the cache.
    CacheDisable url-string | onsvdhE
    Disable caching of specified URLs
    CacheEnable cache_type [url-string]svdE
    Enable caching of specified URLs using a specified storage +
    CacheDisable url-string | onsvdhE
    Disable caching of specified URLs
    CacheEnable cache_type [url-string]svdE
    Enable caching of specified URLs using a specified storage manager
    CacheFile file-path [file-path] ...sX
    Cache a list of file handles at startup time
    CacheHeader on|off off svdhE
    Add an X-Cache header to the response.
    CacheIgnoreCacheControl On|Off Off svE
    Ignore request to not serve cached content to client
    CacheIgnoreHeaders header-string [header-string] ... None svE
    Do not store the given HTTP header(s) in the cache. +
    CacheFile file-path [file-path] ...sX
    Cache a list of file handles at startup time
    CacheHeader on|off off svdhE
    Add an X-Cache header to the response.
    CacheIgnoreCacheControl On|Off Off svE
    Ignore request to not serve cached content to client
    CacheIgnoreHeaders header-string [header-string] ... None svE
    Do not store the given HTTP header(s) in the cache.
    CacheIgnoreNoLastMod On|Off Off svdhE
    Ignore the fact that a response has no Last Modified +
    CacheIgnoreNoLastMod On|Off Off svdhE
    Ignore the fact that a response has no Last Modified header.
    CacheIgnoreQueryString On|Off Off svE
    Ignore query string when caching
    CacheIgnoreURLSessionIdentifiers identifier [identifier] ... None svE
    Ignore defined session identifiers encoded in the URL when caching +
    CacheIgnoreQueryString On|Off Off svE
    Ignore query string when caching
    CacheIgnoreURLSessionIdentifiers identifier [identifier] ... None svE
    Ignore defined session identifiers encoded in the URL when caching
    CacheKeyBaseURL URL http://example.com svE
    Override the base URL of reverse proxied cache keys.
    CacheLastModifiedFactor float 0.1 svdhE
    The factor used to compute an expiry date based on the +
    CacheKeyBaseURL URL http://example.com svE
    Override the base URL of reverse proxied cache keys.
    CacheLastModifiedFactor float 0.1 svdhE
    The factor used to compute an expiry date based on the LastModified date.
    CacheLock on|off off svE
    Enable the thundering herd lock.
    CacheLockMaxAge integer 5 svE
    Set the maximum possible age of a cache lock.
    CacheLockPath directory /tmp/mod_cache-lock +svE
    Set the lock path directory.
    CacheMaxExpire seconds 86400 (one day) svdhE
    The maximum time in seconds to cache a document
    CacheMaxFileSize bytes 1000000 svdhE
    The maximum size (in bytes) of a document to be placed in the +
    CacheLock on|off off svE
    Enable the thundering herd lock.
    CacheLockMaxAge integer 5 svE
    Set the maximum possible age of a cache lock.
    CacheLockPath directory /tmp/mod_cache-lock +svE
    Set the lock path directory.
    CacheMaxExpire seconds 86400 (one day) svdhE
    The maximum time in seconds to cache a document
    CacheMaxFileSize bytes 1000000 svdhE
    The maximum size (in bytes) of a document to be placed in the cache
    CacheMinExpire seconds 0 svdhE
    The minimum time in seconds to cache a document
    CacheMinFileSize bytes 1 svdhE
    The minimum size (in bytes) of a document to be placed in the +
    CacheMinExpire seconds 0 svdhE
    The minimum time in seconds to cache a document
    CacheMinFileSize bytes 1 svdhE
    The minimum size (in bytes) of a document to be placed in the cache
    CacheNegotiatedDocs On|Off Off svB
    Allows content-negotiated documents to be +
    CacheNegotiatedDocs On|Off Off svB
    Allows content-negotiated documents to be cached by proxy servers
    CacheQuickHandler on|off on svE
    Run the cache from the quick handler.
    CacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached +
    CacheQuickHandler on|off on svE
    Run the cache from the quick handler.
    CacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached before sending the data downstream
    CacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading +
    CacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading before data is sent downstream
    CacheRoot directorysvE
    The directory root under which cache files are +
    CacheRoot directorysvE
    The directory root under which cache files are stored
    CacheSocache type[:args]svE
    The shared object cache implementation to use
    CacheSocacheMaxSize bytes 102400 svdhE
    The maximum size (in bytes) of an entry to be placed in the +
    CacheSocache type[:args]svE
    The shared object cache implementation to use
    CacheSocacheMaxSize bytes 102400 svdhE
    The maximum size (in bytes) of an entry to be placed in the cache
    CacheSocacheMaxTime seconds 86400 svdhE
    The maximum time (in seconds) for a document to be placed in the +
    CacheSocacheMaxTime seconds 86400 svdhE
    The maximum time (in seconds) for a document to be placed in the cache
    CacheSocacheMinTime seconds 600 svdhE
    The minimum time (in seconds) for a document to be placed in the +
    CacheSocacheMinTime seconds 600 svdhE
    The minimum time (in seconds) for a document to be placed in the cache
    CacheSocacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached +
    CacheSocacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached before sending the data downstream
    CacheSocacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading +
    CacheSocacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading before data is sent downstream
    CacheStaleOnError on|off on svdhE
    Serve stale content in place of 5xx responses.
    CacheStoreExpired On|Off Off svdhE
    Attempt to cache responses that the server reports as expired
    CacheStoreNoStore On|Off Off svdhE
    Attempt to cache requests or responses that have been marked as no-store.
    CacheStorePrivate On|Off Off svdhE
    Attempt to cache responses that the server has marked as private
    CGIDScriptTimeout time[s|ms]svdhB
    The length of time to wait for more output from the +
    CacheStaleOnError on|off on svdhE
    Serve stale content in place of 5xx responses.
    CacheStoreExpired On|Off Off svdhE
    Attempt to cache responses that the server reports as expired
    CacheStoreNoStore On|Off Off svdhE
    Attempt to cache requests or responses that have been marked as no-store.
    CacheStorePrivate On|Off Off svdhE
    Attempt to cache responses that the server has marked as private
    CGIDScriptTimeout time[s|ms]svdhB
    The length of time to wait for more output from the CGI program
    CGIMapExtension cgi-path .extensiondhC
    Technique for locating the interpreter for CGI +
    CGIMapExtension cgi-path .extensiondhC
    Technique for locating the interpreter for CGI scripts
    CGIPassAuth On|Off Off dhC
    Enables passing HTTP authorization headers to scripts as CGI +
    CGIPassAuth On|Off Off dhC
    Enables passing HTTP authorization headers to scripts as CGI variables
    CGIVar variable ruledhC
    Controls how some CGI variables are set
    CharsetDefault charsetsvdhE
    Charset to translate into
    CharsetOptions option [option] ... ImplicitAdd svdhE
    Configures charset translation behavior
    CharsetSourceEnc charsetsvdhE
    Source charset of files
    CheckCaseOnly on|off Off svdhE
    Limits the action of the speling module to case corrections
    CheckSpelling on|off Off svdhE
    Enables the spelling +
    CGIVar variable ruledhC
    Controls how some CGI variables are set
    CharsetDefault charsetsvdhE
    Charset to translate into
    CharsetOptions option [option] ... ImplicitAdd svdhE
    Configures charset translation behavior
    CharsetSourceEnc charsetsvdhE
    Source charset of files
    CheckCaseOnly on|off Off svdhE
    Limits the action of the speling module to case corrections
    CheckSpelling on|off Off svdhE
    Enables the spelling module
    ChrootDir /path/to/directorysB
    Directory for apache to run chroot(8) after startup.
    ContentDigest On|Off Off svdhC
    Enables the generation of Content-MD5 HTTP Response +
    ChrootDir /path/to/directorysB
    Directory for apache to run chroot(8) after startup.
    ContentDigest On|Off Off svdhC
    Enables the generation of Content-MD5 HTTP Response headers
    CookieDomain domainsvdhE
    The domain to which the tracking cookie applies
    CookieExpires expiry-periodsvdhE
    Expiry time for the tracking cookie
    CookieName token Apache svdhE
    Name of the tracking cookie
    CookieStyle - Netscape|Cookie|Cookie2|RFC2109|RFC2965 Netscape svdhE
    Format of the cookie header field
    CookieTracking on|off off svdhE
    Enables tracking cookie
    CoreDumpDirectory directorysM
    Directory where Apache HTTP Server attempts to +
    CookieDomain domainsvdhE
    The domain to which the tracking cookie applies
    CookieExpires expiry-periodsvdhE
    Expiry time for the tracking cookie
    CookieName token Apache svdhE
    Name of the tracking cookie
    CookieStyle + Netscape|Cookie|Cookie2|RFC2109|RFC2965 Netscape svdhE
    Format of the cookie header field
    CookieTracking on|off off svdhE
    Enables tracking cookie
    CoreDumpDirectory directorysM
    Directory where Apache HTTP Server attempts to switch before dumping core
    CustomLog file|pipe +
    CustomLog file|pipe format|nickname [env=[!]environment-variable| -expr=expression]svB
    Sets filename and format of log file
    Dav On|Off|provider-name Off dE
    Enable WebDAV HTTP methods
    DavDepthInfinity on|off off svdE
    Allow PROPFIND, Depth: Infinity requests
    DavGenericLockDB file-pathsvdE
    Location of the DAV lock database
    DavLockDB file-pathsvE
    Location of the DAV lock database
    DavMinTimeout seconds 0 svdE
    Minimum amount of time the server holds a lock on +expr=expression]svB
    Sets filename and format of log file
    Dav On|Off|provider-name Off dE
    Enable WebDAV HTTP methods
    DavDepthInfinity on|off off svdE
    Allow PROPFIND, Depth: Infinity requests
    DavGenericLockDB file-pathsvdE
    Location of the DAV lock database
    DavLockDB file-pathsvE
    Location of the DAV lock database
    DavMinTimeout seconds 0 svdE
    Minimum amount of time the server holds a lock on a DAV resource
    DBDExptime time-in-seconds 300 svE
    Keepalive time for idle connections
    DBDInitSQL "SQL statement"svE
    Execute an SQL statement after connecting to a database
    DBDKeep number 2 svE
    Maximum sustained number of connections
    DBDMax number 10 svE
    Maximum number of connections
    DBDMin number 1 svE
    Minimum number of connections
    DBDParams -param1=value1[,param2=value2]svE
    Parameters for database connection
    DBDPersist On|OffsvE
    Whether to use persistent connections
    DBDPrepareSQL "SQL statement" labelsvE
    Define an SQL prepared statement
    DBDriver namesvE
    Specify an SQL driver
    DefaultIcon url-pathsvdhB
    Icon to display for files when no specific icon is +
    DBDExptime time-in-seconds 300 svE
    Keepalive time for idle connections
    DBDInitSQL "SQL statement"svE
    Execute an SQL statement after connecting to a database
    DBDKeep number 2 svE
    Maximum sustained number of connections
    DBDMax number 10 svE
    Maximum number of connections
    DBDMin number 1 svE
    Minimum number of connections
    DBDParams +param1=value1[,param2=value2]svE
    Parameters for database connection
    DBDPersist On|OffsvE
    Whether to use persistent connections
    DBDPrepareSQL "SQL statement" labelsvE
    Define an SQL prepared statement
    DBDriver namesvE
    Specify an SQL driver
    DefaultIcon url-pathsvdhB
    Icon to display for files when no specific icon is configured
    DefaultLanguage language-tagsvdhB
    Defines a default language-tag to be sent in the Content-Language +
    DefaultLanguage language-tagsvdhB
    Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means.
    DefaultRuntimeDir directory-path DEFAULT_REL_RUNTIME +sC
    Base directory for the server run-time files
    DefaultType media-type|none none svdhC
    This directive has no effect other than to emit warnings +
    DefaultRuntimeDir directory-path DEFAULT_REL_RUNTIME +sC
    Base directory for the server run-time files
    DefaultType media-type|none none svdhC
    This directive has no effect other than to emit warnings if the value is not none. In prior versions, DefaultType would specify a default media type to assign to response content for which no other media type configuration could be found.
    Define parameter-name [parameter-value]svdC
    Define a variable
    DeflateBufferSize value 8096 svE
    Fragment size to be compressed at one time by zlib
    DeflateCompressionLevel valuesvE
    How much compression do we apply to the output
    DeflateFilterNote [type] notenamesvE
    Places the compression ratio in a note for logging
    DeflateInflateLimitRequestBodyvaluesvdhE
    Maximum size of inflated request bodies
    DeflateInflateRatioBurst valuesvdhE
    Maximum number of times the inflation ratio for request bodies +
    Define parameter-name [parameter-value]svdC
    Define a variable
    DeflateBufferSize value 8096 svE
    Fragment size to be compressed at one time by zlib
    DeflateCompressionLevel valuesvE
    How much compression do we apply to the output
    DeflateFilterNote [type] notenamesvE
    Places the compression ratio in a note for logging
    DeflateInflateLimitRequestBodyvaluesvdhE
    Maximum size of inflated request bodies
    DeflateInflateRatioBurst valuesvdhE
    Maximum number of times the inflation ratio for request bodies can be crossed
    DeflateInflateRatioLimit valuesvdhE
    Maximum inflation ratio for request bodies
    DeflateMemLevel value 9 svE
    How much memory should be used by zlib for compression
    DeflateWindowSize value 15 svE
    Zlib compression window size
    Deny from all|host|env=[!]env-variable -[host|env=[!]env-variable] ...dhE
    Controls which hosts are denied access to the +
    DeflateInflateRatioLimit valuesvdhE
    Maximum inflation ratio for request bodies
    DeflateMemLevel value 9 svE
    How much memory should be used by zlib for compression
    DeflateWindowSize value 15 svE
    Zlib compression window size
    Deny from all|host|env=[!]env-variable +[host|env=[!]env-variable] ...dhE
    Controls which hosts are denied access to the server
    <Directory directory-path> -... </Directory>svC
    Enclose a group of directives that apply only to the +
    <Directory directory-path> +... </Directory>svC
    Enclose a group of directives that apply only to the named file-system directory, sub-directories, and their contents.
    DirectoryCheckHandler On|Off Off svdhB
    Toggle how this module responds when another handler is configured
    DirectoryIndex - disabled | local-url [local-url] ... index.html svdhB
    List of resources to look for when the client requests +
    DirectoryCheckHandler On|Off Off svdhB
    Toggle how this module responds when another handler is configured
    DirectoryIndex + disabled | local-url [local-url] ... index.html svdhB
    List of resources to look for when the client requests a directory
    DirectoryIndexRedirect on | off | permanent | temp | seeother | +
    DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code - off svdhB
    Configures an external redirect for directory indexes. + off svdhB
    Configures an external redirect for directory indexes.
    <DirectoryMatch regex> -... </DirectoryMatch>svC
    Enclose directives that apply to +
    <DirectoryMatch regex> +... </DirectoryMatch>svC
    Enclose directives that apply to the contents of file-system directories matching a regular expression.
    DirectorySlash On|Off On svdhB
    Toggle trailing slash redirects on or off
    DocumentRoot directory-path "/usr/local/apache/ +svC
    Directory that forms the main document tree visible +
    DirectorySlash On|Off On svdhB
    Toggle trailing slash redirects on or off
    DocumentRoot directory-path "/usr/local/apache/ +svC
    Directory that forms the main document tree visible from the web
    DTracePrivileges On|Off Off sX
    Determines whether the privileges required by dtrace are enabled.
    DumpIOInput On|Off Off sE
    Dump all input data to the error log
    DumpIOOutput On|Off Off sE
    Dump all output data to the error log
    <Else> ... </Else>svdhC
    Contains directives that apply only if the condition of a +
    DTracePrivileges On|Off Off sX
    Determines whether the privileges required by dtrace are enabled.
    DumpIOInput On|Off Off sE
    Dump all input data to the error log
    DumpIOOutput On|Off Off sE
    Dump all output data to the error log
    <Else> ... </Else>svdhC
    Contains directives that apply only if the condition of a previous <If> or <ElseIf> section is not satisfied by a request at runtime
    <ElseIf expression> ... </ElseIf>svdhC
    Contains directives that apply only if a condition is satisfied +
    <ElseIf expression> ... </ElseIf>svdhC
    Contains directives that apply only if a condition is satisfied by a request at runtime while the condition of a previous <If> or <ElseIf> section is not satisfied
    EnableExceptionHook On|Off Off sM
    Enables a hook that runs exception handlers +
    EnableExceptionHook On|Off Off sM
    Enables a hook that runs exception handlers after a crash
    EnableMMAP On|Off On svdhC
    Use memory-mapping to read files during delivery
    EnableSendfile On|Off Off svdhC
    Use the kernel sendfile support to deliver files to the client
    Error messagesvdhC
    Abort configuration parsing with a custom error message
    ErrorDocument error-code documentsvdhC
    What the server will return to the client +
    EnableMMAP On|Off On svdhC
    Use memory-mapping to read files during delivery
    EnableSendfile On|Off Off svdhC
    Use the kernel sendfile support to deliver files to the client
    Error messagesvdhC
    Abort configuration parsing with a custom error message
    ErrorDocument error-code documentsvdhC
    What the server will return to the client in case of an error
    ErrorLog file-path|syslog[:facility] logs/error_log (Uni +svC
    Location where the server will log errors
    ErrorLogFormat [connection|request] formatsvC
    Format specification for error log entries
    ExamplesvdhX
    Demonstration directive to illustrate the Apache module +
    ErrorLog file-path|syslog[:facility] logs/error_log (Uni +svC
    Location where the server will log errors
    ErrorLogFormat [connection|request] formatsvC
    Format specification for error log entries
    ExamplesvdhX
    Demonstration directive to illustrate the Apache module API
    ExpiresActive On|Off Off svdhE
    Enables generation of Expires +
    ExpiresActive On|Off Off svdhE
    Enables generation of Expires headers
    ExpiresByType MIME-type -<code>secondssvdhE
    Value of the Expires header configured +
    ExpiresByType MIME-type +<code>secondssvdhE
    Value of the Expires header configured by MIME type
    ExpiresDefault <code>secondssvdhE
    Default algorithm for calculating expiration time
    ExtendedStatus On|Off Off[*] sC
    Keep track of extended status information for each +
    ExpiresDefault <code>secondssvdhE
    Default algorithm for calculating expiration time
    ExtendedStatus On|Off Off[*] sC
    Keep track of extended status information for each request
    ExtFilterDefine filtername parameterssE
    Define an external filter
    ExtFilterOptions option [option] ... NoLogStderr dE
    Configure mod_ext_filter options
    FallbackResource disabled | local-urlsvdhB
    Define a default URL for requests that don't map to a file
    FileETag component ... MTime Size svdhC
    File attributes used to create the ETag +
    ExtFilterDefine filtername parameterssE
    Define an external filter
    ExtFilterOptions option [option] ... NoLogStderr dE
    Configure mod_ext_filter options
    FallbackResource disabled | local-urlsvdhB
    Define a default URL for requests that don't map to a file
    FileETag component ... MTime Size svdhC
    File attributes used to create the ETag HTTP response header for static files
    <Files filename> ... </Files>svdhC
    Contains directives that apply to matched +
    <Files filename> ... </Files>svdhC
    Contains directives that apply to matched filenames
    <FilesMatch regex> ... </FilesMatch>svdhC
    Contains directives that apply to regular-expression matched +
    <FilesMatch regex> ... </FilesMatch>svdhC
    Contains directives that apply to regular-expression matched filenames
    FilterChain [+=-@!]filter-name ...svdhB
    Configure the filter chain
    FilterDeclare filter-name [type]svdhB
    Declare a smart filter
    FilterProtocol filter-name [provider-name] - proto-flagssvdhB
    Deal with correct HTTP protocol handling
    FilterProvider filter-name provider-name - expressionsvdhB
    Register a content filter
    FilterTrace filter-name levelsvdB
    Get debug/diagnostic information from +
    FilterChain [+=-@!]filter-name ...svdhB
    Configure the filter chain
    FilterDeclare filter-name [type]svdhB
    Declare a smart filter
    FilterProtocol filter-name [provider-name] + proto-flagssvdhB
    Deal with correct HTTP protocol handling
    FilterProvider filter-name provider-name + expressionsvdhB
    Register a content filter
    FilterTrace filter-name levelsvdB
    Get debug/diagnostic information from mod_filter
    ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] Prefer svdhB
    Action to take if a single acceptable document is not +
    ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] Prefer svdhB
    Action to take if a single acceptable document is not found
    ForceType media-type|NonedhC
    Forces all matching files to be served with the specified +
    ForceType media-type|NonedhC
    Forces all matching files to be served with the specified media type in the HTTP Content-Type header field
    ForensicLog filename|pipesvE
    Sets filename of the forensic log
    GlobalLogfile|pipe +
    ForensicLog filename|pipesvE
    Sets filename of the forensic log
    GlobalLogfile|pipe format|nickname [env=[!]environment-variable| -expr=expression]sB
    Sets filename and format of log file
    GprofDir /tmp/gprof/|/tmp/gprof/%svC
    Directory to write gmon.out profiling data to.
    GracefulShutdownTimeout seconds 0 sM
    Specify a timeout after which a gracefully shutdown server +expr=expression]sB
    Sets filename and format of log file
    GprofDir /tmp/gprof/|/tmp/gprof/%svC
    Directory to write gmon.out profiling data to.
    GracefulShutdownTimeout seconds 0 sM
    Specify a timeout after which a gracefully shutdown server will exit.
    Group unix-group #-1 sB
    Group under which the server will answer +
    Group unix-group #-1 sB
    Group under which the server will answer requests
    H2CopyFiles on|off off svdhE
    Determine file handling in responses
    H2Direct on|off on for h2c, off for +svE
    H2 Direct Protocol Switch
    H2EarlyHints on|off off svE
    Determine sending of 103 status codes
    H2MaxSessionStreams n 100 svE
    Maximum number of active streams per HTTP/2 session.
    H2MaxWorkerIdleSeconds n 600 sE
    Maximum number of seconds h2 workers remain idle until shut down.
    H2MaxWorkers nsE
    Maximum number of worker threads to use per child process.
    H2MinWorkers nsE
    Minimal number of worker threads to use per child process.
    H2ModernTLSOnly on|off on svE
    Require HTTP/2 connections to be "modern TLS" only
    H2Push on|off on svE
    H2 Server Push Switch
    H2PushDiarySize n 256 svE
    H2 Server Push Diary Size
    H2PushPriority mime-type [after|before|interleaved] [weight] * After 16 svE
    H2 Server Push Priority
    H2PushResource [add] path [critical]svdhE
    Declares resources for early pushing to the client
    H2SerializeHeaders on|off off svE
    Serialize Request/Response Processing Switch
    H2SessionExtraFiles nsvE
    Number of Extra File Handles
    H2CopyFiles on|off off svdhE
    Determine file handling in responses
    H2Direct on|off on for h2c, off for +svE
    H2 Direct Protocol Switch
    H2EarlyHints on|off off svE
    Determine sending of 103 status codes
    H2MaxSessionStreams n 100 svE
    Maximum number of active streams per HTTP/2 session.
    H2MaxWorkerIdleSeconds n 600 sE
    Maximum number of seconds h2 workers remain idle until shut down.
    H2MaxWorkers nsE
    Maximum number of worker threads to use per child process.
    H2MinWorkers nsE
    Minimal number of worker threads to use per child process.
    H2ModernTLSOnly on|off on svE
    Require HTTP/2 connections to be "modern TLS" only
    H2Push on|off on svE
    H2 Server Push Switch
    H2PushDiarySize n 256 svE
    H2 Server Push Diary Size
    H2PushPriority mime-type [after|before|interleaved] [weight] * After 16 svE
    H2 Server Push Priority
    H2PushResource [add] path [critical]svdhE
    Declares resources for early pushing to the client
    H2SerializeHeaders on|off off svE
    Serialize Request/Response Processing Switch
    H2StreamMaxMemSize bytes 65536 svE
    Maximum amount of output data buffered per stream.
    H2TLSCoolDownSecs seconds 1 svE
    -
    H2TLSWarmUpSize amount 1048576 svE
    -
    SSLInsecureRenegotiation on|off off svE
    Option to enable support for insecure renegotiation
    SSLOCSDefaultResponder urisvE
    Set the default responder URI for OCSP validation
    SSLOCSPEnable on|off off svE
    Enable OCSP validation of the client certificate chain
    SSLOCSPOverrideResponder on|off off svE
    Force use of the default responder URI for OCSP validation
    SSLOCSPProxyURL urlsvE
    Proxy URL to use for OCSP requests
    SSLOCSPNoverify On/Off Off svE
    skip the OCSP responder certificates verification
    SSLOCSPOverrideResponder on|off off svE
    Force use of the default responder URI for OCSP validation
    SSLOCSPProxyURL urlsvE
    Proxy URL to use for OCSP requests
    SSLOCSPResponderCertificateFile filesvE
    Set of trusted PEM encoded OCSP responder certificates
    SSLOCSPResponderTimeout seconds 10 svE
    Timeout for OCSP queries
    SSLOCSPResponseMaxAge seconds -1 svE
    Maximum allowable age for OCSP responses
    SSLOCSPResponseTimeSkew seconds 300 svE
    Maximum allowable time skew for OCSP response validation
    @@ -61,15 +61,15 @@
     A  |  B  |  C  |  D  |  E  |  F  |  G  |  H  |  I  |  K  |  L  |  M  |  N  |  O  |  P  |  Q  |  R  |  S  |  T  |  U  |  V  |  W  |  X  - +
    CCore
    MMPM
    BBase
    EExtensión
    EExtensión
    XExperimental
    TExterno
    - - + + - + + + + + - - - - - - - + + + + + - - + - - - - + + + - - - + - - + - - - - - + + + + - - + - - - + - - - - + - - - - - - - - - + + + + - - - - - - - - + + + + + - - + - - - - - - + + + + + - - - - - - + + + + + - - - - - - - - - - + + + + + + + + + - - - + - - - - - - + + + + + - - - - + + + - - - + - - - - + - - - - + + + - - - - - - + + + - - - + + - - - - + - - - - + + + - - - - - - - + + + + - - - - + - - + + - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + - + - - - + + - - - - - + + + + - - + - - - - - + + - - - - - + - - - - - - + + + - - - - + + - - - + - - - - - - - - + + + + + - - - - - - - - - + + + + + + + - - - - + + - - - - - - - - + - - + - - + - - - - - + + - + - - - - - - + + + + - - + - - - - - - - - - - - - - + + + + + + + + + + + + - + - - - - - - - - - - - - + + + + + - - + - - - + - - - + + - - - - - - - + + - - - - + + - - - - - - - - + + + + + + - - - - - - - - + + + + + + - - - - - - - + + + + + + + - - - - - + + + + - - + - - + - - - - + + + - - - - - - + + + + - - - - - - + - - + - - - - - - + + + + - - - - + - - - - - - - - - - - - + + + + + + + + - - - - - - - - + - - - - - - + - - - - - + + + + - - - - - - - - - - + - - + - - + - - + - - - + - - - - + + - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + - - - - - - + + + + + - - + - - - - - + - - + - - - + + - - + - - - - - + - - - - - + + + - - - - - - - - + + + + + + + + + - - - - - - - + + + + + + + - - + - - - + - - - - - - - - - - - - + + + + + + - - - + - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + - - - - + + + - - - - - - - - + + + + + + + - - + - - - - - - - - - + + + + + + + - - - - + - - - - + + - - + - - - - - - + - - + - +
    AcceptFilter protocol accept_filtersC
    Configura mejoras para un Protocolo de Escucha de Sockets
    AcceptPathInfo On|Off|Default Default svdhC
    Los recursos aceptan información sobre su ruta
    AccessFileName filename [filename] ... .htaccess svC
    Nombre del fichero distribuido de configuración
    AcceptPathInfo On|Off|Default Default svdhC
    Los recursos aceptan información sobre su ruta
    AccessFileName filename [filename] ... .htaccess svC
    Nombre del fichero distribuido de configuración
    Action action-type cgi-script [virtual]svdhB
    Activates a CGI script for a particular handler or content-type
    AddAlt string file [file] ...svdhB
    Alternate text to display for a file, instead of an @@ -266,862 +266,869 @@ authentication succeeds but authorization fails
    BalancerInherit On|Off On svE
    Inherit ProxyPassed Balancers/Workers from the main server
    BalancerMember [balancerurl] url [key=value [key=value ...]]dE
    Add a member to a load balancing group
    BalancerPersist On|Off Off svE
    Attempt to persist changes made by the Balancer Manager across restarts.
    BrowserMatch regex [!]env-variable[=value] -[[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on HTTP User-Agent +
    BrotliAlterETag AddSuffix|NoChange|Remove AddSuffix svE
    How the outgoing ETag header should be modified during compression
    BrotliCompressionMaxInputBlock valuesvE
    Maximum input block size
    BrotliCompressionQuality value 5 svE
    Compression quality
    BrotliCompressionWindow value 18 svE
    Brotli sliding compression window size
    BrotliFilterNote [type] notenamesvE
    Places the compression ratio in a note for logging
    BrowserMatch regex [!]env-variable[=value] +[[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on HTTP User-Agent
    BrowserMatchNoCase regex [!]env-variable[=value] - [[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on User-Agent without +
    BrowserMatchNoCase regex [!]env-variable[=value] + [[!]env-variable[=value]] ...svdhB
    Sets environment variables conditional on User-Agent without respect to case
    BufferedLogs On|Off Off sB
    Buffer log entries in memory before writing to disk
    BufferSize integer 131072 svdhE
    Maximum size in bytes to buffer by the buffer filter
    CacheDefaultExpire seconds 3600 (one hour) svdhE
    The default duration to cache a document when no expiry date is specified.
    CacheDetailHeader on|off off svdhE
    Add an X-Cache-Detail header to the response.
    CacheDirLength length 2 svE
    The number of characters in subdirectory names
    CacheDirLevels levels 2 svE
    The number of levels of subdirectories in the +
    BufferedLogs On|Off Off sB
    Buffer log entries in memory before writing to disk
    BufferSize integer 131072 svdhE
    Maximum size in bytes to buffer by the buffer filter
    CacheDefaultExpire seconds 3600 (one hour) svdhE
    The default duration to cache a document when no expiry date is specified.
    CacheDetailHeader on|off off svdhE
    Add an X-Cache-Detail header to the response.
    CacheDirLength length 2 svE
    The number of characters in subdirectory names
    CacheDirLevels levels 2 svE
    The number of levels of subdirectories in the cache.
    CacheDisable url-string | onsvdhE
    Disable caching of specified URLs
    CacheEnable cache_type [url-string]svdE
    Enable caching of specified URLs using a specified storage +
    CacheDisable url-string | onsvdhE
    Disable caching of specified URLs
    CacheEnable cache_type [url-string]svdE
    Enable caching of specified URLs using a specified storage manager
    CacheFile file-path [file-path] ...sX
    Cache a list of file handles at startup time
    CacheHeader on|off off svdhE
    Add an X-Cache header to the response.
    CacheIgnoreCacheControl On|Off Off svE
    Ignore request to not serve cached content to client
    CacheIgnoreHeaders header-string [header-string] ... None svE
    Do not store the given HTTP header(s) in the cache. +
    CacheFile file-path [file-path] ...sX
    Cache a list of file handles at startup time
    CacheHeader on|off off svdhE
    Add an X-Cache header to the response.
    CacheIgnoreCacheControl On|Off Off svE
    Ignore request to not serve cached content to client
    CacheIgnoreHeaders header-string [header-string] ... None svE
    Do not store the given HTTP header(s) in the cache.
    CacheIgnoreNoLastMod On|Off Off svdhE
    Ignore the fact that a response has no Last Modified +
    CacheIgnoreNoLastMod On|Off Off svdhE
    Ignore the fact that a response has no Last Modified header.
    CacheIgnoreQueryString On|Off Off svE
    Ignore query string when caching
    CacheIgnoreURLSessionIdentifiers identifier [identifier] ... None svE
    Ignore defined session identifiers encoded in the URL when caching +
    CacheIgnoreQueryString On|Off Off svE
    Ignore query string when caching
    CacheIgnoreURLSessionIdentifiers identifier [identifier] ... None svE
    Ignore defined session identifiers encoded in the URL when caching
    CacheKeyBaseURL URL http://example.com svE
    Override the base URL of reverse proxied cache keys.
    CacheLastModifiedFactor float 0.1 svdhE
    The factor used to compute an expiry date based on the +
    CacheKeyBaseURL URL http://example.com svE
    Override the base URL of reverse proxied cache keys.
    CacheLastModifiedFactor float 0.1 svdhE
    The factor used to compute an expiry date based on the LastModified date.
    CacheLock on|off off svE
    Enable the thundering herd lock.
    CacheLockMaxAge integer 5 svE
    Set the maximum possible age of a cache lock.
    CacheLockPath directory /tmp/mod_cache-lock +svE
    Set the lock path directory.
    CacheMaxExpire seconds 86400 (one day) svdhE
    The maximum time in seconds to cache a document
    CacheMaxFileSize bytes 1000000 svdhE
    The maximum size (in bytes) of a document to be placed in the +
    CacheLock on|off off svE
    Enable the thundering herd lock.
    CacheLockMaxAge integer 5 svE
    Set the maximum possible age of a cache lock.
    CacheLockPath directory /tmp/mod_cache-lock +svE
    Set the lock path directory.
    CacheMaxExpire seconds 86400 (one day) svdhE
    The maximum time in seconds to cache a document
    CacheMaxFileSize bytes 1000000 svdhE
    The maximum size (in bytes) of a document to be placed in the cache
    CacheMinExpire seconds 0 svdhE
    The minimum time in seconds to cache a document
    CacheMinFileSize bytes 1 svdhE
    The minimum size (in bytes) of a document to be placed in the +
    CacheMinExpire seconds 0 svdhE
    The minimum time in seconds to cache a document
    CacheMinFileSize bytes 1 svdhE
    The minimum size (in bytes) of a document to be placed in the cache
    CacheNegotiatedDocs On|Off Off svB
    Allows content-negotiated documents to be +
    CacheNegotiatedDocs On|Off Off svB
    Allows content-negotiated documents to be cached by proxy servers
    CacheQuickHandler on|off on svE
    Run the cache from the quick handler.
    CacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached +
    CacheQuickHandler on|off on svE
    Run the cache from the quick handler.
    CacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached before sending the data downstream
    CacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading +
    CacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading before data is sent downstream
    CacheRoot directorysvE
    The directory root under which cache files are +
    CacheRoot directorysvE
    The directory root under which cache files are stored
    CacheSocache type[:args]svE
    The shared object cache implementation to use
    CacheSocacheMaxSize bytes 102400 svdhE
    The maximum size (in bytes) of an entry to be placed in the +
    CacheSocache type[:args]svE
    The shared object cache implementation to use
    CacheSocacheMaxSize bytes 102400 svdhE
    The maximum size (in bytes) of an entry to be placed in the cache
    CacheSocacheMaxTime seconds 86400 svdhE
    The maximum time (in seconds) for a document to be placed in the +
    CacheSocacheMaxTime seconds 86400 svdhE
    The maximum time (in seconds) for a document to be placed in the cache
    CacheSocacheMinTime seconds 600 svdhE
    The minimum time (in seconds) for a document to be placed in the +
    CacheSocacheMinTime seconds 600 svdhE
    The minimum time (in seconds) for a document to be placed in the cache
    CacheSocacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached +
    CacheSocacheReadSize bytes 0 svdhE
    The minimum size (in bytes) of the document to read and be cached before sending the data downstream
    CacheSocacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading +
    CacheSocacheReadTime milliseconds 0 svdhE
    The minimum time (in milliseconds) that should elapse while reading before data is sent downstream
    CacheStaleOnError on|off on svdhE
    Serve stale content in place of 5xx responses.
    CacheStoreExpired On|Off Off svdhE
    Attempt to cache responses that the server reports as expired
    CacheStoreNoStore On|Off Off svdhE
    Attempt to cache requests or responses that have been marked as no-store.
    CacheStorePrivate On|Off Off svdhE
    Attempt to cache responses that the server has marked as private
    CGIDScriptTimeout time[s|ms]svdhB
    The length of time to wait for more output from the +
    CacheStaleOnError on|off on svdhE
    Serve stale content in place of 5xx responses.
    CacheStoreExpired On|Off Off svdhE
    Attempt to cache responses that the server reports as expired
    CacheStoreNoStore On|Off Off svdhE
    Attempt to cache requests or responses that have been marked as no-store.
    CacheStorePrivate On|Off Off svdhE
    Attempt to cache responses that the server has marked as private
    CGIDScriptTimeout time[s|ms]svdhB
    The length of time to wait for more output from the CGI program
    CGIMapExtension cgi-path .extensiondhC
    Technique for locating the interpreter for CGI +
    CGIMapExtension cgi-path .extensiondhC
    Technique for locating the interpreter for CGI scripts
    CGIPassAuth On|Off Off dhC
    Enables passing HTTP authorization headers to scripts as CGI +
    CGIPassAuth On|Off Off dhC
    Enables passing HTTP authorization headers to scripts as CGI variables
    CGIVar variable ruledhC
    Controls how some CGI variables are set
    CharsetDefault charsetsvdhE
    Charset to translate into
    CharsetOptions option [option] ... ImplicitAdd svdhE
    Configures charset translation behavior
    CharsetSourceEnc charsetsvdhE
    Source charset of files
    CheckCaseOnly on|off Off svdhE
    Limits the action of the speling module to case corrections
    CheckSpelling on|off Off svdhE
    Enables the spelling +
    CGIVar variable ruledhC
    Controls how some CGI variables are set
    CharsetDefault charsetsvdhE
    Charset to translate into
    CharsetOptions option [option] ... ImplicitAdd svdhE
    Configures charset translation behavior
    CharsetSourceEnc charsetsvdhE
    Source charset of files
    CheckCaseOnly on|off Off svdhE
    Limits the action of the speling module to case corrections
    CheckSpelling on|off Off svdhE
    Enables the spelling module
    ChrootDir /path/to/directorysB
    Directory for apache to run chroot(8) after startup.
    ContentDigest On|Off Off svdhC
    Enables the generation of Content-MD5 HTTP Response +
    ChrootDir /path/to/directorysB
    Directory for apache to run chroot(8) after startup.
    ContentDigest On|Off Off svdhC
    Enables the generation of Content-MD5 HTTP Response headers
    CookieDomain domainsvdhE
    The domain to which the tracking cookie applies
    CookieExpires expiry-periodsvdhE
    Expiry time for the tracking cookie
    CookieName token Apache svdhE
    Name of the tracking cookie
    CookieStyle - Netscape|Cookie|Cookie2|RFC2109|RFC2965 Netscape svdhE
    Format of the cookie header field
    CookieTracking on|off off svdhE
    Enables tracking cookie
    CoreDumpDirectory directorysM
    Directory where Apache HTTP Server attempts to +
    CookieDomain domainsvdhE
    The domain to which the tracking cookie applies
    CookieExpires expiry-periodsvdhE
    Expiry time for the tracking cookie
    CookieName token Apache svdhE
    Name of the tracking cookie
    CookieStyle + Netscape|Cookie|Cookie2|RFC2109|RFC2965 Netscape svdhE
    Format of the cookie header field
    CookieTracking on|off off svdhE
    Enables tracking cookie
    CoreDumpDirectory directorysM
    Directory where Apache HTTP Server attempts to switch before dumping core
    CustomLog file|pipe +
    CustomLog file|pipe format|nickname [env=[!]environment-variable| -expr=expression]svB
    Sets filename and format of log file
    Dav On|Off|provider-name Off dE
    Enable WebDAV HTTP methods
    DavDepthInfinity on|off off svdE
    Allow PROPFIND, Depth: Infinity requests
    DavGenericLockDB file-pathsvdE
    Location of the DAV lock database
    DavLockDB file-pathsvE
    Location of the DAV lock database
    DavMinTimeout seconds 0 svdE
    Minimum amount of time the server holds a lock on +expr=expression]svB
    Sets filename and format of log file
    Dav On|Off|provider-name Off dE
    Enable WebDAV HTTP methods
    DavDepthInfinity on|off off svdE
    Allow PROPFIND, Depth: Infinity requests
    DavGenericLockDB file-pathsvdE
    Location of the DAV lock database
    DavLockDB file-pathsvE
    Location of the DAV lock database
    DavMinTimeout seconds 0 svdE
    Minimum amount of time the server holds a lock on a DAV resource
    DBDExptime time-in-seconds 300 svE
    Keepalive time for idle connections
    DBDInitSQL "SQL statement"svE
    Execute an SQL statement after connecting to a database
    DBDKeep number 2 svE
    Maximum sustained number of connections
    DBDMax number 10 svE
    Maximum number of connections
    DBDMin number 1 svE
    Minimum number of connections
    DBDParams -param1=value1[,param2=value2]svE
    Parameters for database connection
    DBDPersist On|OffsvE
    Whether to use persistent connections
    DBDPrepareSQL "SQL statement" labelsvE
    Define an SQL prepared statement
    DBDriver namesvE
    Specify an SQL driver
    DefaultIcon url-pathsvdhB
    Icon to display for files when no specific icon is +
    DBDExptime time-in-seconds 300 svE
    Keepalive time for idle connections
    DBDInitSQL "SQL statement"svE
    Execute an SQL statement after connecting to a database
    DBDKeep number 2 svE
    Maximum sustained number of connections
    DBDMax number 10 svE
    Maximum number of connections
    DBDMin number 1 svE
    Minimum number of connections
    DBDParams +param1=value1[,param2=value2]svE
    Parameters for database connection
    DBDPersist On|OffsvE
    Whether to use persistent connections
    DBDPrepareSQL "SQL statement" labelsvE
    Define an SQL prepared statement
    DBDriver namesvE
    Specify an SQL driver
    DefaultIcon url-pathsvdhB
    Icon to display for files when no specific icon is configured
    DefaultLanguage language-tagsvdhB
    Defines a default language-tag to be sent in the Content-Language +
    DefaultLanguage language-tagsvdhB
    Defines a default language-tag to be sent in the Content-Language header field for all resources in the current context that have not been assigned a language-tag by some other means.
    DefaultRuntimeDir directory-path DEFAULT_REL_RUNTIME +sC
    Base directory for the server run-time files
    DefaultType media-type|none none svdhC
    This directive has no effect other than to emit warnings +
    DefaultRuntimeDir directory-path DEFAULT_REL_RUNTIME +sC
    Base directory for the server run-time files
    DefaultType media-type|none none svdhC
    This directive has no effect other than to emit warnings if the value is not none. In prior versions, DefaultType would specify a default media type to assign to response content for which no other media type configuration could be found.
    Define parameter-namesC
    Define the existence of a variable
    DeflateBufferSize value 8096 svE
    Fragment size to be compressed at one time by zlib
    DeflateCompressionLevel valuesvE
    How much compression do we apply to the output
    DeflateFilterNote [type] notenamesvE
    Places the compression ratio in a note for logging
    DeflateInflateLimitRequestBodyvaluesvdhE
    Maximum size of inflated request bodies
    DeflateInflateRatioBurst valuesvdhE
    Maximum number of times the inflation ratio for request bodies +
    Define parameter-namesC
    Define the existence of a variable
    DeflateBufferSize value 8096 svE
    Fragment size to be compressed at one time by zlib
    DeflateCompressionLevel valuesvE
    How much compression do we apply to the output
    DeflateFilterNote [type] notenamesvE
    Places the compression ratio in a note for logging
    DeflateInflateLimitRequestBodyvaluesvdhE
    Maximum size of inflated request bodies
    DeflateInflateRatioBurst valuesvdhE
    Maximum number of times the inflation ratio for request bodies can be crossed
    DeflateInflateRatioLimit valuesvdhE
    Maximum inflation ratio for request bodies
    DeflateMemLevel value 9 svE
    How much memory should be used by zlib for compression
    DeflateWindowSize value 15 svE
    Zlib compression window size
    Deny from all|host|env=[!]env-variable -[host|env=[!]env-variable] ...dhE
    Controls which hosts are denied access to the +
    DeflateInflateRatioLimit valuesvdhE
    Maximum inflation ratio for request bodies
    DeflateMemLevel value 9 svE
    How much memory should be used by zlib for compression
    DeflateWindowSize value 15 svE
    Zlib compression window size
    Deny from all|host|env=[!]env-variable +[host|env=[!]env-variable] ...dhE
    Controls which hosts are denied access to the server
    <Directory directory-path> -... </Directory>svC
    Enclose a group of directives that apply only to the +
    <Directory directory-path> +... </Directory>svC
    Enclose a group of directives that apply only to the named file-system directory, sub-directories, and their contents.
    DirectoryCheckHandler On|Off Off svdhB
    Toggle how this module responds when another handler is configured
    DirectoryIndex - disabled | local-url [local-url] ... index.html svdhB
    List of resources to look for when the client requests +
    DirectoryCheckHandler On|Off Off svdhB
    Toggle how this module responds when another handler is configured
    DirectoryIndex + disabled | local-url [local-url] ... index.html svdhB
    List of resources to look for when the client requests a directory
    DirectoryIndexRedirect on | off | permanent | temp | seeother | +
    DirectoryIndexRedirect on | off | permanent | temp | seeother | 3xx-code - off svdhB
    Configures an external redirect for directory indexes. + off svdhB
    Configures an external redirect for directory indexes.
    <DirectoryMatch regex> -... </DirectoryMatch>svC
    Enclose directives that apply to +
    <DirectoryMatch regex> +... </DirectoryMatch>svC
    Enclose directives that apply to the contents of file-system directories matching a regular expression.
    DirectorySlash On|Off On svdhB
    Toggle trailing slash redirects on or off
    DocumentRoot directory-path /usr/local/apache/h +svC
    Directory that forms the main document tree visible +
    DirectorySlash On|Off On svdhB
    Toggle trailing slash redirects on or off
    DocumentRoot directory-path /usr/local/apache/h +svC
    Directory that forms the main document tree visible from the web
    DTracePrivileges On|Off Off sX
    Determines whether the privileges required by dtrace are enabled.
    DumpIOInput On|Off Off sE
    Dump all input data to the error log
    DumpIOOutput On|Off Off sE
    Dump all output data to the error log
    <Else> ... </Else>svdhC
    Contains directives that apply only if the condition of a +
    DTracePrivileges On|Off Off sX
    Determines whether the privileges required by dtrace are enabled.
    DumpIOInput On|Off Off sE
    Dump all input data to the error log
    DumpIOOutput On|Off Off sE
    Dump all output data to the error log
    <Else> ... </Else>svdhC
    Contains directives that apply only if the condition of a previous <If> or <ElseIf> section is not satisfied by a request at runtime
    <ElseIf expression> ... </ElseIf>svdhC
    Contains directives that apply only if a condition is satisfied +
    <ElseIf expression> ... </ElseIf>svdhC
    Contains directives that apply only if a condition is satisfied by a request at runtime while the condition of a previous <If> or <ElseIf> section is not satisfied
    EnableExceptionHook On|Off Off sM
    Enables a hook that runs exception handlers +
    EnableExceptionHook On|Off Off sM
    Enables a hook that runs exception handlers after a crash
    EnableMMAP On|Off On svdhC
    Use memory-mapping to read files during delivery
    EnableSendfile On|Off Off svdhC
    Use the kernel sendfile support to deliver files to the client
    Error messagesvdhC
    Abort configuration parsing with a custom error message
    ErrorDocument error-code documentsvdhC
    What the server will return to the client +
    EnableMMAP On|Off On svdhC
    Use memory-mapping to read files during delivery
    EnableSendfile On|Off Off svdhC
    Use the kernel sendfile support to deliver files to the client
    Error messagesvdhC
    Abort configuration parsing with a custom error message
    ErrorDocument error-code documentsvdhC
    What the server will return to the client in case of an error
    ErrorLog file-path|syslog[:facility] logs/error_log (Uni +svC
    Location where the server will log errors
    ErrorLog [connection|request] formatsvC
    Format specification for error log entries
    ExamplesvdhX
    Demonstration directive to illustrate the Apache module +
    ErrorLog file-path|syslog[:facility] logs/error_log (Uni +svC
    Location where the server will log errors
    ErrorLog [connection|request] formatsvC
    Format specification for error log entries
    ExamplesvdhX
    Demonstration directive to illustrate the Apache module API
    ExpiresActive On|Off Off svdhE
    Enables generation of Expires +
    ExpiresActive On|Off Off svdhE
    Enables generation of Expires headers
    ExpiresByType MIME-type -<code>secondssvdhE
    Value of the Expires header configured +
    ExpiresByType MIME-type +<code>secondssvdhE
    Value of the Expires header configured by MIME type
    ExpiresDefault <code>secondssvdhE
    Default algorithm for calculating expiration time
    ExtendedStatus On|Off Off[*] sC
    Keep track of extended status information for each +
    ExpiresDefault <code>secondssvdhE
    Default algorithm for calculating expiration time
    ExtendedStatus On|Off Off[*] sC
    Keep track of extended status information for each request
    ExtFilterDefine filtername parameterssE
    Define an external filter
    ExtFilterOptions option [option] ... NoLogStderr dE
    Configure mod_ext_filter options
    FallbackResource disabled | local-urlsvdhB
    Define a default URL for requests that don't map to a file
    FileETag component ... INode MTime Size svdhC
    File attributes used to create the ETag +
    ExtFilterDefine filtername parameterssE
    Define an external filter
    ExtFilterOptions option [option] ... NoLogStderr dE
    Configure mod_ext_filter options
    FallbackResource disabled | local-urlsvdhB
    Define a default URL for requests that don't map to a file
    FileETag component ... INode MTime Size svdhC
    File attributes used to create the ETag HTTP response header for static files
    <Files filename> ... </Files>svdhC
    Contains directives that apply to matched +
    <Files filename> ... </Files>svdhC
    Contains directives that apply to matched filenames
    <FilesMatch regex> ... </FilesMatch>svdhC
    Contains directives that apply to regular-expression matched +
    <FilesMatch regex> ... </FilesMatch>svdhC
    Contains directives that apply to regular-expression matched filenames
    FilterChain [+=-@!]filter-name ...svdhB
    Configure the filter chain
    FilterDeclare filter-name [type]svdhB
    Declare a smart filter
    FilterProtocol filter-name [provider-name] - proto-flagssvdhB
    Deal with correct HTTP protocol handling
    FilterProvider filter-name provider-name - expressionsvdhB
    Register a content filter
    FilterTrace filter-name levelsvdB
    Get debug/diagnostic information from +
    FilterChain [+=-@!]filter-name ...svdhB
    Configure the filter chain
    FilterDeclare filter-name [type]svdhB
    Declare a smart filter
    FilterProtocol filter-name [provider-name] + proto-flagssvdhB
    Deal with correct HTTP protocol handling
    FilterProvider filter-name provider-name + expressionsvdhB
    Register a content filter
    FilterTrace filter-name levelsvdB
    Get debug/diagnostic information from mod_filter
    ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] Prefer svdhB
    Action to take if a single acceptable document is not +
    ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback] Prefer svdhB
    Action to take if a single acceptable document is not found
    ForceType media-type|NonedhC
    Forces all matching files to be served with the specified +
    ForceType media-type|NonedhC
    Forces all matching files to be served with the specified media type in the HTTP Content-Type header field
    ForensicLog filename|pipesvE
    Sets filename of the forensic log
    GlobalLogfile|pipe +
    ForensicLog filename|pipesvE
    Sets filename of the forensic log
    GlobalLogfile|pipe format|nickname [env=[!]environment-variable| -expr=expression]sB
    Sets filename and format of log file
    GprofDir /tmp/gprof/|/tmp/gprof/%svC
    Directory to write gmon.out profiling data to.
    GracefulShutdownTimeout seconds 0 sM
    Specify a timeout after which a gracefully shutdown server +expr=expression]sB
    Sets filename and format of log file
    GprofDir /tmp/gprof/|/tmp/gprof/%svC
    Directory to write gmon.out profiling data to.
    GracefulShutdownTimeout seconds 0 sM
    Specify a timeout after which a gracefully shutdown server will exit.
    Group unix-group #-1 sB
    Group under which the server will answer +
    Group unix-group #-1 sB
    Group under which the server will answer requests
    H2CopyFiles on|off off svdhE
    Determine file handling in responses
    H2Direct on|off on for h2c, off for +svE
    H2 Direct Protocol Switch
    H2EarlyHints on|off off svE
    Determine sending of 103 status codes
    H2MaxSessionStreams n 100 svE
    Maximum number of active streams per HTTP/2 session.
    H2MaxWorkerIdleSeconds n 600 sE
    Maximum number of seconds h2 workers remain idle until shut down.
    H2MaxWorkers nsE
    Maximum number of worker threads to use per child process.
    H2MinWorkers nsE
    Minimal number of worker threads to use per child process.
    H2ModernTLSOnly on|off on svE
    Require HTTP/2 connections to be "modern TLS" only
    H2Push on|off on svE
    H2 Server Push Switch
    H2PushDiarySize n 256 svE
    H2 Server Push Diary Size
    H2PushPriority mime-type [after|before|interleaved] [weight] * After 16 svE
    H2 Server Push Priority
    H2PushResource [add] path [critical]svdhE
    Declares resources for early pushing to the client
    H2SerializeHeaders on|off off svE
    Serialize Request/Response Processing Switch
    H2StreamMaxMemSize bytes 65536 svE
    Maximum amount of output data buffered per stream.
    H2TLSCoolDownSecs seconds 1 svE
    -
    H2TLSWarmUpSize amount 1048576 svE
    -
    H2Upgrade on|off on for h2c, off for +svE
    H2 Upgrade Protocol Switch
    H2WindowSize bytes 65535 svE
    Size of Stream Window for upstream data.
    Header [condition] add|append|echo|edit|edit*|merge|set|setifempty|unset|note +
    H2CopyFiles on|off off svdhE
    Determine file handling in responses
    H2Direct on|off on for h2c, off for +svE
    H2 Direct Protocol Switch
    H2EarlyHints on|off off svE
    Determine sending of 103 status codes
    H2MaxSessionStreams n 100 svE
    Maximum number of active streams per HTTP/2 session.
    H2MaxWorkerIdleSeconds n 600 sE
    Maximum number of seconds h2 workers remain idle until shut down.
    H2MaxWorkers nsE
    Maximum number of worker threads to use per child process.
    H2MinWorkers nsE
    Minimal number of worker threads to use per child process.
    H2ModernTLSOnly on|off on svE
    Require HTTP/2 connections to be "modern TLS" only
    H2Push on|off on svE
    H2 Server Push Switch
    H2PushDiarySize n 256 svE
    H2 Server Push Diary Size
    H2PushPriority mime-type [after|before|interleaved] [weight] * After 16 svE
    H2 Server Push Priority
    H2PushResource [add] path [critical]svdhE
    Declares resources for early pushing to the client
    H2SerializeHeaders on|off off svE
    Serialize Request/Response Processing Switch
    H2StreamMaxMemSize bytes 65536 svE
    Maximum amount of output data buffered per stream.
    H2TLSCoolDownSecs seconds 1 svE
    -
    H2TLSWarmUpSize amount 1048576 svE
    -
    H2Upgrade on|off on for h2c, off for +svE
    H2 Upgrade Protocol Switch
    H2WindowSize bytes 65535 svE
    Size of Stream Window for upstream data.
    Header [condition] add|append|echo|edit|edit*|merge|set|setifempty|unset|note header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] -svdhE
    Configure HTTP response headers
    HeaderName filenamesvdhB
    Name of the file that will be inserted at the top +svdhE
    Configure HTTP response headers
    HeaderName filenamesvdhB
    Name of the file that will be inserted at the top of the index listing
    HeartbeatAddress addr:portsX
    Multicast address for heartbeat packets
    HeartbeatListenaddr:portsX
    multicast address to listen for incoming heartbeat requests
    HeartbeatMaxServers number-of-servers 10 sX
    Specifies the maximum number of servers that will be sending +
    HeartbeatAddress addr:portsX
    Multicast address for heartbeat packets
    HeartbeatListenaddr:portsX
    multicast address to listen for incoming heartbeat requests
    HeartbeatMaxServers number-of-servers 10 sX
    Specifies the maximum number of servers that will be sending heartbeat requests to this server
    HeartbeatStorage file-path logs/hb.dat sX
    Path to store heartbeat data
    HeartbeatStorage file-path logs/hb.dat sX
    Path to read heartbeat data
    HostnameLookups On|Off|Double Off svdC
    Enables DNS lookups on client IP addresses
    HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] - [Allow0.9|Require1.0] Strict LenientMetho +svC
    Modify restrictions on HTTP Request Messages
    IdentityCheck On|Off Off svdE
    Enables logging of the RFC 1413 identity of the remote +
    HeartbeatStorage file-path logs/hb.dat sX
    Path to store heartbeat data
    HeartbeatStorage file-path logs/hb.dat sX
    Path to read heartbeat data
    HostnameLookups On|Off|Double Off svdC
    Enables DNS lookups on client IP addresses
    HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods] + [Allow0.9|Require1.0] Strict LenientMetho +svC
    Modify restrictions on HTTP Request Messages
    IdentityCheck On|Off Off svdE
    Enables logging of the RFC 1413 identity of the remote user
    IdentityCheckTimeout seconds 30 svdE
    Determines the timeout duration for ident requests
    <If expression> ... </If>svdhC
    Contains directives that apply only if a condition is +
    IdentityCheckTimeout seconds 30 svdE
    Determines the timeout duration for ident requests
    <If expression> ... </If>svdhC
    Contains directives that apply only if a condition is satisfied by a request at runtime
    <IfDefine [!]parameter-name> ... - </IfDefine>svdhC
    Encloses directives that will be processed only +
    <IfDefine [!]parameter-name> ... + </IfDefine>svdhC
    Encloses directives that will be processed only if a test is true at startup
    <IfModule [!]module-file|module-identifier> ... - </IfModule>svdhC
    Encloses directives that are processed conditional on the +
    <IfModule [!]module-file|module-identifier> ... + </IfModule>svdhC
    Encloses directives that are processed conditional on the presence or absence of a specific module
    <IfVersion [[!]operator] version> ... -</IfVersion>svdhE
    contains version dependent configuration
    ImapBase map|referer|URL http://servername/ svdhB
    Default base for imagemap files
    ImapDefault error|nocontent|map|referer|URL nocontent svdhB
    Default action when an imagemap is called with coordinates +
    <IfVersion [[!]operator] version> ... +</IfVersion>svdhE
    contains version dependent configuration
    ImapBase map|referer|URL http://servername/ svdhB
    Default base for imagemap files
    ImapDefault error|nocontent|map|referer|URL nocontent svdhB
    Default action when an imagemap is called with coordinates that are not explicitly mapped
    ImapMenu none|formatted|semiformatted|unformatted formatted svdhB
    Action if no coordinates are given when calling +
    ImapMenu none|formatted|semiformatted|unformatted formatted svdhB
    Action if no coordinates are given when calling an imagemap
    Include [optional|strict] file-path|directory-path|wildcardsvdC
    Includes other configuration files from within +
    Include [optional|strict] file-path|directory-path|wildcardsvdC
    Includes other configuration files from within the server configuration files
    IncludeOptional file-path|directory-path|wildcardsvdC
    Includes other configuration files from within +
    IncludeOptional file-path|directory-path|wildcardsvdC
    Includes other configuration files from within the server configuration files
    IndexHeadInsert "markup ..."svdhB
    Inserts text in the HEAD section of an index page.
    IndexIgnore file [file] ... "." svdhB
    Adds to the list of files to hide when listing +
    IndexHeadInsert "markup ..."svdhB
    Inserts text in the HEAD section of an index page.
    IndexIgnore file [file] ... "." svdhB
    Adds to the list of files to hide when listing a directory
    IndexIgnoreReset ON|OFFsvdhB
    Empties the list of files to hide when listing +
    IndexIgnoreReset ON|OFFsvdhB
    Empties the list of files to hide when listing a directory
    IndexOptions [+|-]option [[+|-]option] -...svdhB
    Various configuration settings for directory +
    IndexOptions [+|-]option [[+|-]option] +...svdhB
    Various configuration settings for directory indexing
    IndexOrderDefault Ascending|Descending -Name|Date|Size|Description Ascending Name svdhB
    Sets the default ordering of the directory index
    IndexStyleSheet url-pathsvdhB
    Adds a CSS stylesheet to the directory index
    InputSed sed-commanddhX
    Sed command to filter request data (typically POST data)
    ISAPIAppendLogToErrors on|off off svdhB
    Record HSE_APPEND_LOG_PARAMETER requests from +
    IndexOrderDefault Ascending|Descending +Name|Date|Size|Description Ascending Name svdhB
    Sets the default ordering of the directory index
    IndexStyleSheet url-pathsvdhB
    Adds a CSS stylesheet to the directory index
    InputSed sed-commanddhX
    Sed command to filter request data (typically POST data)
    ISAPIAppendLogToErrors on|off off svdhB
    Record HSE_APPEND_LOG_PARAMETER requests from ISAPI extensions to the error log
    ISAPIAppendLogToQuery on|off on svdhB
    Record HSE_APPEND_LOG_PARAMETER requests from +
    ISAPIAppendLogToQuery on|off on svdhB
    Record HSE_APPEND_LOG_PARAMETER requests from ISAPI extensions to the query field
    ISAPICacheFile file-path [file-path] -...svB
    ISAPI .dll files to be loaded at startup
    ISAPIFakeAsync on|off off svdhB
    Fake asynchronous support for ISAPI callbacks
    ISAPILogNotSupported on|off off svdhB
    Log unsupported feature requests from ISAPI +
    ISAPICacheFile file-path [file-path] +...svB
    ISAPI .dll files to be loaded at startup
    ISAPIFakeAsync on|off off svdhB
    Fake asynchronous support for ISAPI callbacks
    ISAPILogNotSupported on|off off svdhB
    Log unsupported feature requests from ISAPI extensions
    ISAPIReadAheadBuffer size 49152 svdhB
    Size of the Read Ahead Buffer sent to ISAPI +
    ISAPIReadAheadBuffer size 49152 svdhB
    Size of the Read Ahead Buffer sent to ISAPI extensions
    KeepAlive On|Off On svC
    Enables HTTP persistent connections
    KeepAliveTimeout num[ms] 5 svC
    Amount of time the server will wait for subsequent +
    KeepAlive On|Off On svC
    Enables HTTP persistent connections
    KeepAliveTimeout num[ms] 5 svC
    Amount of time the server will wait for subsequent requests on a persistent connection
    KeptBodySize maximum size in bytes 0 dB
    Keep the request body instead of discarding it up to +
    KeptBodySize maximum size in bytes 0 dB
    Keep the request body instead of discarding it up to the specified maximum size, for potential use by filters such as mod_include.
    LanguagePriority MIME-lang [MIME-lang] -...svdhB
    The precedence of language variants for cases where +
    LanguagePriority MIME-lang [MIME-lang] +...svdhB
    The precedence of language variants for cases where the client does not express a preference
    LDAPCacheEntries number 1024 sE
    Maximum number of entries in the primary LDAP cache
    LDAPCacheTTL seconds 600 sE
    Time that cached items remain valid
    LDAPConnectionPoolTTL n -1 svE
    Discard backend connections that have been sitting in the connection pool too long
    LDAPConnectionTimeout secondssE
    Specifies the socket connection timeout in seconds
    LDAPLibraryDebug 7sE
    Enable debugging in the LDAP SDK
    LDAPOpCacheEntries number 1024 sE
    Number of entries used to cache LDAP compare +
    LDAPCacheEntries number 1024 sE
    Maximum number of entries in the primary LDAP cache
    LDAPCacheTTL seconds 600 sE
    Time that cached items remain valid
    LDAPConnectionPoolTTL n -1 svE
    Discard backend connections that have been sitting in the connection pool too long
    LDAPConnectionTimeout secondssE
    Specifies the socket connection timeout in seconds
    LDAPLibraryDebug 7sE
    Enable debugging in the LDAP SDK
    LDAPOpCacheEntries number 1024 sE
    Number of entries used to cache LDAP compare operations
    LDAPOpCacheTTL seconds 600 sE
    Time that entries in the operation cache remain +
    LDAPOpCacheTTL seconds 600 sE
    Time that entries in the operation cache remain valid
    LDAPReferralHopLimit numberdhE
    The maximum number of referral hops to chase before terminating an LDAP query.
    LDAPReferrals On|Off|default On dhE
    Enable referral chasing during queries to the LDAP server.
    LDAPRetries number-of-retries 3 sE
    Configures the number of LDAP server retries.
    LDAPRetryDelay seconds 0 sE
    Configures the delay between LDAP server retries.
    LDAPSharedCacheFile directory-path/filenamesE
    Sets the shared memory cache file
    LDAPSharedCacheSize bytes 500000 sE
    Size in bytes of the shared-memory cache
    LDAPTimeout seconds 60 sE
    Specifies the timeout for LDAP search and bind operations, in seconds
    LDAPTrustedClientCert type directory-path/filename/nickname [password]dhE
    Sets the file containing or nickname referring to a per +
    LDAPReferralHopLimit numberdhE
    The maximum number of referral hops to chase before terminating an LDAP query.
    LDAPReferrals On|Off|default On dhE
    Enable referral chasing during queries to the LDAP server.
    LDAPRetries number-of-retries 3 sE
    Configures the number of LDAP server retries.
    LDAPRetryDelay seconds 0 sE
    Configures the delay between LDAP server retries.
    LDAPSharedCacheFile directory-path/filenamesE
    Sets the shared memory cache file
    LDAPSharedCacheSize bytes 500000 sE
    Size in bytes of the shared-memory cache
    LDAPTimeout seconds 60 sE
    Specifies the timeout for LDAP search and bind operations, in seconds
    LDAPTrustedClientCert type directory-path/filename/nickname [password]dhE
    Sets the file containing or nickname referring to a per connection client certificate. Not all LDAP toolkits support per connection client certificates.
    LDAPTrustedGlobalCert type directory-path/filename [password]sE
    Sets the file or database containing global trusted +
    LDAPTrustedGlobalCert type directory-path/filename [password]sE
    Sets the file or database containing global trusted Certificate Authority or global client certificates
    LDAPTrustedMode typesvE
    Specifies the SSL/TLS mode to be used when connecting to an LDAP server.
    LDAPVerifyServerCert On|Off On sE
    Force server certificate verification
    <Limit method [method] ... > ... - </Limit>dhC
    Restrict enclosed access controls to only certain HTTP +
    LDAPTrustedMode typesvE
    Specifies the SSL/TLS mode to be used when connecting to an LDAP server.
    LDAPVerifyServerCert On|Off On sE
    Force server certificate verification
    <Limit method [method] ... > ... + </Limit>dhC
    Restrict enclosed access controls to only certain HTTP methods
    <LimitExcept method [method] ... > ... - </LimitExcept>dhC
    Restrict access controls to all HTTP methods +
    <LimitExcept method [method] ... > ... + </LimitExcept>dhC
    Restrict access controls to all HTTP methods except the named ones
    LimitInternalRecursion number [number] 10 svC
    Determine maximum number of internal redirects and nested +
    LimitInternalRecursion number [number] 10 svC
    Determine maximum number of internal redirects and nested subrequests
    LimitRequestBody bytes 0 svdhC
    Restricts the total size of the HTTP request body sent +
    LimitRequestBody bytes 0 svdhC
    Restricts the total size of the HTTP request body sent from the client
    LimitRequestFields number 100 svC
    Limits the number of HTTP request header fields that +
    LimitRequestFields number 100 svC
    Limits the number of HTTP request header fields that will be accepted from the client
    LimitRequestFieldSize bytes 8190 svC
    Limits the size of the HTTP request header allowed from the +
    LimitRequestFieldSize bytes 8190 svC
    Limits the size of the HTTP request header allowed from the client
    LimitRequestLine bytes 8190 svC
    Limit the size of the HTTP request line that will be accepted +
    LimitRequestLine bytes 8190 svC
    Limit the size of the HTTP request line that will be accepted from the client
    LimitXMLRequestBody bytes 1000000 svdhC
    Limits the size of an XML-based request body
    Listen [IP-address:]portnumber [protocol]sM
    IP addresses and ports that the server +
    LimitXMLRequestBody bytes 1000000 svdhC
    Limits the size of an XML-based request body
    Listen [IP-address:]portnumber [protocol]sM
    IP addresses and ports that the server listens to
    ListenBacklog backlogsM
    Maximum length of the queue of pending connections
    ListenCoresBucketsRatio ratio 0 (disabled) sM
    Ratio between the number of CPU cores (online) and the number of +
    ListenBacklog backlogsM
    Maximum length of the queue of pending connections
    ListenCoresBucketsRatio ratio 0 (disabled) sM
    Ratio between the number of CPU cores (online) and the number of listeners' buckets
    LoadFile filename [filename] ...svE
    Link in the named object file or library
    LoadModule module filenamesvE
    Links in the object file or library, and adds to the list +
    LoadFile filename [filename] ...svE
    Link in the named object file or library
    LoadModule module filenamesvE
    Links in the object file or library, and adds to the list of active modules
    <Location - URL-path|URL> ... </Location>svC
    Applies the enclosed directives only to matching +
    <Location + URL-path|URL> ... </Location>svC
    Applies the enclosed directives only to matching URLs
    <LocationMatch - regex> ... </LocationMatch>svC
    Applies the enclosed directives only to regular-expression +
    <LocationMatch + regex> ... </LocationMatch>svC
    Applies the enclosed directives only to regular-expression matching URLs
    LogFormat format|nickname -[nickname] "%h %l %u %t \"%r\" +svB
    Describes a format for use in a log file
    LogIOTrackTTFB ON|OFF OFF svdhE
    Enable tracking of time to first byte (TTFB)
    LogLevel [module:]level +
    LogFormat format|nickname +[nickname] "%h %l %u %t \"%r\" +svB
    Describes a format for use in a log file
    LogIOTrackTTFB ON|OFF OFF svdhE
    Enable tracking of time to first byte (TTFB)
    LogLevel [module:]level [module:level] ... - warn svdC
    Controls the verbosity of the ErrorLog
    LogMessage message + warn svdC
    Controls the verbosity of the ErrorLog
    LogMessage message [hook=hook] [expr=expression] -dX
    Log user-defined message to error log +dX
    Log user-defined message to error log
    LuaAuthzProvider provider_name /path/to/lua/script.lua function_namesX
    Plug an authorization provider function into mod_authz_core +
    LuaAuthzProvider provider_name /path/to/lua/script.lua function_namesX
    Plug an authorization provider function into mod_authz_core
    LuaCodeCache stat|forever|never stat svdhX
    Configure the compiled code cache.
    LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late]svdhX
    Provide a hook for the access_checker phase of request processing
    LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late]svdhX
    Provide a hook for the auth_checker phase of request processing
    LuaHookCheckUserID /path/to/lua/script.lua hook_function_name [early|late]svdhX
    Provide a hook for the check_user_id phase of request processing
    LuaHookFixups /path/to/lua/script.lua hook_function_namesvdhX
    Provide a hook for the fixups phase of a request +
    LuaCodeCache stat|forever|never stat svdhX
    Configure the compiled code cache.
    LuaHookAccessChecker /path/to/lua/script.lua hook_function_name [early|late]svdhX
    Provide a hook for the access_checker phase of request processing
    LuaHookAuthChecker /path/to/lua/script.lua hook_function_name [early|late]svdhX
    Provide a hook for the auth_checker phase of request processing
    LuaHookCheckUserID /path/to/lua/script.lua hook_function_name [early|late]svdhX
    Provide a hook for the check_user_id phase of request processing
    LuaHookFixups /path/to/lua/script.lua hook_function_namesvdhX
    Provide a hook for the fixups phase of a request processing
    LuaHookInsertFilter /path/to/lua/script.lua hook_function_namesvdhX
    Provide a hook for the insert_filter phase of request processing
    LuaHookLog /path/to/lua/script.lua log_function_namesvdhX
    Provide a hook for the access log phase of a request +
    LuaHookInsertFilter /path/to/lua/script.lua hook_function_namesvdhX
    Provide a hook for the insert_filter phase of request processing
    LuaHookLog /path/to/lua/script.lua log_function_namesvdhX
    Provide a hook for the access log phase of a request processing
    LuaHookMapToStorage /path/to/lua/script.lua hook_function_namesvdhX
    Provide a hook for the map_to_storage phase of request processing
    LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late]svX
    Provide a hook for the translate name phase of request processing
    LuaHookTypeChecker /path/to/lua/script.lua hook_function_namesvdhX
    Provide a hook for the type_checker phase of request processing
    LuaInherit none|parent-first|parent-last parent-first svdhX
    Controls how parent configuration sections are merged into children
    LuaInputFilter filter_name /path/to/lua/script.lua function_namesX
    Provide a Lua function for content input filtering
    LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name]svdhX
    Map a path to a lua handler
    LuaOutputFilter filter_name /path/to/lua/script.lua function_namesX
    Provide a Lua function for content output filtering
    LuaPackageCPath /path/to/include/?.soasvdhX
    Add a directory to lua's package.cpath
    LuaPackagePath /path/to/include/?.luasvdhX
    Add a directory to lua's package.path
    LuaQuickHandler /path/to/script.lua hook_function_namesvX
    Provide a hook for the quick handler of request processing
    LuaRoot /path/to/a/directorysvdhX
    Specify the base path for resolving relative paths for mod_lua directives
    LuaScope once|request|conn|thread|server [min] [max] once svdhX
    One of once, request, conn, thread -- default is once
    +
    LuaHookMapToStorage /path/to/lua/script.lua hook_function_namesvdhX
    Provide a hook for the map_to_storage phase of request processing
    LuaHookTranslateName /path/to/lua/script.lua hook_function_name [early|late]svX
    Provide a hook for the translate name phase of request processing
    LuaHookTypeChecker /path/to/lua/script.lua hook_function_namesvdhX
    Provide a hook for the type_checker phase of request processing
    LuaInherit none|parent-first|parent-last parent-first svdhX
    Controls how parent configuration sections are merged into children
    LuaInputFilter filter_name /path/to/lua/script.lua function_namesX
    Provide a Lua function for content input filtering
    LuaMapHandler uri-pattern /path/to/lua/script.lua [function-name]svdhX
    Map a path to a lua handler
    LuaOutputFilter filter_name /path/to/lua/script.lua function_namesX
    Provide a Lua function for content output filtering
    LuaPackageCPath /path/to/include/?.soasvdhX
    Add a directory to lua's package.cpath
    LuaPackagePath /path/to/include/?.luasvdhX
    Add a directory to lua's package.path
    LuaQuickHandler /path/to/script.lua hook_function_namesvX
    Provide a hook for the quick handler of request processing
    LuaRoot /path/to/a/directorysvdhX
    Specify the base path for resolving relative paths for mod_lua directives
    LuaScope once|request|conn|thread|server [min] [max] once svdhX
    One of once, request, conn, thread -- default is once
    <Macro name [par1 .. parN]> -... </Macro>svdB
    Define a configuration file macro
    MaxConnectionsPerChild number 0 sM
    Limit on the number of connections that an individual child server +... </Macro>svdB
    Define a configuration file macro
    MaxConnectionsPerChild number 0 sM
    Limit on the number of connections that an individual child server will handle during its life
    MaxKeepAliveRequests number 100 svC
    Number of requests allowed on a persistent +
    MaxKeepAliveRequests number 100 svC
    Number of requests allowed on a persistent connection
    MaxMemFree KBytes 2048 sM
    Maximum amount of memory that the main allocator is allowed +
    MaxMemFree KBytes 2048 sM
    Maximum amount of memory that the main allocator is allowed to hold without calling free()
    MaxRangeOverlaps default | unlimited | none | number-of-ranges 20 svdC
    Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete +
    MaxRangeOverlaps default | unlimited | none | number-of-ranges 20 svdC
    Number of overlapping ranges (eg: 100-200,150-300) allowed before returning the complete resource
    MaxRangeReversals default | unlimited | none | number-of-ranges 20 svdC
    Number of range reversals (eg: 100-200,50-70) allowed before returning the complete +
    MaxRangeReversals default | unlimited | none | number-of-ranges 20 svdC
    Number of range reversals (eg: 100-200,50-70) allowed before returning the complete resource
    MaxRanges default | unlimited | none | number-of-ranges 200 svdC
    Number of ranges allowed before returning the complete +
    MaxRanges default | unlimited | none | number-of-ranges 200 svdC
    Number of ranges allowed before returning the complete resource
    MaxRequestWorkers numbersM
    Maximum number of connections that will be processed +
    MaxRequestWorkers numbersM
    Maximum number of connections that will be processed simultaneously
    MaxSpareServers number 10 sM
    Maximum number of idle child server processes
    MaxSpareThreads numbersM
    Maximum number of idle threads
    MaxThreads number 2048 sM
    Set the maximum number of worker threads
    MemcacheConnTTL num[units] 15s svE
    Keepalive time for idle connections
    MergeTrailers [on|off] off svC
    Determines whether trailers are merged into headers
    MetaDir directory .web svdhE
    Name of the directory to find CERN-style meta information +
    MaxSpareServers number 10 sM
    Maximum number of idle child server processes
    MaxSpareThreads numbersM
    Maximum number of idle threads
    MaxThreads number 2048 sM
    Set the maximum number of worker threads
    MemcacheConnTTL num[units] 15s svE
    Keepalive time for idle connections
    MergeTrailers [on|off] off svC
    Determines whether trailers are merged into headers
    MetaDir directory .web svdhE
    Name of the directory to find CERN-style meta information files
    MetaFiles on|off off svdhE
    Activates CERN meta-file processing
    MetaSuffix suffix .meta svdhE
    File name suffix for the file containing CERN-style +
    MetaFiles on|off off svdhE
    Activates CERN meta-file processing
    MetaSuffix suffix .meta svdhE
    File name suffix for the file containing CERN-style meta information
    MimeMagicFile file-pathsvE
    Enable MIME-type determination based on file contents +
    MimeMagicFile file-pathsvE
    Enable MIME-type determination based on file contents using the specified magic file
    MinSpareServers number 5 sM
    Minimum number of idle child server processes
    MinSpareThreads numbersM
    Minimum number of idle threads available to handle request +
    MinSpareServers number 5 sM
    Minimum number of idle child server processes
    MinSpareThreads numbersM
    Minimum number of idle threads available to handle request spikes
    MMapFile file-path [file-path] ...sX
    Map a list of files into memory at startup time
    ModemStandard V.21|V.26bis|V.32|V.34|V.92dX
    Modem standard to simulate
    ModMimeUsePathInfo On|Off Off dB
    Tells mod_mime to treat path_info +
    MMapFile file-path [file-path] ...sX
    Map a list of files into memory at startup time
    ModemStandard V.21|V.26bis|V.32|V.34|V.92dX
    Modem standard to simulate
    ModMimeUsePathInfo On|Off Off dB
    Tells mod_mime to treat path_info components as part of the filename
    MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers -[Handlers|Filters] NegotiatedOnly svdhB
    The types of files that will be included when searching for +
    MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers +[Handlers|Filters] NegotiatedOnly svdhB
    The types of files that will be included when searching for a matching file with MultiViews
    Mutex mechanism [default|mutex-name] ... [OmitPID] default sC
    Configures mutex mechanism and lock file directory for all +
    Mutex mechanism [default|mutex-name] ... [OmitPID] default sC
    Configures mutex mechanism and lock file directory for all or specified mutexes
    NameVirtualHost addr[:port]sC
    Designates an IP address for name-virtual +
    NameVirtualHost addr[:port]sC
    Designates an IP address for name-virtual hosting
    NoProxy host [host] ...svE
    Hosts, domains, or networks that will be connected to +
    NoProxy host [host] ...svE
    Hosts, domains, or networks that will be connected to directly
    NWSSLTrustedCerts filename [filename] ...sB
    List of additional client certificates
    NWSSLUpgradeable [IP-address:]portnumbersB
    Allows a connection to be upgraded to an SSL connection upon request
    Options - [+|-]option [[+|-]option] ... All svdhC
    Configures what features are available in a particular +
    NWSSLTrustedCerts filename [filename] ...sB
    List of additional client certificates
    NWSSLUpgradeable [IP-address:]portnumbersB
    Allows a connection to be upgraded to an SSL connection upon request
    Options + [+|-]option [[+|-]option] ... All svdhC
    Configures what features are available in a particular directory
    Order ordering Deny,Allow dhE
    Controls the default access state and the order in which +
    Order ordering Deny,Allow dhE
    Controls the default access state and the order in which Allow and Deny are evaluated.
    OutputSed sed-commanddhX
    Sed command for filtering response content
    PassEnv env-variable [env-variable] -...svdhB
    Passes environment variables from the shell
    PidFile filename logs/httpd.pid sM
    File where the server records the process ID +
    OutputSed sed-commanddhX
    Sed command for filtering response content
    PassEnv env-variable [env-variable] +...svdhB
    Passes environment variables from the shell
    PidFile filename logs/httpd.pid sM
    File where the server records the process ID of the daemon
    PrivilegesMode FAST|SECURE|SELECTIVE FAST svdX
    Trade off processing speed and efficiency vs security against +
    PrivilegesMode FAST|SECURE|SELECTIVE FAST svdX
    Trade off processing speed and efficiency vs security against malicious privileges-aware code.
    Protocol protocolsvC
    Protocol for a listening socket
    ProtocolEcho On|Off Off svX
    Turn the echo server on or off
    Protocols protocol ... http/1.1 svC
    Protocols available for a server/virtual host
    ProtocolsHonorOrder On|Off On svC
    Determines if order of Protocols determines precedence during negotiation
    <Proxy wildcard-url> ...</Proxy>svE
    Container for directives applied to proxied resources
    ProxyAddHeaders Off|On On svdE
    Add proxy information in X-Forwarded-* headers
    ProxyBadHeader IsError|Ignore|StartBody IsError svE
    Determines how to handle bad header lines in a +
    Protocol protocolsvC
    Protocol for a listening socket
    ProtocolEcho On|Off Off svX
    Turn the echo server on or off
    Protocols protocol ... http/1.1 svC
    Protocols available for a server/virtual host
    ProtocolsHonorOrder On|Off On svC
    Determines if order of Protocols determines precedence during negotiation
    <Proxy wildcard-url> ...</Proxy>svE
    Container for directives applied to proxied resources
    ProxyAddHeaders Off|On On svdE
    Add proxy information in X-Forwarded-* headers
    ProxyBadHeader IsError|Ignore|StartBody IsError svE
    Determines how to handle bad header lines in a response
    ProxyBlock *|word|host|domain -[word|host|domain] ...svE
    Words, hosts, or domains that are banned from being +
    ProxyBlock *|word|host|domain +[word|host|domain] ...svE
    Words, hosts, or domains that are banned from being proxied
    ProxyDomain DomainsvE
    Default domain name for proxied requests
    ProxyErrorOverride On|Off Off svdE
    Override error pages for proxied content
    ProxyExpressDBMFile <pathname>svE
    Pathname to DBM file.
    ProxyExpressDBMFile <type>svE
    DBM type of file.
    ProxyExpressEnable [on|off]svE
    Enable the module functionality.
    ProxyFCGIBackendType FPM|GENERIC FPM svdhE
    Specify the type of backend FastCGI application
    ProxyFCGISetEnvIf conditional-expression +
    ProxyDomain DomainsvE
    Default domain name for proxied requests
    ProxyErrorOverride On|Off Off svdE
    Override error pages for proxied content
    ProxyExpressDBMFile <pathname>svE
    Pathname to DBM file.
    ProxyExpressDBMFile <type>svE
    DBM type of file.
    ProxyExpressEnable [on|off]svE
    Enable the module functionality.
    ProxyFCGIBackendType FPM|GENERIC FPM svdhE
    Specify the type of backend FastCGI application
    ProxyFCGISetEnvIf conditional-expression [!]environment-variable-name - [value-expression]svdhE
    Allow variables sent to FastCGI servers to be fixed up
    ProxyFtpDirCharset character set ISO-8859-1 svdE
    Define the character set for proxied FTP listings
    ProxyFtpEscapeWildcards [on|off]svdE
    Whether wildcards in requested filenames are escaped when sent to the FTP server
    ProxyFtpListOnWildcard [on|off]svdE
    Whether wildcards in requested filenames trigger a file listing
    ProxyHCExpr name {ap_expr expression}svE
    Creates a named condition expression to use to determine health of the backend based on its response.
    ProxyHCTemplate name parameter=setting <...>svE
    Creates a named template for setting various health check parameters
    ProxyHCTPsize <size>svE
    Sets the size of the threadpool used for the health check workers.
    ProxyHTMLBufSize bytessvdB
    Sets the buffer size increment for buffering inline scripts and + [value-expression]svdhE
    Allow variables sent to FastCGI servers to be fixed up
    ProxyFtpDirCharset character set ISO-8859-1 svdE
    Define the character set for proxied FTP listings
    ProxyFtpEscapeWildcards [on|off]svdE
    Whether wildcards in requested filenames are escaped when sent to the FTP server
    ProxyFtpListOnWildcard [on|off]svdE
    Whether wildcards in requested filenames trigger a file listing
    ProxyHCExpr name {ap_expr expression}svE
    Creates a named condition expression to use to determine health of the backend based on its response.
    ProxyHCTemplate name parameter=setting <...>svE
    Creates a named template for setting various health check parameters
    ProxyHCTPsize <size>svE
    Sets the size of the threadpool used for the health check workers.
    ProxyHTMLBufSize bytessvdB
    Sets the buffer size increment for buffering inline scripts and stylesheets.
    ProxyHTMLCharsetOut Charset | *svdB
    Specify a charset for mod_proxy_html output.
    ProxyHTMLDocType HTML|XHTML [Legacy]
    OR -
    ProxyHTMLDocType fpi [SGML|XML]    		svdB
    Sets an HTML or XHTML document type declaration.
    ProxyHTMLEnable On|Off Off svdB
    Turns the proxy_html filter on or off.
    ProxyHTMLEvents attribute [attribute ...]svdB
    Specify attributes to treat as scripting events.
    ProxyHTMLExtended On|Off Off svdB
    Determines whether to fix links in inline scripts, stylesheets, +
    ProxyHTMLCharsetOut Charset | *svdB
    Specify a charset for mod_proxy_html output.
    ProxyHTMLDocType HTML|XHTML [Legacy]
    OR +
    ProxyHTMLDocType fpi [SGML|XML]    		svdB
    Sets an HTML or XHTML document type declaration.
    ProxyHTMLEnable On|Off Off svdB
    Turns the proxy_html filter on or off.
    ProxyHTMLEvents attribute [attribute ...]svdB
    Specify attributes to treat as scripting events.
    ProxyHTMLExtended On|Off Off svdB
    Determines whether to fix links in inline scripts, stylesheets, and scripting events.
    ProxyHTMLFixups [lowercase] [dospath] [reset]svdB
    Fixes for simple HTML errors.
    ProxyHTMLInterp On|Off Off svdB
    Enables per-request interpolation of +
    ProxyHTMLFixups [lowercase] [dospath] [reset]svdB
    Fixes for simple HTML errors.
    ProxyHTMLInterp On|Off Off svdB
    Enables per-request interpolation of ProxyHTMLURLMap rules.
    ProxyHTMLLinks element attribute [attribute2 ...]svdB
    Specify HTML elements that have URL attributes to be rewritten.
    ProxyHTMLMeta On|Off Off svdB
    Turns on or off extra pre-parsing of metadata in HTML +
    ProxyHTMLLinks element attribute [attribute2 ...]svdB
    Specify HTML elements that have URL attributes to be rewritten.
    ProxyHTMLMeta On|Off Off svdB
    Turns on or off extra pre-parsing of metadata in HTML <head> sections.
    ProxyHTMLStripComments On|Off Off svdB
    Determines whether to strip HTML comments.
    ProxyHTMLURLMap from-pattern to-pattern [flags] [cond]svdB
    Defines a rule to rewrite HTML links
    ProxyIOBufferSize bytes 8192 svE
    Determine size of internal data throughput buffer
    <ProxyMatch regex> ...</ProxyMatch>svE
    Container for directives applied to regular-expression-matched +
    ProxyHTMLStripComments On|Off Off svdB
    Determines whether to strip HTML comments.
    ProxyHTMLURLMap from-pattern to-pattern [flags] [cond]svdB
    Defines a rule to rewrite HTML links
    ProxyIOBufferSize bytes 8192 svE
    Determine size of internal data throughput buffer
    <ProxyMatch regex> ...</ProxyMatch>svE
    Container for directives applied to regular-expression-matched proxied resources
    ProxyMaxForwards number -1 svE
    Maximium number of proxies that a request can be forwarded +
    ProxyMaxForwards number -1 svE
    Maximium number of proxies that a request can be forwarded through
    ProxyPass [path] !|url [key=value - [key=value ...]] [nocanon] [interpolate] [noquery]svdE
    Maps remote servers into the local server URL-space
    ProxyPassInherit On|Off On svE
    Inherit ProxyPass directives defined from the main server
    ProxyPassInterpolateEnv On|Off Off svdE
    Enable Environment Variable interpolation in Reverse Proxy configurations
    ProxyPassMatch [regex] !|url [key=value - [key=value ...]]svdE
    Maps remote servers into the local server URL-space using regular expressions
    ProxyPassReverse [path] url -[interpolate]svdE
    Adjusts the URL in HTTP response headers sent from a reverse +
    ProxyPass [path] !|url [key=value + [key=value ...]] [nocanon] [interpolate] [noquery]svdE
    Maps remote servers into the local server URL-space
    ProxyPassInherit On|Off On svE
    Inherit ProxyPass directives defined from the main server
    ProxyPassInterpolateEnv On|Off Off svdE
    Enable Environment Variable interpolation in Reverse Proxy configurations
    ProxyPassMatch [regex] !|url [key=value + [key=value ...]]svdE
    Maps remote servers into the local server URL-space using regular expressions
    ProxyPassReverse [path] url +[interpolate]svdE
    Adjusts the URL in HTTP response headers sent from a reverse proxied server
    ProxyPassReverseCookieDomain internal-domain -public-domain [interpolate]svdE
    Adjusts the Domain string in Set-Cookie headers from a reverse- +
    ProxyPassReverseCookieDomain internal-domain +public-domain [interpolate]svdE
    Adjusts the Domain string in Set-Cookie headers from a reverse- proxied server
    ProxyPassReverseCookiePath internal-path -public-path [interpolate]svdE
    Adjusts the Path string in Set-Cookie headers from a reverse- +
    ProxyPassReverseCookiePath internal-path +public-path [interpolate]svdE
    Adjusts the Path string in Set-Cookie headers from a reverse- proxied server
    ProxyPreserveHost On|Off Off svdE
    Use incoming Host HTTP request header for proxy +
    ProxyPreserveHost On|Off Off svdE
    Use incoming Host HTTP request header for proxy request
    ProxyReceiveBufferSize bytes 0 svE
    Network buffer size for proxied HTTP and FTP +
    ProxyReceiveBufferSize bytes 0 svE
    Network buffer size for proxied HTTP and FTP connections
    ProxyRemote match remote-serversvE
    Remote proxy used to handle certain requests
    ProxyRemoteMatch regex remote-serversvE
    Remote proxy used to handle requests matched by regular +
    ProxyRemote match remote-serversvE
    Remote proxy used to handle certain requests
    ProxyRemoteMatch regex remote-serversvE
    Remote proxy used to handle requests matched by regular expressions
    ProxyRequests On|Off Off svE
    Enables forward (standard) proxy requests
    ProxySCGIInternalRedirect On|Off|Headername On svdE
    Enable or disable internal redirect responses from the +
    ProxyRequests On|Off Off svE
    Enables forward (standard) proxy requests
    ProxySCGIInternalRedirect On|Off|Headername On svdE
    Enable or disable internal redirect responses from the backend
    ProxySCGISendfile On|Off|Headername Off svdE
    Enable evaluation of X-Sendfile pseudo response +
    ProxySCGISendfile On|Off|Headername Off svdE
    Enable evaluation of X-Sendfile pseudo response header
    ProxySet url key=value [key=value ...]dE
    Set various Proxy balancer or member parameters
    ProxySourceAddress addresssvE
    Set local IP address for outgoing proxy connections
    ProxyStatus Off|On|Full Off svE
    Show Proxy LoadBalancer status in mod_status
    ProxyTimeout secondssvE
    Network timeout for proxied requests
    ProxyVia On|Off|Full|Block Off svE
    Information provided in the Via HTTP response +
    ProxySet url key=value [key=value ...]dE
    Set various Proxy balancer or member parameters
    ProxySourceAddress addresssvE
    Set local IP address for outgoing proxy connections
    ProxyStatus Off|On|Full Off svE
    Show Proxy LoadBalancer status in mod_status
    ProxyTimeout secondssvE
    Network timeout for proxied requests
    ProxyVia On|Off|Full|Block Off svE
    Information provided in the Via HTTP response header for proxied requests
    QualifyRedirectURL ON|OFF OFF svdC
    Controls whether the REDIRECT_URL environment variable is +
    QualifyRedirectURL ON|OFF OFF svdC
    Controls whether the REDIRECT_URL environment variable is fully qualified
    ReadmeName filenamesvdhB
    Name of the file that will be inserted at the end +
    ReadmeName filenamesvdhB
    Name of the file that will be inserted at the end of the index listing
    ReceiveBufferSize bytes 0 sM
    TCP receive buffer size
    Redirect [status] [URL-path] -URLsvdhB
    Sends an external redirect asking the client to fetch +
    ReceiveBufferSize bytes 0 sM
    TCP receive buffer size
    Redirect [status] [URL-path] +URLsvdhB
    Sends an external redirect asking the client to fetch a different URL
    RedirectMatch [status] regex -URLsvdhB
    Sends an external redirect based on a regular expression match +
    RedirectMatch [status] regex +URLsvdhB
    Sends an external redirect based on a regular expression match of the current URL
    RedirectPermanent URL-path URLsvdhB
    Sends an external permanent redirect asking the client to fetch +
    RedirectPermanent URL-path URLsvdhB
    Sends an external permanent redirect asking the client to fetch a different URL
    RedirectTemp URL-path URLsvdhB
    Sends an external temporary redirect asking the client to fetch +
    RedirectTemp URL-path URLsvdhB
    Sends an external temporary redirect asking the client to fetch a different URL
    ReflectorHeader inputheader [outputheader]svdhB
    Reflect an input header to the output headers
    RegisterHttpMethod method [method [...]]sC
    Register non-standard HTTP methods
    RemoteIPHeader header-fieldsvB
    Declare the header field which should be parsed for useragent IP addresses
    RemoteIPInternalProxy proxy-ip|proxy-ip/subnet|hostname ...svB
    Declare client intranet IP addresses trusted to present the RemoteIPHeader value
    RemoteIPInternalProxyList filenamesvB
    Declare client intranet IP addresses trusted to present the RemoteIPHeader value
    RemoteIPProxiesHeader HeaderFieldNamesvB
    Declare the header field which will record all intermediate IP addresses
    RemoteIPTrustedProxy proxy-ip|proxy-ip/subnet|hostname ...svB
    Declare client intranet IP addresses trusted to present the RemoteIPHeader value
    RemoteIPTrustedProxyList filenamesvB
    Declare client intranet IP addresses trusted to present the RemoteIPHeader value
    RemoveCharset extension [extension] -...vdhB
    Removes any character set associations for a set of file +
    ReflectorHeader inputheader [outputheader]svdhB
    Reflect an input header to the output headers
    RegisterHttpMethod method [method [...]]sC
    Register non-standard HTTP methods
    RemoteIPHeader header-fieldsvB
    Declare the header field which should be parsed for useragent IP addresses
    RemoteIPInternalProxy proxy-ip|proxy-ip/subnet|hostname ...svB
    Declare client intranet IP addresses trusted to present the RemoteIPHeader value
    RemoteIPInternalProxyList filenamesvB
    Declare client intranet IP addresses trusted to present the RemoteIPHeader value
    RemoteIPProxiesHeader HeaderFieldNamesvB
    Declare the header field which will record all intermediate IP addresses
    RemoteIPTrustedProxy proxy-ip|proxy-ip/subnet|hostname ...svB
    Declare client intranet IP addresses trusted to present the RemoteIPHeader value
    RemoteIPTrustedProxyList filenamesvB
    Declare client intranet IP addresses trusted to present the RemoteIPHeader value
    RemoveCharset extension [extension] +...vdhB
    Removes any character set associations for a set of file extensions
    RemoveEncoding extension [extension] -...vdhB
    Removes any content encoding associations for a set of file +
    RemoveEncoding extension [extension] +...vdhB
    Removes any content encoding associations for a set of file extensions
    RemoveHandler extension [extension] -...vdhB
    Removes any handler associations for a set of file +
    RemoveHandler extension [extension] +...vdhB
    Removes any handler associations for a set of file extensions
    RemoveInputFilter extension [extension] -...vdhB
    Removes any input filter associations for a set of file +
    RemoveInputFilter extension [extension] +...vdhB
    Removes any input filter associations for a set of file extensions
    RemoveLanguage extension [extension] -...vdhB
    Removes any language associations for a set of file +
    RemoveLanguage extension [extension] +...vdhB
    Removes any language associations for a set of file extensions
    RemoveOutputFilter extension [extension] -...vdhB
    Removes any output filter associations for a set of file +
    RemoveOutputFilter extension [extension] +...vdhB
    Removes any output filter associations for a set of file extensions
    RemoveType extension [extension] -...vdhB
    Removes any content type associations for a set of file +
    RemoveType extension [extension] +...vdhB
    Removes any content type associations for a set of file extensions
    RequestHeader add|append|edit|edit*|merge|set|setifempty|unset +
    RequestHeader add|append|edit|edit*|merge|set|setifempty|unset header [[expr=]value [replacement] [early|env=[!]varname|expr=expression]] -svdhE
    Configure HTTP request headers
    RequestReadTimeout +svdhE
    Configure HTTP request headers
    RequestReadTimeout [header=timeout[-maxtimeout][,MinRate=rate] [body=timeout[-maxtimeout][,MinRate=rate] -svE
    Set timeout values for receiving request headers and body from client. +svE
    Set timeout values for receiving request headers and body from client.
    Require [not] entity-name - [entity-name] ...dhB
    Tests whether an authenticated user is authorized by +
    Require [not] entity-name + [entity-name] ...dhB
    Tests whether an authenticated user is authorized by an authorization provider.
    <RequireAll> ... </RequireAll>dhB
    Enclose a group of authorization directives of which none +
    <RequireAll> ... </RequireAll>dhB
    Enclose a group of authorization directives of which none must fail and at least one must succeed for the enclosing directive to succeed.
    <RequireAny> ... </RequireAny>dhB
    Enclose a group of authorization directives of which one +
    <RequireAny> ... </RequireAny>dhB
    Enclose a group of authorization directives of which one must succeed for the enclosing directive to succeed.
    <RequireNone> ... </RequireNone>dhB
    Enclose a group of authorization directives of which none +
    <RequireNone> ... </RequireNone>dhB
    Enclose a group of authorization directives of which none must succeed for the enclosing directive to not fail.
    RewriteBase URL-pathdhE
    Sets the base URL for per-directory rewrites
    RewriteCond - TestString CondPattern [flags]svdhE
    Defines a condition under which rewriting will take place +
    RewriteBase URL-pathdhE
    Sets the base URL for per-directory rewrites
    RewriteCond + TestString CondPattern [flags]svdhE
    Defines a condition under which rewriting will take place
    RewriteEngine on|off off svdhE
    Enables or disables runtime rewriting engine
    RewriteMap MapName MapType:MapSource -svE
    Defines a mapping function for key-lookup
    RewriteOptions OptionssvdhE
    Sets some special options for the rewrite engine
    RewriteRule - Pattern Substitution [flags]svdhE
    Defines rules for the rewriting engine
    RLimitCPU seconds|max [seconds|max]svdhC
    Limits the CPU consumption of processes launched +
    RewriteEngine on|off off svdhE
    Enables or disables runtime rewriting engine
    RewriteMap MapName MapType:MapSource +svE
    Defines a mapping function for key-lookup
    RewriteOptions OptionssvdhE
    Sets some special options for the rewrite engine
    RewriteRule + Pattern Substitution [flags]svdhE
    Defines rules for the rewriting engine
    RLimitCPU seconds|max [seconds|max]svdhC
    Limits the CPU consumption of processes launched by Apache httpd children
    RLimitMEM bytes|max [bytes|max]svdhC
    Limits the memory consumption of processes launched +
    RLimitMEM bytes|max [bytes|max]svdhC
    Limits the memory consumption of processes launched by Apache httpd children
    RLimitNPROC number|max [number|max]svdhC
    Limits the number of processes that can be launched by +
    RLimitNPROC number|max [number|max]svdhC
    Limits the number of processes that can be launched by processes launched by Apache httpd children
    Satisfy Any|All All dhE
    Interaction between host-level access control and +
    Satisfy Any|All All dhE
    Interaction between host-level access control and user authentication
    ScoreBoardFile file-path logs/apache_runtime +sM
    Location of the file used to store coordination data for +
    ScoreBoardFile file-path logs/apache_runtime +sM
    Location of the file used to store coordination data for the child processes
    Script method cgi-scriptsvdB
    Activates a CGI script for a particular request +
    Script method cgi-scriptsvdB
    Activates a CGI script for a particular request method.
    ScriptAlias [URL-path] -file-path|directory-pathsvdB
    Maps a URL to a filesystem location and designates the +
    ScriptAlias [URL-path] +file-path|directory-pathsvdB
    Maps a URL to a filesystem location and designates the target as a CGI script
    ScriptAliasMatch regex -file-path|directory-pathsvB
    Maps a URL to a filesystem location using a regular expression +
    ScriptAliasMatch regex +file-path|directory-pathsvB
    Maps a URL to a filesystem location using a regular expression and designates the target as a CGI script
    ScriptInterpreterSource Registry|Registry-Strict|Script Script svdhC
    Technique for locating the interpreter for CGI +
    ScriptInterpreterSource Registry|Registry-Strict|Script Script svdhC
    Technique for locating the interpreter for CGI scripts
    ScriptLog file-pathsvB
    Location of the CGI script error logfile
    ScriptLogBuffer bytes 1024 svB
    Maximum amount of PUT or POST requests that will be recorded +
    ScriptLog file-pathsvB
    Location of the CGI script error logfile
    ScriptLogBuffer bytes 1024 svB
    Maximum amount of PUT or POST requests that will be recorded in the scriptlog
    ScriptLogLength bytes 10385760 svB
    Size limit of the CGI script logfile
    ScriptSock file-path cgisock sB
    The filename prefix of the socket to use for communication with +
    ScriptLogLength bytes 10385760 svB
    Size limit of the CGI script logfile
    ScriptSock file-path cgisock sB
    The filename prefix of the socket to use for communication with the cgi daemon
    SecureListen [IP-address:]portnumber -Certificate-Name [MUTUAL]sB
    Enables SSL encryption for the specified port
    SeeRequestTail On|Off Off sC
    Determine if mod_status displays the first 63 characters +
    SecureListen [IP-address:]portnumber +Certificate-Name [MUTUAL]sB
    Enables SSL encryption for the specified port
    SeeRequestTail On|Off Off sC
    Determine if mod_status displays the first 63 characters of a request or the last 63, assuming the request itself is greater than 63 chars.
    SendBufferSize bytes 0 sM
    TCP buffer size
    ServerAdmin email-address|URLsvC
    Email address that the server includes in error +
    SendBufferSize bytes 0 sM
    TCP buffer size
    ServerAdmin email-address|URLsvC
    Email address that the server includes in error messages sent to the client
    ServerAlias hostname [hostname] ...vC
    Alternate names for a host used when matching requests +
    ServerAlias hostname [hostname] ...vC
    Alternate names for a host used when matching requests to name-virtual hosts
    ServerLimit numbersM
    Upper limit on configurable number of processes
    ServerName [scheme://]fully-qualified-domain-name[:port]svC
    Hostname and port that the server uses to identify +
    ServerLimit numbersM
    Upper limit on configurable number of processes
    ServerName [scheme://]fully-qualified-domain-name[:port]svC
    Hostname and port that the server uses to identify itself
    ServerPath URL-pathvC
    Legacy URL pathname for a name-based virtual host that +
    ServerPath URL-pathvC
    Legacy URL pathname for a name-based virtual host that is accessed by an incompatible browser
    ServerRoot directory-path /usr/local/apache sC
    Base directory for the server installation
    ServerSignature On|Off|EMail Off svdhC
    Configures the footer on server-generated documents
    ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full Full sC
    Configures the Server HTTP response +
    ServerRoot directory-path /usr/local/apache sC
    Base directory for the server installation
    ServerSignature On|Off|EMail Off svdhC
    Configures the footer on server-generated documents
    ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full Full sC
    Configures the Server HTTP response header
    Session On|Off Off svdhE
    Enables a session for the current directory or location
    SessionCookieName name attributessvdhE
    Name and attributes for the RFC2109 cookie storing the session
    SessionCookieName2 name attributessvdhE
    Name and attributes for the RFC2965 cookie storing the session
    SessionCookieRemove On|Off Off svdhE
    Control for whether session cookies should be removed from incoming HTTP headers
    SessionCryptoCipher namesvdhX
    The crypto cipher to be used to encrypt the session
    SessionCryptoDriver name [param[=value]]sX
    The crypto driver to be used to encrypt the session
    SessionCryptoPassphrase secret [ secret ... ] svdhX
    The key used to encrypt the session
    SessionCryptoPassphraseFile filenamesvdX
    File containing keys used to encrypt the session
    SessionDBDCookieName name attributessvdhE
    Name and attributes for the RFC2109 cookie storing the session ID
    SessionDBDCookieName2 name attributessvdhE
    Name and attributes for the RFC2965 cookie storing the session ID
    SessionDBDCookieRemove On|Off On svdhE
    Control for whether session ID cookies should be removed from incoming HTTP headers
    SessionDBDDeleteLabel label deletesession svdhE
    The SQL query to use to remove sessions from the database
    SessionDBDInsertLabel label insertsession svdhE
    The SQL query to use to insert sessions into the database
    SessionDBDPerUser On|Off Off svdhE
    Enable a per user session
    SessionDBDSelectLabel label selectsession svdhE
    The SQL query to use to select sessions from the database
    SessionDBDUpdateLabel label updatesession svdhE
    The SQL query to use to update existing sessions in the database
    SessionEnv On|Off Off svdhE
    Control whether the contents of the session are written to the +
    Session On|Off Off svdhE
    Enables a session for the current directory or location
    SessionCookieName name attributessvdhE
    Name and attributes for the RFC2109 cookie storing the session
    SessionCookieName2 name attributessvdhE
    Name and attributes for the RFC2965 cookie storing the session
    SessionCookieRemove On|Off Off svdhE
    Control for whether session cookies should be removed from incoming HTTP headers
    SessionCryptoCipher namesvdhX
    The crypto cipher to be used to encrypt the session
    SessionCryptoDriver name [param[=value]]sX
    The crypto driver to be used to encrypt the session
    SessionCryptoPassphrase secret [ secret ... ] svdhX
    The key used to encrypt the session
    SessionCryptoPassphraseFile filenamesvdX
    File containing keys used to encrypt the session
    SessionDBDCookieName name attributessvdhE
    Name and attributes for the RFC2109 cookie storing the session ID
    SessionDBDCookieName2 name attributessvdhE
    Name and attributes for the RFC2965 cookie storing the session ID
    SessionDBDCookieRemove On|Off On svdhE
    Control for whether session ID cookies should be removed from incoming HTTP headers
    SessionDBDDeleteLabel label deletesession svdhE
    The SQL query to use to remove sessions from the database
    SessionDBDInsertLabel label insertsession svdhE
    The SQL query to use to insert sessions into the database
    SessionDBDPerUser On|Off Off svdhE
    Enable a per user session
    SessionDBDSelectLabel label selectsession svdhE
    The SQL query to use to select sessions from the database
    SessionDBDUpdateLabel label updatesession svdhE
    The SQL query to use to update existing sessions in the database
    SessionEnv On|Off Off svdhE
    Control whether the contents of the session are written to the HTTP_SESSION environment variable
    SessionExclude pathsvdhE
    Define URL prefixes for which a session is ignored
    SessionHeader headersvdhE
    Import session updates from a given HTTP response header
    SessionInclude pathsvdhE
    Define URL prefixes for which a session is valid
    SessionMaxAge maxage 0 svdhE
    Define a maximum age in seconds for a session
    SetEnv env-variable [value]svdhB
    Sets environment variables
    SetEnvIf attribute +
    SessionExclude pathsvdhE
    Define URL prefixes for which a session is ignored
    SessionHeader headersvdhE
    Import session updates from a given HTTP response header
    SessionInclude pathsvdhE
    Define URL prefixes for which a session is valid
    SessionMaxAge maxage 0 svdhE
    Define a maximum age in seconds for a session
    SetEnv env-variable [value]svdhB
    Sets environment variables
    SetEnvIf attribute regex [!]env-variable[=value] - [[!]env-variable[=value]] ...svdhB
    Sets environment variables based on attributes of the request + [[!]env-variable[=value]] ...svdhB
    Sets environment variables based on attributes of the request
    SetEnvIfExpr expr +
    SetEnvIfExpr expr [!]env-variable[=value] - [[!]env-variable[=value]] ...svdhB
    Sets environment variables based on an ap_expr expression
    SetEnvIfNoCase attribute regex + [[!]env-variable[=value]] ...svdhB
    Sets environment variables based on an ap_expr expression
    SetEnvIfNoCase attribute regex [!]env-variable[=value] - [[!]env-variable[=value]] ...svdhB
    Sets environment variables based on attributes of the request + [[!]env-variable[=value]] ...svdhB
    Sets environment variables based on attributes of the request without respect to case
    SetHandler handler-name|NonesvdhC
    Forces all matching files to be processed by a +
    SetHandler handler-name|NonesvdhC
    Forces all matching files to be processed by a handler
    SetInputFilter filter[;filter...]svdhC
    Sets the filters that will process client requests and POST +
    SetInputFilter filter[;filter...]svdhC
    Sets the filters that will process client requests and POST input
    SetOutputFilter filter[;filter...]svdhC
    Sets the filters that will process responses from the +
    SetOutputFilter filter[;filter...]svdhC
    Sets the filters that will process responses from the server
    SSIEndTag tag "-->" svB
    String that ends an include element
    SSIErrorMsg message "[an error occurred +svdhB
    Error message displayed when there is an SSI +
    SSIEndTag tag "-->" svB
    String that ends an include element
    SSIErrorMsg message "[an error occurred +svdhB
    Error message displayed when there is an SSI error
    SSIETag on|off off dhB
    Controls whether ETags are generated by the server.
    SSILastModified on|off off dhB
    Controls whether Last-Modified headers are generated by the +
    SSIETag on|off off dhB
    Controls whether ETags are generated by the server.
    SSILastModified on|off off dhB
    Controls whether Last-Modified headers are generated by the server.
    SSILegacyExprParser on|off off dhB
    Enable compatibility mode for conditional expressions.
    SSIStartTag tag "<!--#" svB
    String that starts an include element
    SSITimeFormat formatstring "%A, %d-%b-%Y %H:%M +svdhB
    Configures the format in which date strings are +
    SSILegacyExprParser on|off off dhB
    Enable compatibility mode for conditional expressions.
    SSIStartTag tag "<!--#" svB
    String that starts an include element
    SSITimeFormat formatstring "%A, %d-%b-%Y %H:%M +svdhB
    Configures the format in which date strings are displayed
    SSIUndefinedEcho string "(none)" svdhB
    String displayed when an unset variable is echoed
    SSLCACertificateFile file-pathsvE
    File of concatenated PEM-encoded CA Certificates +
    SSIUndefinedEcho string "(none)" svdhB
    String displayed when an unset variable is echoed
    SSLCACertificateFile file-pathsvE
    File of concatenated PEM-encoded CA Certificates for Client Auth
    SSLCACertificatePath directory-pathsvE
    Directory of PEM-encoded CA Certificates for +
    SSLCACertificatePath directory-pathsvE
    Directory of PEM-encoded CA Certificates for Client Auth
    SSLCADNRequestFile file-pathsvE
    File of concatenated PEM-encoded CA Certificates +
    SSLCADNRequestFile file-pathsvE
    File of concatenated PEM-encoded CA Certificates for defining acceptable CA names
    SSLCADNRequestPath directory-pathsvE
    Directory of PEM-encoded CA Certificates for +
    SSLCADNRequestPath directory-pathsvE
    Directory of PEM-encoded CA Certificates for defining acceptable CA names
    SSLCARevocationCheck chain|leaf|none flags none svE
    Enable CRL-based revocation checking
    SSLCARevocationFile file-pathsvE
    File of concatenated PEM-encoded CA CRLs for +
    SSLCARevocationCheck chain|leaf|none flags none svE
    Enable CRL-based revocation checking
    SSLCARevocationFile file-pathsvE
    File of concatenated PEM-encoded CA CRLs for Client Auth
    SSLCARevocationPath directory-pathsvE
    Directory of PEM-encoded CA CRLs for +
    SSLCARevocationPath directory-pathsvE
    Directory of PEM-encoded CA CRLs for Client Auth
    SSLCertificateChainFile file-pathsvE
    File of PEM-encoded Server CA Certificates
    SSLCertificateFile file-pathsvE
    Server PEM-encoded X.509 certificate data file
    SSLCertificateKeyFile file-pathsvE
    Server PEM-encoded private key file
    SSLCipherSuite cipher-spec DEFAULT (depends on +svdhE
    Cipher Suite available for negotiation in SSL +
    SSLCertificateChainFile file-pathsvE
    File of PEM-encoded Server CA Certificates
    SSLCertificateFile file-pathsvE
    Server PEM-encoded X.509 certificate data file
    SSLCertificateKeyFile file-pathsvE
    Server PEM-encoded private key file
    SSLCipherSuite cipher-spec DEFAULT (depends on +svdhE
    Cipher Suite available for negotiation in SSL handshake
    SSLCompression on|off off svE
    Enable compression on the SSL level
    SSLCryptoDevice engine builtin sE
    Enable use of a cryptographic hardware accelerator
    SSLEngine on|off|optional off svE
    SSL Engine Operation Switch
    SSLFIPS on|off off sE
    SSL FIPS mode Switch
    SSLHonorCipherOrder on|off off svE
    Option to prefer the server's cipher preference order
    SSLInsecureRenegotiation on|off off svE
    Option to enable support for insecure renegotiation
    SSLOCSDefaultResponder urisvE
    Set the default responder URI for OCSP validation
    SSLOCSPEnable on|off off svE
    Enable OCSP validation of the client certificate chain
    SSLCompression on|off off svE
    Enable compression on the SSL level
    SSLCryptoDevice engine builtin sE
    Enable use of a cryptographic hardware accelerator
    SSLEngine on|off|optional off svE
    SSL Engine Operation Switch
    SSLFIPS on|off off sE
    SSL FIPS mode Switch
    SSLHonorCipherOrder on|off off svE
    Option to prefer the server's cipher preference order
    SSLInsecureRenegotiation on|off off svE
    Option to enable support for insecure renegotiation
    SSLOCSDefaultResponder urisvE
    Set the default responder URI for OCSP validation
    SSLOCSPEnable on|off off svE
    Enable OCSP validation of the client certificate chain
    SSLOCSPNoverify On/Off Off svE
    skip the OCSP responder certificates verification
    SSLOCSPOverrideResponder on|off off svE
    Force use of the default responder URI for OCSP validation
    SSLOCSPProxyURL urlsvE
    Proxy URL to use for OCSP requests
    SSLOCSPResponderTimeout seconds 10 svE
    Timeout for OCSP queries
    SSLOCSPResponseMaxAge seconds -1 svE
    Maximum allowable age for OCSP responses
    SSLOCSPResponseTimeSkew seconds 300 svE
    Maximum allowable time skew for OCSP response validation
    SSLOCSPUseRequestNonce on|off on svE
    Use a nonce within OCSP queries
    SSLOpenSSLConfCmd command-name command-valuesvE
    Configure OpenSSL parameters through its SSL_CONF API
    SSLOptions [+|-]option ...svdhE
    Configure various SSL engine run-time options
    SSLPassPhraseDialog type builtin sE
    Type of pass phrase dialog for encrypted private +
    SSLOCSPResponderCertificateFile filesvE
    Set of trusted PEM encoded OCSP responder certificates
    SSLOCSPResponderTimeout seconds 10 svE
    Timeout for OCSP queries
    SSLOCSPResponseMaxAge seconds -1 svE
    Maximum allowable age for OCSP responses
    SSLOCSPResponseTimeSkew seconds 300 svE
    Maximum allowable time skew for OCSP response validation
    SSLOCSPUseRequestNonce on|off on svE
    Use a nonce within OCSP queries
    SSLOpenSSLConfCmd command-name command-valuesvE
    Configure OpenSSL parameters through its SSL_CONF API
    SSLOptions [+|-]option ...svdhE
    Configure various SSL engine run-time options
    SSLPassPhraseDialog type builtin sE
    Type of pass phrase dialog for encrypted private keys
    SSLProtocol [+|-]protocol ... all -SSLv3 (up to 2 +svE
    Configure usable SSL/TLS protocol versions
    SSLProxyCACertificateFile file-pathsvE
    File of concatenated PEM-encoded CA Certificates +
    SSLProtocol [+|-]protocol ... all -SSLv3 (up to 2 +svE
    Configure usable SSL/TLS protocol versions
    SSLProxyCACertificateFile file-pathsvE
    File of concatenated PEM-encoded CA Certificates for Remote Server Auth
    SSLProxyCACertificatePath directory-pathsvE
    Directory of PEM-encoded CA Certificates for +
    SSLProxyCACertificatePath directory-pathsvE
    Directory of PEM-encoded CA Certificates for Remote Server Auth
    SSLProxyCARevocationCheck chain|leaf|none none svE
    Enable CRL-based revocation checking for Remote Server Auth
    SSLProxyCARevocationFile file-pathsvE
    File of concatenated PEM-encoded CA CRLs for +
    SSLProxyCARevocationCheck chain|leaf|none none svE
    Enable CRL-based revocation checking for Remote Server Auth
    SSLProxyCARevocationFile file-pathsvE
    File of concatenated PEM-encoded CA CRLs for Remote Server Auth
    SSLProxyCARevocationPath directory-pathsvE
    Directory of PEM-encoded CA CRLs for +
    SSLProxyCARevocationPath directory-pathsvE
    Directory of PEM-encoded CA CRLs for Remote Server Auth
    SSLProxyCheckPeerCN on|off on svE
    Whether to check the remote server certificate's CN field +
    SSLProxyCheckPeerCN on|off on svE
    Whether to check the remote server certificate's CN field
    SSLProxyCheckPeerExpire on|off on svE
    Whether to check if remote server certificate is expired +
    SSLProxyCheckPeerExpire on|off on svE
    Whether to check if remote server certificate is expired
    SSLProxyCheckPeerName on|off on svE
    Configure host name checking for remote server certificates +
    SSLProxyCheckPeerName on|off on svE
    Configure host name checking for remote server certificates
    SSLProxyCipherSuite cipher-spec ALL:!ADH:RC4+RSA:+H +svdhE
    Cipher Suite available for negotiation in SSL +
    SSLProxyCipherSuite cipher-spec ALL:!ADH:RC4+RSA:+H +svdhE
    Cipher Suite available for negotiation in SSL proxy handshake
    SSLProxyEngine on|off off svE
    SSL Proxy Engine Operation Switch
    SSLProxyMachineCertificateChainFile filenamesE
    File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate
    SSLProxyMachineCertificateFile filenamesE
    File of concatenated PEM-encoded client certificates and keys to be used by the proxy
    SSLProxyMachineCertificatePath directorysE
    Directory of PEM-encoded client certificates and keys to be used by the proxy
    SSLProxyProtocol [+|-]protocol ... all -SSLv3 (up to 2 +svE
    Configure usable SSL protocol flavors for proxy usage
    SSLProxyVerify level none svE
    Type of remote server Certificate verification
    SSLProxyVerifyDepth number 1 svE
    Maximum depth of CA Certificates in Remote Server +
    SSLProxyEngine on|off off svE
    SSL Proxy Engine Operation Switch
    SSLProxyMachineCertificateChainFile filenamesE
    File of concatenated PEM-encoded CA certificates to be used by the proxy for choosing a certificate
    SSLProxyMachineCertificateFile filenamesE
    File of concatenated PEM-encoded client certificates and keys to be used by the proxy
    SSLProxyMachineCertificatePath directorysE
    Directory of PEM-encoded client certificates and keys to be used by the proxy
    SSLProxyProtocol [+|-]protocol ... all -SSLv3 (up to 2 +svE
    Configure usable SSL protocol flavors for proxy usage
    SSLProxyVerify level none svE
    Type of remote server Certificate verification
    SSLProxyVerifyDepth number 1 svE
    Maximum depth of CA Certificates in Remote Server Certificate verification
    SSLRandomSeed context source -[bytes]sE
    Pseudo Random Number Generator (PRNG) seeding +
    SSLRandomSeed context source +[bytes]sE
    Pseudo Random Number Generator (PRNG) seeding source
    SSLRenegBufferSize bytes 131072 dhE
    Set the size for the SSL renegotiation buffer
    SSLRequire expressiondhE
    Allow access only when an arbitrarily complex +
    SSLRenegBufferSize bytes 131072 dhE
    Set the size for the SSL renegotiation buffer
    SSLRequire expressiondhE
    Allow access only when an arbitrarily complex boolean expression is true
    SSLRequireSSLdhE
    Deny access when SSL is not used for the +
    SSLRequireSSLdhE
    Deny access when SSL is not used for the HTTP request
    SSLSessionCache type none sE
    Type of the global/inter-process SSL Session +
    SSLSessionCache type none sE
    Type of the global/inter-process SSL Session Cache
    SSLSessionCacheTimeout seconds 300 svE
    Number of seconds before an SSL session expires +
    SSLSessionCacheTimeout seconds 300 svE
    Number of seconds before an SSL session expires in the Session Cache
    SSLSessionTicketKeyFile file-pathsvE
    Persistent encryption/decryption key for TLS session tickets
    SSLSessionTickets on|off on svE
    Enable or disable use of TLS session tickets
    SSLSRPUnknownUserSeed secret-stringsvE
    SRP unknown user seed
    SSLSRPVerifierFile file-pathsvE
    Path to SRP verifier file
    SSLStaplingCache typesE
    Configures the OCSP stapling cache
    SSLStaplingErrorCacheTimeout seconds 600 svE
    Number of seconds before expiring invalid responses in the OCSP stapling cache
    SSLStaplingFakeTryLater on|off on svE
    Synthesize "tryLater" responses for failed OCSP stapling queries
    SSLStaplingForceURL urisvE
    Override the OCSP responder URI specified in the certificate's AIA extension
    SSLStaplingResponderTimeout seconds 10 svE
    Timeout for OCSP stapling queries
    SSLStaplingResponseMaxAge seconds -1 svE
    Maximum allowable age for OCSP stapling responses
    SSLStaplingResponseTimeSkew seconds 300 svE
    Maximum allowable time skew for OCSP stapling response validation
    SSLStaplingReturnResponderErrors on|off on svE
    Pass stapling related OCSP errors on to client
    SSLStaplingStandardCacheTimeout seconds 3600 svE
    Number of seconds before expiring responses in the OCSP stapling cache
    SSLStrictSNIVHostCheck on|off off svE
    Whether to allow non-SNI clients to access a name-based virtual +
    SSLSessionTicketKeyFile file-pathsvE
    Persistent encryption/decryption key for TLS session tickets
    SSLSessionTickets on|off on svE
    Enable or disable use of TLS session tickets
    SSLSRPUnknownUserSeed secret-stringsvE
    SRP unknown user seed
    SSLSRPVerifierFile file-pathsvE
    Path to SRP verifier file
    SSLStaplingCache typesE
    Configures the OCSP stapling cache
    SSLStaplingErrorCacheTimeout seconds 600 svE
    Number of seconds before expiring invalid responses in the OCSP stapling cache
    SSLStaplingFakeTryLater on|off on svE
    Synthesize "tryLater" responses for failed OCSP stapling queries
    SSLStaplingForceURL urisvE
    Override the OCSP responder URI specified in the certificate's AIA extension
    SSLStaplingResponderTimeout seconds 10 svE
    Timeout for OCSP stapling queries
    SSLStaplingResponseMaxAge seconds -1 svE
    Maximum allowable age for OCSP stapling responses
    SSLStaplingResponseTimeSkew seconds 300 svE
    Maximum allowable time skew for OCSP stapling response validation
    SSLStaplingReturnResponderErrors on|off on svE
    Pass stapling related OCSP errors on to client
    SSLStaplingStandardCacheTimeout seconds 3600 svE
    Number of seconds before expiring responses in the OCSP stapling cache
    SSLStrictSNIVHostCheck on|off off svE
    Whether to allow non-SNI clients to access a name-based virtual host.
    SSLUserName varnamesdhE
    Variable name to determine user name
    SSLUseStapling on|off off svE
    Enable stapling of OCSP responses in the TLS handshake
    SSLVerifyClient level none svdhE
    Type of Client Certificate verification
    SSLVerifyDepth number 1 svdhE
    Maximum depth of CA Certificates in Client +
    SSLUserName varnamesdhE
    Variable name to determine user name
    SSLUseStapling on|off off svE
    Enable stapling of OCSP responses in the TLS handshake
    SSLVerifyClient level none svdhE
    Type of Client Certificate verification
    SSLVerifyDepth number 1 svdhE
    Maximum depth of CA Certificates in Client Certificate verification
    StartServers numbersM
    Number of child server processes created at startup
    StartThreads numbersM
    Number of threads created on startup
    Substitute s/pattern/substitution/[infq]dhE
    Pattern to filter the response content
    SubstituteInheritBefore on|off off dhE
    Change the merge order of inherited patterns
    SubstituteMaxLineLength bytes(b|B|k|K|m|M|g|G) 1m dhE
    Set the maximum line size
    Suexec On|OffsB
    Enable or disable the suEXEC feature
    SuexecUserGroup User GroupsvE
    User and group for CGI programs to run as
    ThreadLimit numbersM
    Sets the upper limit on the configurable number of threads +
    StartServers numbersM
    Number of child server processes created at startup
    StartThreads numbersM
    Number of threads created on startup
    Substitute s/pattern/substitution/[infq]dhE
    Pattern to filter the response content
    SubstituteInheritBefore on|off off dhE
    Change the merge order of inherited patterns
    SubstituteMaxLineLength bytes(b|B|k|K|m|M|g|G) 1m dhE
    Set the maximum line size
    Suexec On|OffsB
    Enable or disable the suEXEC feature
    SuexecUserGroup User GroupsvE
    User and group for CGI programs to run as
    ThreadLimit numbersM
    Sets the upper limit on the configurable number of threads per child process
    ThreadsPerChild numbersM
    Number of threads created by each child process
    ThreadStackSize sizesM
    The size in bytes of the stack used by threads handling +
    ThreadsPerChild numbersM
    Number of threads created by each child process
    ThreadStackSize sizesM
    The size in bytes of the stack used by threads handling client connections
    TimeOut seconds 60 svC
    Amount of time the server will wait for +
    TimeOut seconds 60 svC
    Amount of time the server will wait for certain events before failing a request
    TraceEnable [on|off|extended] on sC
    Determines the behaviour on TRACE requests
    TransferLog file|pipesvB
    Specify location of a log file
    TypesConfig file-path conf/mime.types sB
    The location of the mime.types file
    UnDefine parameter-namesC
    Undefine the existence of a variable
    UndefMacro namesvdB
    Undefine a macro
    UnsetEnv env-variable [env-variable] -...svdhB
    Removes variables from the environment
    Use name [value1 ... valueN] -svdB
    Use a macro
    UseCanonicalName On|Off|DNS Off svdC
    Configures how the server determines its own name and +
    TraceEnable [on|off|extended] on sC
    Determines the behaviour on TRACE requests
    TransferLog file|pipesvB
    Specify location of a log file
    TypesConfig file-path conf/mime.types sB
    The location of the mime.types file
    UnDefine parameter-namesC
    Undefine the existence of a variable
    UndefMacro namesvdB
    Undefine a macro
    UnsetEnv env-variable [env-variable] +...svdhB
    Removes variables from the environment
    Use name [value1 ... valueN] +svdB
    Use a macro
    UseCanonicalName On|Off|DNS Off svdC
    Configures how the server determines its own name and port
    UseCanonicalPhysicalPort On|Off Off svdC
    Configures how the server determines its own name and +
    UseCanonicalPhysicalPort On|Off Off svdC
    Configures how the server determines its own name and port
    User unix-userid #-1 sB
    The userid under which the server will answer +
    User unix-userid #-1 sB
    The userid under which the server will answer requests
    UserDir directory-filename [directory-filename] ... -svB
    Location of the user-specific directories
    VHostCGIMode On|Off|Secure On vX
    Determines whether the virtualhost can run +
    UserDir directory-filename [directory-filename] ... +svB
    Location of the user-specific directories
    VHostCGIMode On|Off|Secure On vX
    Determines whether the virtualhost can run subprocesses, and the privileges available to subprocesses.
    VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ...vX
    Assign arbitrary privileges to subprocesses created +
    VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ...vX
    Assign arbitrary privileges to subprocesses created by a virtual host.
    VHostGroup unix-groupidvX
    Sets the Group ID under which a virtual host runs.
    VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ...vX
    Assign arbitrary privileges to a virtual host.
    VHostSecure On|Off On vX
    Determines whether the server runs with enhanced security +
    VHostGroup unix-groupidvX
    Sets the Group ID under which a virtual host runs.
    VHostPrivs [+-]?privilege-name [[+-]?privilege-name] ...vX
    Assign arbitrary privileges to a virtual host.
    VHostSecure On|Off On vX
    Determines whether the server runs with enhanced security for the virtualhost.
    VHostUser unix-useridvX
    Sets the User ID under which a virtual host runs.
    VirtualDocumentRoot interpolated-directory|none none svE
    Dynamically configure the location of the document root +
    VHostUser unix-useridvX
    Sets the User ID under which a virtual host runs.
    VirtualDocumentRoot interpolated-directory|none none svE
    Dynamically configure the location of the document root for a given virtual host
    VirtualDocumentRootIP interpolated-directory|none none svE
    Dynamically configure the location of the document root +
    VirtualDocumentRootIP interpolated-directory|none none svE
    Dynamically configure the location of the document root for a given virtual host
    <VirtualHost +
    <VirtualHost addr[:port] [addr[:port]] - ...> ... </VirtualHost>sC
    Contains directives that apply only to a specific + ...> ... </VirtualHost>sC
    Contains directives that apply only to a specific hostname or IP address
    VirtualScriptAlias interpolated-directory|none none svE
    Dynamically configure the location of the CGI directory for +
    VirtualScriptAlias interpolated-directory|none none svE
    Dynamically configure the location of the CGI directory for a given virtual host
    VirtualScriptAliasIP interpolated-directory|none none svE
    Dynamically configure the location of the CGI directory for +
    VirtualScriptAliasIP interpolated-directory|none none svE
    Dynamically configure the location of the CGI directory for a given virtual host
    WatchdogInterval number-of-seconds 1 sB
    Watchdog interval in seconds
    XBitHack on|off|full off svdhB
    Parse SSI directives in files with the execute bit +
    WatchdogInterval number-of-seconds 1 sB
    Watchdog interval in seconds
    XBitHack on|off|full off svdhB
    Parse SSI directives in files with the execute bit set
    xml2EncAlias charset alias [alias ...]sB
    Recognise Aliases for encoding values
    xml2EncDefault namesvdhB
    Sets a default encoding to assume when absolutely no information +
    xml2EncAlias charset alias [alias ...]sB
    Recognise Aliases for encoding values
    xml2EncDefault namesvdhB
    Sets a default encoding to assume when absolutely no information can be automatically detected
    xml2StartParse element [element ...]svdhB
    Advise the parser to skip leading junk.
    xml2StartParse element [element ...]svdhB
    Advise the parser to skip leading junk.

    Idiomas disponibles:  de  |  en  | - es  | - fr  | + es  | + fr  |  ja  |  ko  | - tr  | + tr  |  zh-cn 

    top

    Comentarios

    Notice:
    This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.