AdminWiki : /* configuration des répertoires des serveurs */

2019-08-14T09:01:31Z

configuration des répertoires des serveurs

← Version précédente		Version du 14 août 2019 à 11:01
Ligne 83 :		Ligne 83 :
	La configuration des répertoires se fait entre des balises <Directory> et </Directory>. Par exemple :		La configuration des répertoires se fait entre des balises <Directory> et </Directory>. Par exemple :

	<Directory "/var/www/test">		Alias "/test" "/var/www/test"
	AllowOverride None		<Directory "/var/www/test">
	DirectoryIndex test.html		AllowOverride None
	Options Indexes		DirectoryIndex test.html
			Options Indexes FollowSymLinks
			<IfModule mod_autoindex.c>
			IndexOptions NameWidth=*
			</ifModule>
	</Directory>		</Directory>

AdminWiki : /* configuration des répertoires des serveurs */

2019-08-05T13:37:18Z

configuration des répertoires des serveurs

← Version précédente		Version du 5 août 2019 à 15:37
Ligne 102 :		Ligne 102 :
	\| Options FollowSymLinks \|\| suivre les liens symboliques		\| Options FollowSymLinks \|\| suivre les liens symboliques
	\|-		\|-
	\| Options Indexes \|\| permet de lister le répertoire (mettre -Indexes sinon)		\| Options Indexes \|\| permet de lister le répertoire (mettre -Indexes sinon) (voir remarque 2 ci-dessous)
	\|-		\|-
	\| Options Includes \|\| permet d'inclure des fichiers (nécessite mod_include)		\| Options Includes \|\| permet d'inclure des fichiers (nécessite mod_include)
Ligne 114 :		Ligne 114 :


	Remarque : les options peuvent se mettre sur une seule ligne en les séparant par des espaces. Exemple : "Options FollowSymLinks Indexes"		Remarque 1 : les options peuvent se mettre sur une seule ligne en les séparant par des espaces. Exemple : "Options FollowSymLinks Indexes"

			Remarque 2 : concernant Indexes, si on ne précise rien, les noms des fichiers seront tronqués à quelques caractères, ce qui n'est pas très lisible. Il est donc préférable de l'utiliser comme suit :
			Options Indexes
			<IfModule mod_autoindex.c>
			IndexOptions NameWidth=*
			</ifModule>

	==configuration spécifique au démon apache lui-même==		==configuration spécifique au démon apache lui-même==

AdminWiki : /* configuration des répertoires des serveurs */

2014-12-22T10:10:37Z

configuration des répertoires des serveurs

← Version précédente		Version du 22 décembre 2014 à 12:10
Ligne 98 :		Ligne 98 :
	\|-		\|-
	\| Order allow,deny<br />Allow from 192.168.1.<br />Deny from all \|\| lit d'abord la liste Allow puis Deny		\| Order allow,deny<br />Allow from 192.168.1.<br />Deny from all \|\| lit d'abord la liste Allow puis Deny
	autorise tout le réseau 192.168.1.* et rejette le reste. On peut egalement mettre "Allow 192.168.1.1" sans le "from". Pour mettre plusieurs ips, on les sépare par des espaces.		autorise tout le réseau 192.168.1.* et rejette le reste. On peut egalement mettre "Allow 192.168.1." sans le "from". Pour mettre plusieurs ips, on les sépare par des espaces.
	\|-		\|-
	\| Options FollowSymLinks \|\| suivre les liens symboliques		\| Options FollowSymLinks \|\| suivre les liens symboliques

AdminWiki : /* configuration des répertoires des serveurs */

2014-12-22T10:10:12Z

configuration des répertoires des serveurs

