Manuel utilisateur
Version 1.9 — Rev. 3

# Contexte d'application web Java

#### Description

Beaucoup de personnes executant des applications Java utilisent egalement le moteur de servlets pour servir du contenu statique. Toutefois, aucun moteur de servlets n'est aussi efficace que LiteSpeed Web Server pour ces operations. Pour ameliorer les performances globales, LiteSpeed Web Server peut etre configure comme serveur passerelle: il sert le contenu statique et transfere les requetes de pages Java dynamiques au moteur de servlets.
LiteSpeed Web Server exige que certains contextes soient definis pour executer une application Java. Un contexte d'application web Java cree automatiquement tous les contextes requis a partir du fichier de configuration de l'application web Java (WEB-INF/web.xml).
Gardez ces points a l'esprit lors de la configuration d'un contexte d'application web Java:

- Une application externe Servlet Engine doit etre configuree dans Applications externes avant de creer un contexte d'application web Java.
- Un Gestionnaire de scripts pour les fichiers .jsp doit egalement etre defini.
- Si l'application web est empaquetee dans un fichier .war, ce fichier doit etre extrait. Le serveur ne peut pas acceder aux archives compressees.
- Pour les memes ressources, la meme URL doit etre utilisee, que l'acces passe par LiteSpeed Web Server ou par le serveur HTTP integre du moteur de servlets.
  Par exemple, Tomcat 4.1 est installe sous /opt/tomcat. Les fichiers de l'application web "examples" se trouvent dans /opt/tomcat/webapps/examples/. Via le serveur HTTP integre de Tomcat, l'application web "examples" est donc accessible avec une URI telle que "/examples/***". Le contexte d'application web Java correspondant doit donc etre configure ainsi: URI = /examples/, Emplacement = /opt/tomcat/webapps/examples/.

### URI

#### Description

Indique l’URI de ce contexte. L’URI doit commencer par "/". Si une URI se termine par "/", ce contexte inclura toutes les sous-URI sous cette URI.

#### Syntaxe

URI

### Emplacement

#### Description

Indique le repertoire qui contient les fichiers de cette application web. Il s’agit du repertoire contenant "WEB-INF/web.xml".
Valeur par defaut: $DOC_ROOT + URI

#### Syntaxe

chemin

### Moteur Servlet

#### Description

Indique le nom du moteur servlet qui sert cette application web. Les moteurs servlet doivent etre definis dans la section Applications externes au niveau serveur ou hote virtuel.

#### Syntaxe

Sélectionner dans la liste déroulante

### Activer Expires

#### Description

Indique s’il faut generer un en-tete Expires pour les fichiers statiques. Si active, un en-tete Expires sera genere selon Expires par defaut et Expires par type.
Cela peut etre defini aux niveaux serveur, hote virtuel et contexte. Les parametres de niveau inferieur remplaceront ceux de niveau superieur, c’est-a-dire que les parametres de contexte remplaceront ceux de l’hote virtuel et les parametres de l’hote virtuel remplaceront ceux du serveur.

#### Syntaxe

Sélectionner avec les boutons radio

### Expires par defaut

#### Description

Indique les parametres par defaut pour la generation de l’en-tete Expires. Ce parametre prend effet lorsque Activer Expires est defini sur "Yes". Il peut etre remplace par Expires par type. Ne definissez pas ce defaut au niveau serveur ou hote virtuel sauf si necessaire, car il generera des en-tetes Expires pour toutes les pages. La plupart du temps, cela doit etre defini au niveau contexte pour certains repertoires qui ne changent pas souvent. S’il n’y a pas de parametre par defaut, aucun en-tete Expires ne sera genere pour les types non indiques dans Expires par type.

#### Syntaxe

A|Mseconds
Le fichier expirera apres le temps de base (A|M) plus les secondes indiquees. Le temps de base "A" definit la valeur sur le temps d’acces du client et "M" sur le temps de derniere modification du fichier.

### Expires par type

#### Description

Indique les parametres d’en-tete Expires pour des types MIME individuels.

#### Syntaxe

