Manuel utilisateur OpenLiteSpeed
Contexte d'application web Java
Table des matières
Contexte d'application web Java
- URI
- Emplacement
- Moteur Servlet
- Activer Expires
- Expires par defaut
- Expires par type
- Operations d’en-tete
- Index automatique
- Fichiers index
- Realm
- Nom d’authentification
- Require (utilisateurs/groupes autorises)
- Acces autorise
- Acces refuse
- Authorizer
- Ajouter le charset par defaut
- Charset par defaut personnalise
- Activer la recherche GeoLocation
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
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
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.
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
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
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
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