← Version précédente		Version du 22 décembre 2014 à 12:10
Ligne 98 :		Ligne 98 :
	\|-		\|-
	\| Order allow,deny<br />Allow from 192.168.1.<br />Deny from all \|\| lit d'abord la liste Allow puis Deny		\| Order allow,deny<br />Allow from 192.168.1.<br />Deny from all \|\| lit d'abord la liste Allow puis Deny
	autorise tout le réseau 192.168.1 et rejette le reste. On peut egalement mettre "Allow 192.168.1.1" sans le "from"		autorise tout le réseau 192.168.1.* et rejette le reste. On peut egalement mettre "Allow 192.168.1.1" sans le "from". Pour mettre plusieurs ips, on les sépare par des espaces.
	\|-		\|-
	\| Options FollowSymLinks \|\| suivre les liens symboliques		\| Options FollowSymLinks \|\| suivre les liens symboliques

AdminWiki : Page créée avec « Category:linux =Présentation= Apache est le serveur web le plus utilisé dans le monde. Les explications qui suivent dans cette page fonctionne sous linux et BSD av... »

2013-09-16T14:02:44Z

Page créée avec « Category:linux =Présentation= Apache est le serveur web le plus utilisé dans le monde. Les explications qui suivent dans cette page fonctionne sous linux et BSD av... »

Nouvelle page

[[Category:linux]]

=Présentation=

Apache est le serveur web le plus utilisé dans le monde. Les explications qui suivent dans cette page fonctionne sous linux et BSD avec les versions d'apache 2.x. Une bonne partie doit aussi fonctionner avec apache 1.3. C'est aussi probablement la même chose sous windows, mais je n'ai jamais essayé dessus.

=Gestion du démon (arrêt, démarrage et autres)=

Les différentes méthodes d'arrêt/relance du démon sont les suivantes :
* /etc/init.d/httpd stop|start|restart : sous redhat et équivalents
* /etc/init.d/apache stop|start|restart : sous debian et équivalents
* apachectl stop|start|restart : partout (en root)

Il existe de nombreuses options au daemon. Les plus courantes sont :
{|class="wikitable alternance centre"
|-
|stop, start, restart || sans commentaire
|-
|status || affiche l'état du serveur. Nécessite mod_status et un navigateur web mode texte (comme lynx)
|-
|fullstatus || idem, sans la liste des requêtes en cours
|-
|gracefull ou reload || recharge le fichier de config, sans arrêter le serveur
|-
|gracefull-stop || arrête proprement apache, en attendant que les connexions actives s'arrêtent, contrairement à stop qui arrête tout, tout de suite
|-
|configtest || teste les fichiers de configuration
|}

Pour les autres, il faut lire le man.

=Configuration=

==les fichiers de configuration==

Il existe quelques petites différences entre apache 1.x et 2.x :