Liste separee par des virgules de "MIME-type=A|Mseconds". Le fichier expirera apres le temps de base (A|M) plus les secondes indiquees.
Le temps de base "A" definit la valeur sur le temps d’acces du client et "M" sur le temps de derniere modification du fichier. MIME-type accepte le caractere generique "*", comme image/*.

### Operations d’en-tete

#### Description

Indique les en-tetes de reponse/requete supplementaires a ajouter. Plusieurs directives d’en-tete peuvent etre ajoutees, une directive par ligne. "NONE" peut desactiver l’heritage des en-tetes parents. Si aucune directive n’est fournie, 'Header' est supposee.

#### Syntaxe

[Header]|RequestHeader [condition] set|append|merge|add|unset header [value] [early|env=[!]variable]

#### Exemple

set Cache-control no-cache
append Cache-control no-store
Header set My-header cust_header_val
RequestHeader set My-req-header cust_req_header_val

#### Conseils

Information La syntaxe et l’utilisation sont similaires aux directives mod_headers d’Apache pour les operations prises en charge.
Information La directive 'Header' est facultative et peut etre exclue ou conservee lors de la copie de regles sans probleme.

### Index automatique

#### Description

Indique s’il faut générer à la volée un index de répertoire lorsque les fichiers d’index listés dans Fichiers index ne sont pas disponibles dans un répertoire. Cette option est personnalisable au niveau hôte virtuel et contexte, et elle est héritée le long de l’arborescence de répertoires jusqu’à être explicitement remplacée. Vous pouvez personnaliser la page d’index générée. Consultez les How-tos du wiki en ligne.

#### Syntaxe

Sélectionner avec les boutons radio

#### Conseils

Security Il est recommandé de désactiver Index automatique partout où c’est possible afin d’éviter de révéler des données confidentielles.

#### Voir aussi

Fichiers index, URI d'index automatique

### Fichiers index

#### Description

Indique les noms des fichiers index qui seront recherches sequentiellement lorsqu’une URL est mappee vers un repertoire. Vous pouvez le personnaliser aux niveaux serveur, hote virtuel et contexte.

#### Syntaxe

Liste de noms de fichiers index separes par des virgules.

#### Conseils

Performance Ne definissez que les fichiers index dont vous avez besoin.

### Realm

#### Description

Indique le realm d’autorisation pour ce contexte. Lorsqu’il est indique, un nom d’utilisateur et un mot de passe valides doivent etre fournis pour acceder a ce contexte. Realms d'autorisation sont configures dans la section Hôte virtuel - Sécurité. Ce parametre utilise le Nom du realm de chaque realm.

#### Syntaxe

Sélectionner dans la liste déroulante

### Nom d’authentification

#### Description

Indique un nom alternatif pour le realm d’autorisation du contexte actuel. S’il n’est pas indique, le nom original du realm sera utilise. Le nom d’authentification est affiche dans la fenetre de login du navigateur.

### Require (utilisateurs/groupes autorises)

#### Description

Indique quels utilisateurs/groupes peuvent acceder a ce contexte. Cela permet d’utiliser une base de donnees utilisateur/groupe (indiquee dans Realm) sur plusieurs contextes, tout en n’autorisant que certains utilisateurs/groupes de cette base pour ce contexte.

#### Syntaxe

La syntaxe est compatible avec la directive Require d’Apache. Par exemple:

- user username [username ...]
  Seuls les utilisateurs listes peuvent acceder a ce contexte.
- group groupid [groupid ...]
  Seuls les utilisateurs appartenant aux groupes listes peuvent acceder a ce contexte.

Si ce parametre n’est pas indique, tous les utilisateurs valides pourront acceder a cette ressource.

### Acces autorise

#### Description

Indique quelles IPs ou sous-reseaux sont autorises a acceder aux ressources sous ce contexte. Avec Acces refuse et le controle d’acces de niveau serveur/hote virtuel, l’accessibilite est determinee par le plus petit perimetre dans lequel se trouve l’adresse IP du client.

#### Syntaxe

Liste d’IPs/sous-reseaux separee par des virgules.

#### Exemple

Les sous-reseaux peuvent etre ecrits sous la forme 192.168.1.0/255.255.255.0, 192.168.1 ou 192.168.1.*.

### Acces refuse

#### Description

Indique quelles IPs ou sous-reseaux ne sont PAS autorises a acceder aux ressources sous ce contexte. Avec Acces autorise et le controle d’acces de niveau serveur/hote virtuel, l’accessibilite est determinee par le plus petit perimetre dans lequel se trouve l’adresse IP du client.

#### Syntaxe

Liste d’IPs/sous-reseaux separee par des virgules.

#### Exemple

Les sous-reseaux peuvent etre ecrits sous la forme 192.168.1.0/255.255.255.0, 192.168.1 ou 192.168.1.*.

### Authorizer

#### Description

Indique une application externe pouvant generer des decisions autorise/non autorise. Actuellement, seul FastCGI Authorizer est disponible. Pour plus de details sur le role FastCGI Authorizer, consultez https://fastcgi-archives.github.io/ .

#### Syntaxe

Sélectionner dans la liste déroulante

### Ajouter le charset par defaut

#### Description

Indique s’il faut ajouter une balise de jeu de caracteres a l’en-tete de reponse "Content-Type", lorsque le type de contenu est "text/html" ou "text/plain" sans parametres. Avec Off, cette fonction est desactivee. Avec On, le jeu de caracteres indique par Charset par defaut personnalise ou le defaut "iso-8859-1" sera ajoute.

#### Syntaxe

Sélectionner avec les boutons radio

### Charset par defaut personnalise

#### Description

Indique un jeu de caracteres a utiliser lorsque Ajouter le charset par defaut vaut On. C’est facultatif. La valeur par defaut est iso-8859-1. Cette entree n’a aucun effet lorsque Ajouter le charset par defaut vaut Off.

#### Syntaxe

Nom d’un jeu de caracteres.

#### Exemple

utf-8

### Activer la recherche GeoLocation

#### Description

Indique s’il faut activer/desactiver la recherche IP Geolocation. Peut etre defini aux niveaux serveur, hote virtuel ou contexte. IP Geolocation est desactivee par defaut lorsque la valeur "Not Set" est utilisee.

#### Syntaxe

Sélectionner avec les boutons radio

#### Voir aussi

Utiliser l’IP client dans l’en-tete, Chemin du fichier DB,