Diferencia entre revisiones de «Usuario:ManuelRomero/modulo APACHE/Directivas»

De WikiEducator
Saltar a: navegación, buscar
Línea 207: Línea 207:
  
 
<hr/>
 
<hr/>
−
<h4>DirectoryIndex</h4>
+
<font color=green>===DirectoryIndex===</font>
 +
DirectoryIndex disabled |fichero [fichero]...
 +
*Establece el nombre del fichero que apache servira cuando se le realice una solicitud al directorio raiz del servidor (especificado en '''''DocumentRoot''''')
 +
*En caso de no encontrarse ningún fichero Apache servira una lista de los fichero disponibles en ese directorio  (opción Indexes del directorio DocumentRoot)
 +
*Se puede especificar una lista separada por espacios de fichero y el servidor servirá el primer fichero que localice en el directorio
 +
DirectoryIndes index.html index.htm index.php
 
<hr/>
 
<hr/>
−
<h4>AccessFileName</h4>
+
 
 +
 
 +
<font color=green>===AccessFileName===</font>
 +
AccessFileName nombreFichero [nombreFichero] ...
 +
*Especifica el nombre del fichero en el que se especificarán las directiva de acceso para cada directorio. Esta es una alternativa a especificar de forma explícita dichos directivas en el fichero de configuración
 +
Valor por defecto: AccessFileName .htaccess
 
<hr/>
 
<hr/>
−
<h4>Files</h4>
+
<font color=green>===Files===</font>
 +
*Es una directiva para determinar accesos a ficheros.
 +