* apache 1.x : tout est dans httpd.conf
* apache 2.x : on peut tout mettre dans httpd.conf, ou alors externaliser une partie de la conf dans d'autres fichiers (par exemple pour les vhosts), et faire un Include dans httpd.conf pour qu'il aille lire ces autres fichiers (exemple dans httpd.conf : Include conf/vhosts/*.conf)

==structure des fichiers de configuration==

On peut considérer que httpd.conf contient trois parties principales :

* la configuration des serveurs (principal ou vhosts)
ex : ServerName, ErrorLog, DocumentRoot, Alias
* la configuration des répertoires (c'est en fait une sous-partie de la configuration des serveurs). Elle est dans une balise <Directory>.
ex : Option Indexes, AllowOverride
* la configuration d'apache lui-même
ex : modules

==configuration des serveurs (principal ou virtuels)==

Les principales lignes à configurer concernant les serveurs (dans httpd.conf ou dans les fichiers de conf des virtuels), sont :

{|class="wikitable alternance centre"
|-
| ServerName Nom || le nom du serveur. En prod, ne jamais laisser le hostname du serveur (pour une raison de sécurité), mais mettre www.site-web.com, et configurer le DNS pour qu'il fasse pointer le nom vers ce serveur
|-
| ErrorLog Répertoire || répertoire d'enregistrement des logs
|-
| ServerRoot Répertoire || répertoire de base du serveur
|-
| DirectoryIndex Page_web || pages par défaut d'apache pour chaque répertoire (en général index.html)
|-
| Timeout Duree_en_secondes || durée du timeout
|-
| KeepAlive on (ou off) || accepter plus d'une requête par connexion
|-
| MaxKeepAliveRequests Nombre || nombre max de requête par connexion (0 pour illimité)
|-
| KeepAliveTimeout Duree_en_secondes || nb de secondes à attendre pour la requête suivante pour la même connexion
|-
| Alias /test/ "/var/www/test/" || http://nom_serveur/test pointe sur /var/www/test/
|}

==configuration des répertoires des serveurs==

La configuration des répertoires se fait entre des balises <Directory> et </Directory>. Par exemple :

<Directory "/var/www/test">
AllowOverride None
DirectoryIndex test.html
Options Indexes
</Directory>

Voici les options les plus intéressantes :

{|class="wikitable alternance centre"
|-
| AllowOverride None || inhibe l'action de .htaccess, mettre All sinon (d'autres options sont possibles)
|-
| DirectoryIndex test.html || page affichée quand on se connecte au répertoire
|-
| Order allow,deny<br />Allow from 192.168.1.<br />Deny from all || lit d'abord la liste Allow puis Deny
autorise tout le réseau 192.168.1 et rejette le reste. On peut egalement mettre "Allow 192.168.1.1" sans le "from"
|-
| Options FollowSymLinks || suivre les liens symboliques
|-
| Options Indexes || permet de lister le répertoire (mettre -Indexes sinon)
|-
| Options Includes || permet d'inclure des fichiers (nécessite mod_include)
|-
| Options IncludeNOEXEC || idem, mais interdit l'exécution de scripts
|-
| Options ExecCGI || permet d'exécuter des scripts CGI (bien charger les modules adéquats, exemple mod_perl pour perl)
|-
| Options None || aucune option
|}

Remarque : les options peuvent se mettre sur une seule ligne en les séparant par des espaces. Exemple : "Options FollowSymLinks Indexes"

==configuration spécifique au démon apache lui-même==

Dans la configuration du démon, on retrouve la configuration des modules. Je vous renvoie sur la section dédiée aux modules pour plus d'infos. Sinon, les autres lignes intéressantes sont :

{|class="wikitable alternance centre"
|-
| LockFile Fichier || fichier en local, sert uniquement si ServerRoot est un montage sur le réseau
|-
| PidFile Fichier || fichier contenant le pid d'apache
|-
| User Nom_utilisateur || user sous lequel tournera apache (ne jamais mettre root, pour une question de sécurité)
|-
| Group Nom_groupe || groupe sous lequel tournera apache (ne jamais mettre root, pour une question de sécurité)
|-
| StartServers Nombre || nombre de processus serveur à démarrer au lancement d'apache
|-
| MaxClients Nombre || nombre max de clients simultanés
|-
| Listen Nombre || port d'écoute d'apache (par défaut 80). On peut en ajouter plusieurs, ou des ips
|}

==configuration des serveurs virtuels==

Voici un exemple de configuration :

soit on dispose d'adresses ip (adressage par ip), soit on met une * (adressage par résolution de nom) et le serveur se débrouille en fonction de l'url (il faut faire pointer les adresses DNS vers le même serveur) :

<VirtualHost 192.168.0.11> ou <VirtualHost *> ou <VirtualHost*:80>
ServerName "www.exemple.com"
DocumentRoot "/www/main"
ServerAlias site.com *.site.com # permet un alias de nom
</VirtualHost>

<VirtualHost 192.168.0.12> ou <VirtualHost *>
ServerName "www.support.exemple.com"
DocumentRoot "/www/support"
</VirtualHost>

Remarque : On peut avoir un hôte virtuel par défaut avec la directive <VirtualHost_default>.

==personnalisation des pages d'erreur==

Il faut rajouter une directive '''ErrorDocument''' dans le fichier de conf du serveur.

Syntaxe :

ErrorDocument NumeroErreur Lien_ou_Message

exemples :

ErrorDocument 404 "Page non trouvée"
ErrorDocument 500 http://www.exemple.com
ErrorDocument 401 /repertoire/page_erreur.html

==protéger des pages et répertoires==

Dans ce chapitre, nous allons voir les différentes étapes pour protéger les pages contenues dans /var/www/test/ et ses sous-répertoires.

'''1.''' créer un fichier mot de passes (vide pour l'instant), par exemple /var/www/.htpasswd

'''2.''' éditer le fichier de la forme :

fred:gWK3udIcGH832
bob:BgG6vsQflVS66

Ce fichier doit contenir les mots de passe sous forme cryptée uniquement. Pour le créer, il faut d'abord mettre n'importe quoi à la place du mot de passe.

Exemple :

fred:blabla
bob:bob

Puis, pour les crypter, on va taper "htpasswd -b /var/www/.htpasswd bob mot-de-passe en clair". Maintenant, le mot de passe de bob sera crypté. Il faut faire pareil avec tous les comptes. Si on ne veut pas que le mot de passe apparaisse en clair sur la ligne de commande, il faut taper "htpasswd /var/www/.htpasswd bob" et il va demander de taper le mot de passe.

'''3.''' éditer le fichier /var/www/test/.htaccess et copier dedans :

AuthUserFile /var/www/.htpasswd # fichier mot de passe
AuthGroupFile /dev/null # idem pour le groupe
AuthName "Accés réservé" # texte qui apparait dans la boite de dialogue
AuthType Basic # pour lui dire d'utiliser AuthUserFile
<Limit GET POST>
Require valid-user # autorise tous les utilisateurs qui sont dans .htpasswd. On pourait mettre "Require user fred" pour n'autoriser que fred
</Limit>

'''4.''' apachectl reload

==les espaces web utilisateurs==

Permet l'accès aux urls de type http://serveur/~fred/.

Nécessite le module mod_userdir.c.

Syntaxe :

UserDir enabled

Exemple :

UserDir disabled root bin users # on active tous les répertoires persos, sauf ceux de root, bin et users.

==les modules==

charger un module :

LoadModule identifiant chemin

exemple :

LoadModule cgi_module
libexec/httpd/mod_cgi.so

test sur un module :

<IfModule [ ! ] identifiant_module>
[ actions ]
</IfModule>

==plus de docs (les docs officielles apache)==

Les docs officielles apache sont beaucoup plus complètes que cette page. Elles contiennent toutes les directives de configuration, ainsi que les différences entre les versions. Elles sont accessibles ici : http://httpd.apache.org/docs/.

=Divers=

==liste des modules compilés statiquement==

httpd -l

==modifier la page d'accueil par défaut==

Lorsqu'on se connecte sur un serveur Apache sans préciser le répertoire (par exemple http://localhost/), on se retrouve sur une page d'accueil Apache souvant personnalisée pour sa distribution. Si on souhaite avoir une des pages installées comme page d'accueil, il faut ajouter la ligne suivante après la balise <Directory /> :

DirectoryIndex chemin_vers_la_page

Le chemin vers la page est le chemin relatif depuis le répertoire racine d'Apache.

Exemple :

<Directory />
Options FollowSymLinks
DirectoryIndex mediawiki/index.php
AllowOverride None
</Directory>

Apache - Historique des versions

AdminWiki : /* configuration des répertoires des serveurs */

AdminWiki : /* configuration des répertoires des serveurs */

AdminWiki : /* configuration des répertoires des serveurs */

AdminWiki : /* configuration des répertoires des serveurs */

AdminWiki : Page créée avec « Category:linux =Présentation= Apache est le serveur web le plus utilisé dans le monde. Les explications qui suivent dans cette page fonctionne sous linux et BSD av... »

AdminWiki : /* configuration des répertoires des serveurs */

AdminWiki : /* configuration des répertoires des serveurs */

AdminWiki : /* configuration des répertoires des serveurs */

AdminWiki : /* configuration des répertoires des serveurs */

AdminWiki : Page créée avec « Category:linux =Présentation= Apache est le serveur web le plus utilisé dans le monde. Les explications qui suivent dans cette page fonctionne sous linux et BSD av... »