*Se pueden especificar expresiones regulares en cuyo caso usarempos '''''<FileMatch> o bien poniendo ~ despues de files
 +
<Files ~ "\.(gif|jpe?g|png)$">
 +
<FileMatch <"^\.ht>
 +
  Order allow,deny
 +
  Deny from all
 +
  Satisfy all
 +
</FileMatch>
 
<hr/>
 
<hr/>
−
<h4>UseCanonicalName</h4>
+
 
 +
<font color=green>===UseCanonicalName===</font>
 +
UseCanonicalName on
 +
*Indica a apache que cada vez que tengamos que contruir direcciones que le hagan referencia, lo haga con el nombre canónico  (Establecido en ServerName)  y el puerto y no use el hostname
 
<hr/>
 
<hr/>
−
<h4>TypesConfig</h4>
+
 
 +
 
 +
<font color=green>===TypesConfig===</font>
 +
Detalla la ubicación del fichero que contiene  la descripción de los tipos MIME. Este fichero mime.types suele estar en el directorio /conf
 +
TypesConfig /conf/mime.types
 
<hr/>
 
<hr/>
  
−
<h4>DefaultType</h4>
+
<font color=green>===DefaultType===</font>
 +
*Establece el tipo mime por defecto.
 +
*Este tipo será asignado a todos aquellos ficheros a los cuales no se les pueda asignar tipo según la descripción detallada en el fichero mime.types
 +
*A la hora de establecer este valor habría que tener en cuenta cuales son los tipos de ficheros más utilizados.
 +
*Ejemplo si la mayoría son fotografías y programas
 +
DefaultType application/octet-stream
 +
*Si la mayoría son html
 +
DefaultType text/html
 +
*Si la mayoría es fichero de texto
 +
DefaultType text/plain
 
<hr/>
 
<hr/>
−
<h4>HostNameLookups</h4>
+
 
 +
<font color=green>===HostNameLookups===</font>
 +
*Establece que se haga una consulta DNS por cada petición. No suele ser necesario y este uso sistemático relentiza el sistema.
 +
HostNameLookups off
 
<hr/>
 
<hr/>
 +
<font color=green>===ErrorLog===</font>
 +
*Establece la ubicación de los ficheros donde se almacenan los errores que se producan
 +
*Se puede ubicar en una partición diferente por si el error tiene que ver con el disco duro
 +
* por defecto %ServerRoot%/log/error_log
 +
ErrorLog logs/error_log
 +
<hr/>
 +
<font color=green>===LogLevel===</font>
 +
*Establece el nivel de aviso/error que el sistema tiene que generar para que dicha circunstancia sea almacenada en el ficero ErrorLog
 +
*Los niveles del sistema son los siguintes:
 +
#debug
 +
#info
 +
#notice
 +
#warn
 +
#error
 +
#crit
 +
#alert
 +
#emerg
 +
*El nivel de urgencia es de menos urgente o peligroso a más
 +
LogLevel warn
 +
<hr/>
 +
<font color=green>===LogFormat===</font>
 +
*Establece la información y el formato de la misma que vamos a guardar cuando queremos registrar un evento el ErroLog
 +
*Hay varias variables que podemos incluir
 +
*Visita http://httpd.apache.org/docs/2.4/es/mod/mod_log_config.html#logformat para verlos
 +
LogFormat "%h %l %u %t \"%r\" %>s %b"
 +
%h host remoto
 +
%l nombre del log remoto
 +
%u usuario remoto
 +
%t hora en la que ocurre el evento
 +
%r salto de línea
 +
%s Stado
 +
%b bytes que ocupa la respuesta
 +
<hr/>
 +
<font color=green>===CustonLog===</font>
  
−
<h4>ErrorLog</h4>
 
 
<hr/>
 
<hr/>
−
<h4>LogLevel</h4>
+
<font color=green>===ServerSignature===</font>
 +
<hr/>
 +
<font color=green>===Alias===</font>
 +
<hr/>
 +
<font color=green>===IndexOptions AddIconByEncoding AddIconByType AddIcon DefaultIcon ReadmeName  <font ===</font>
 +
<hr/>color=green>===HeaderName IndexIgnore===</font>
 +
<hr/>
 +
<font color=green>===AddEncoding===</font>
 +
<hr/>
 +
<font color=green>===LenguagePriority===</font>
 +
<hr/>
 +
<font color=green>===AddCharset===</font>
 +
<hr/>
 +
<font color=green>===AddDefaultCharset===</font>
 
<hr/>
 
<hr/>
−
<h4>LogFormat</h4>
+
<font color=green>===BrowserMatch===</font>
 
<hr/>
 
<hr/>
−
;CustonLog
 
−
;ServerSignature
 
−
;Alias
 
−
;IndexOptions AddIconByEncoding AddIconByType AddIcon DefaultIcon ReadmeName  HeaderName IndexIgnore
 
−
;AddEncoding
 
−
;AddLenguage
 
−
;LenguagePriority
 
−
;AddCharset
 
−
;AddDefaultCharset
 
−
;BrowserMatch
 

Revisión de 04:16 10 ene 2013



Qué son las directivas

  • Las directivas son variables predefinidas que utiliza el fichero/s de configuración de del servidor Apache
  • Gracias a ellas podemos personalizar el comportamiento del servidor web
  • Son muchas las directivas existentes, veremos algunas de ellas en el presente wiki
  • Dentro del fichero de configuración el signo # indica un comentario (se ignora esa línea)


Icon preknowledge.gif

Conocimiento previo

Cualquier cambio en la configuración del servidor tendrá efecto después de reniciarlo


Referencias

  1. Fichero de configuracion comentado y con referencias a la web
  2. Referencias relacionadas con apache
  3. Directivas de apache. Lista completa en la página oficial
  4. Formas de uso de las directivas de la página oficial
  5. Terminos usados para describir el uso de directivas

Directivas

ServerRoot

Corresponde al directorio donde se ha instalado el apache
No se debería cambiar (Si se cambia el servidor no deja de funcionar)
Posteriormente podemos hacer referencia a este directoria a través de la referencia %SeverRoot% 
ServerRoot /var/
Cuando se especifican rutas relativas siempre se tomarán respecto a la ubicación de ServerRoot

PidFile

Ubicación del fichero donde el servidor guarda su ID de proceso
Por defecto se ubica en %ServerRoot%/logs/httpd.pid 
PidFile logs/httpd.pid

Timeout

Tiempo en segundos en los que se esperan las respuestas en la comunicación
Pasado este tiempo se entiende que la comunicación se ha cortado
Por defecto se estable a valor de 300 
Timeout 300

===KeepAlive MaxKeepAliveRequest KeepAliveTimeout===

Permitir o no varias peticiones por conexión 
KeepAlive off
Establecerlo a on puede hacer que un cliente sature a un servidor.
Si se establece a on es muy recomendado usar las siguientes directivas.
MaxKeepAliveRequest para limitar el número de peticiones en cada conexión.
KeepAliveTimeout establece el tiempo que el servidor espera antes de atender una nueva petición de la misma conexión.

ifModule

Verifica la existencia de un determinado módulo
En caso de que exista el módulo se establece un bloque de opciones
Existe la posibilidad de establecer el bloque de opciones en caso de que no exista dicho módulo con la exclamación ! 
<ifModule nombre_modulo>
 Definiciones a tener en cuenta si está cargado el módulo nombre_modulo
</ifModule>
<!ifModule nombre_modulo>
 Definiciones a tener en cuenta si no está cargado el módulo nombre_modulo
</ifModule>

StartServer MaxClient MaxRequestsPerChild

Número de servidores que se crearán al arrancar el servicio 
StartServer 5 
#Abrimos 5 servidores al arrancar el servidor http Apache
MaxClient clientes que el servidor puede atender de forma concurrente
MaxRequestsPerChild establece el número máximo de peticiones que un proceso hijo puede atender.
Despues de atender este número de peticiones el proceso es eliminado
En caso de tener el valor 0 (valor por defecto) no se limita el número de peticiones que un proceso hijo puede atender

Port

Puerto que abre el servidor web para atender las solicitudes
Si no se especifica se asigna el puerto 80 
#establecemos el puert 7900 en lugar del puerto 80
Port 7900

Listen

Direcciones IP y puertos en los que escucha el servidor además de los puertos por defecto 
#Listen [IP-address:]portnumber
#Establecer el valor por defecto 
Listen 127.0.0.1:80

#Aquí establecemos que además del puerto 80, escuche también por el puerto 8080
Listen 8080

LoadModule

Esta directiva permita cargar nuevos módulos como si se tratara de ensambar un nuevo componente sin tener que volver a compilar los fuentes
Apache normalmente viene con la opcion DSO Dinamic Shared Object, por lo que podemos agregar nuevos módulos
Los módulos con los que se compilaron los fuentes no hacen falta volver a cargarlos. Sólo sería para añadir nuevos módulos que queramos incorporar

User Group

Estas directivas especifican el identificador de usuario, grupo con el que el servidor responderá a las peticiones. Es decir el usuario,grupo, propietario del proceso hijo que atiende las solicitudes del cliente
Para usar esta directiva, el servidor debe haber sido iniciado como root.
Si se inicia Apache con un usario distinto de root, no se podrá cambiar a un usuario con menores privilegios, y el servidor continuará ejecutándose con el usuario original.
Si inicia el servidor como root, entonces es normal que el procedimiento padre siga ejecutándose como root.
Un nombre de ususario, se refiere al usuario dado por su nombre.
# seguido por un número de usuario.
Se refiere al usuario que corresponde a ese número. 
User nombre_usuario
User #num_id_usuario
Group nombre_usuario
Group #num_id_usuario


ServerAdmin

ServerAdmin direccion_email|URL
  • Permite especificar la dirección del administrador que se mostrará al cliente en caso de que se produzca un error

ServerName

  • Especifica el nombre del servidor 
ServerName nombre_basado_dominio[:port]
  • Es recomendado utilizarlo, si no se utiliza se intentará deducirlo a partir de la ip y de una resolución inversa con el DNS

DocumentRoot

 
DocumentRoot directorio
  • Valor por defecto: DocumentRoot /usr/local/apache/htdocs
  • Especificamos el directorio raíz donde queremos colgar las páginas web
  • Si dentro de este directorio creamos subdirectorios, podremos acceder a ellos y ver su contendido
  • Una vez especificado el DocumentRoot, deberemos detallar su accesibilidad del directorio en la directiva Directory 
DocumentRoot /www/myWebs/
....
<Directory "/www/myWebs">
...

Directory

<Directory directory-path>
 ...  #opciones de acceso y comportamiento
</Directory>
  • Configuramos el comportamiento y permisos de un directorio especificado
  • Si nos se especifica de forma explícita dicho comportamiento será aplicado de forma recursiva a los subdirectorios
  • Por defecto aparece en dos ocasiones una muy restrictiva para el directorio raiz y otra más permisiva para el directorio donde comparitimos los ficheros 
<Directory />
 Options FollowSymLinks
 AllowOverride  None
 Order deny,allow
 Deny form all
</Directory>

<Directory />
 Options FollowSymLinks
 AllowOverride  None
 Order deny,allow
 Deny form all
</Directory>
  • A continuación vemos las diferentes opciones utilizadas

Options

  • Establece la opciones que va a tener el servidor al acceder a un directorio en concreto.
  • Puede tomar uno de los siguientes valores
  1. None : No se activa ninguna de las caracteristicas adicionales
  2. All :Se activan todas las características expceto la de MultiView
  3. ExecCGI: permita la ejecución de script CGI usando mod_cgi
  4. FollowSymLinks: El servidor puede seguir enlaces simbólicos en ese directorio.
  5. SymLinksIfOwnerMatch: Solo seguirá enlaces simbólicos si el directorio de destino es del mismo usuario que el enlace.
  6. Includes: Permite server-side includes.Esto es permiten a un fichero HTML incluir otros ficheros.
  7. IncludesNOEXEC: En este caso deshabilita el # exec cmd y # exec cgi.
  8. Indixes: Muestra una lista formateada del contenido de los directorios, si no existe el DirectoryIndex (como el index.html) en el directorio solicitado. Por razones de seguridad, esto no debería establecerse, y desde luego no en el directorio indicado por DocumentRoot.Esta opción debe de estar habilitada con cuidado (y sólo para ciertos directorios) sólo si esta seguro de querer que los usuarios vean todo el contenido del directorio.
  9. MultiViews Soporte para vistas múltiples negociadas por contenido; esta opción está desactivada de forma predeterminada por motivos de seguridad.

AllowOverride

AllowOverride All|None|tipo_directorio [tupo_directorio] ...
  • Especifica el tipo de directorios que pueden ser incluidos en el fichero .htaccess.
  • El valor de tipo_directorio puede tener uno de los siguientes valores
  1. None Ignora el fichero .htaccess
  2. AuthConf Permite usar directivas de autorización (AuthName, AuthType, ...)
  3. FileInf Se pueden usar directivas que controlan el tipo de documentos SetInputFilter, SetOutputFilter, )
  4. Indexes para gestionar el listado de ficheros y directorios
  5. Limit establecer directivas que controlan el acceso (Allow, deny y order)
  6. Options=[Option,..-] Permitir el uso de directivas que controlan funciones específicas del directorio.

Order

Order lista_permisos
  • Controla el orden en el cual se aplicarán los permisos a un directorio
  • Lista_permisos puede tener los siguientes valores
  1. Allow,Deny: Primero se evalúan todas las directivas Allow , y acontinuación son evaluadas las directivas 'Deny. Si la solicitud no coindice con ninguna premisa establecida, por defecto es rechazado
  2. Deny,Allow: Se realiza las evaluaciones en orden inverso
  • Veamos un ejemplo
En la siguiente especiviación todos los host del dominio enlaces.es tienen acceso, rechando cualquier acceso de cualquier otra ubicación de solicitud.

Order Deny,Allow Deny from all Allow from enlaces.es

Deny

===UserDir

  • Indica si se debe permitir que cada usuario de nuestro sistema tenga su porpia carpeta personal en el servidor web, estableciendo cual será la ruta desde el servidor para acceder a dicha carpeta.
  • Activando esta opción, se puede conseguir que cada uno tenga su propia web personal.
  • Una opción frecuente sería 
UserDir public_html
  • Con esta opción se crearía en nuestro servidor rutas para cada usuario.
  • Por ejemplo usuarios Luis, Maria , Sonia, establecería las rutas 
www.enlaces.es/~Luis
www.enlaces.es/~Maria
www.enlaces.es/~Sonia
  • Por otro lado cada usuario tendría en su home un subdirectorio public_html para publicar ahí las páginas web
  • Si queremos deshabilitarlo (opción por defecto) 
UserDir disable
  • Por seguridad no deberíamos permitir acceso a ninguna carpeta del home de root 
Userdir disabled root


===DirectoryIndex=== 

DirectoryIndex disabled |fichero [fichero]...
  • Establece el nombre del fichero que apache servira cuando se le realice una solicitud al directorio raiz del servidor (especificado en DocumentRoot)
  • En caso de no encontrarse ningún fichero Apache servira una lista de los fichero disponibles en ese directorio (opción Indexes del directorio DocumentRoot)
  • Se puede especificar una lista separada por espacios de fichero y el servidor servirá el primer fichero que localice en el directorio 
DirectoryIndes index.html index.htm index.php


===AccessFileName=== 

AccessFileName nombreFichero [nombreFichero] ...
  • Especifica el nombre del fichero en el que se especificarán las directiva de acceso para cada directorio. Esta es una alternativa a especificar de forma explícita dichos directivas en el fichero de configuración

Valor por defecto: AccessFileName .htaccess

===Files===

  • Es una directiva para determinar accesos a ficheros.
  • Se pueden especificar expresiones regulares en cuyo caso usarempos <FileMatch> o bien poniendo ~ despues de files 
<Files ~ "\.(gif|jpe?g|png)$">
<FileMatch <"^\.ht>
 Order allow,deny
 Deny from all
 Satisfy all
</FileMatch>

===UseCanonicalName=== 

UseCanonicalName on
  • Indica a apache que cada vez que tengamos que contruir direcciones que le hagan referencia, lo haga con el nombre canónico (Establecido en ServerName) y el puerto y no use el hostname


===TypesConfig=== Detalla la ubicación del fichero que contiene la descripción de los tipos MIME. Este fichero mime.types suele estar en el directorio /conf 

TypesConfig /conf/mime.types

===DefaultType===

  • Establece el tipo mime por defecto.
  • Este tipo será asignado a todos aquellos ficheros a los cuales no se les pueda asignar tipo según la descripción detallada en el fichero mime.types
  • A la hora de establecer este valor habría que tener en cuenta cuales son los tipos de ficheros más utilizados.
  • Ejemplo si la mayoría son fotografías y programas 
DefaultType application/octet-stream
  • Si la mayoría son html 
DefaultType text/html
  • Si la mayoría es fichero de texto 
DefaultType text/plain

===HostNameLookups===

  • Establece que se haga una consulta DNS por cada petición. No suele ser necesario y este uso sistemático relentiza el sistema. 
HostNameLookups off

===ErrorLog===

  • Establece la ubicación de los ficheros donde se almacenan los errores que se producan
  • Se puede ubicar en una partición diferente por si el error tiene que ver con el disco duro
  • por defecto %ServerRoot%/log/error_log 
ErrorLog logs/error_log

===LogLevel===

  • Establece el nivel de aviso/error que el sistema tiene que generar para que dicha circunstancia sea almacenada en el ficero ErrorLog
  • Los niveles del sistema son los siguintes:
  1. debug
  2. info
  3. notice
  4. warn
  5. error
  6. crit
  7. alert
  8. emerg
  • El nivel de urgencia es de menos urgente o peligroso a más 
LogLevel warn

===LogFormat=== 

LogFormat "%h %l %u %t \"%r\" %>s %b"

%h host remoto %l nombre del log remoto %u usuario remoto %t hora en la que ocurre el evento %r salto de línea %s Stado %b bytes que ocupa la respuesta

===CustonLog===

===ServerSignature===

===Alias===

===IndexOptions AddIconByEncoding AddIconByType AddIcon DefaultIcon ReadmeName <font ===

color=green>===HeaderName IndexIgnore===</font>

===AddEncoding===

===LenguagePriority===

===AddCharset===

===AddDefaultCharset===

===BrowserMatch===

Obtenido de «https://es.wikieducator.org/index.php?title=Usuario:ManuelRomero/modulo_APACHE/Directivas&oldid=11170»