Contexte LSAPI
Table des matières
Contexte LSAPI
- URI
- Application LiteSpeed SAPI
- Opérations sur les en-têtes
- Autoriser Override
- Realm
- Nom d'authentification
- Require (utilisateurs/groupes autorisés)
- Accès autorisé
- Accès refusé
- Authorizer
- Ajouter le jeu de caractères par défaut
- Charset par défaut personnalisé
- Âge du cache expiré (secondes)
- Tout mettre en cache publiquement
- Délai d'expiration du cache (secondes)
- Tout mettre en cache en privé
- Délai d'expiration du cache privé (secondes)
- Micro-cache des réponses 5XX
- Activer le cache POST
- Activer la recherche de géolocalisation
- Activer l'optimisation PageSpeed
- Paramètres PageSpeed
Contexte LSAPI
Description
Les applications externes ne peuvent pas etre utilisees directement. Elles doivent etre configurees comme gestionnaire de scripts ou associees a une URL au moyen d'un contexte. Un contexte LiteSpeed SAPI associe une URI a une application LSAPI (LiteSpeed Server Application Programming Interface). Des modules LSAPI existent actuellement pour PHP, Ruby et Python. Comme LSAPI est developpe specifiquement pour LiteSpeed web server, c'est le moyen le plus efficace de communiquer avec LiteSpeed web server.
URI
Description
Indique l’URI de ce contexte.
Syntaxe
L’URI peut etre une URI simple (commencant par "/") ou une URI d’expression reguliere compatible Perl (commencant par "exp:"). Si une URI simple se termine par "/", ce contexte inclura toutes les sous-URI sous cette URI. Si le contexte est mappe vers un repertoire du systeme de fichiers, un "/" final doit etre ajoute.
Voir aussi
Application LiteSpeed SAPI
Description
Indique le nom de l’application LiteSpeed SAPI a connecter a ce contexte. Cette application doit etre definie dans la section Applications externes au niveau serveur ou hote virtuel.
Syntaxe
Sélectionner dans la liste déroulante
Opérations sur les en-têtes
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.
Autoriser Override
Description
Indique quelles directives sont autorisees dans un fichier de controle d'acces. Un fichier de controle d'acces peut etre place dans un repertoire pour controler l'accessibilite des fichiers sous ce repertoire.
- Si rien n'est coche, les reglages par defaut herites seront utilises.
- Si Aucun est coche, les fichiers de controle d'acces seront ignores.
- Si Limite est coche, les directives "Allow", "Deny" et "Order" sont autorisees. Les directives <Limit> et <LimitExcept> sont aussi autorisees avec une prise en charge limitee des requetes GET, HEAD et POST.
- Si Auth est coche, les directives "AuthGroupFile", "AuthName", "AuthType", "AuthUserFile", "Require" et "Satisfy" sont autorisees.
- Si FileInfo est coche, les directives "AddDefaultCharset", "AddType", "DefaultType", "ForceType", "Redirect", "RedirectPermanent", "RedirectTemp", "RewriteBase", "RewriteCond", "RewriteEngine", "RewriteOptions" et "RewriteRule" sont autorisees.
- Si Index est coche, les directives "DirectoryIndex", "ExpiresActive", "ExpiresByType" et "ExpiresDefault" sont autorisees.
- Si Options est coche, la directive "Options" est autorisee.
La configuration Allow Override est disponible aux niveaux serveur, virtual host et contexte. Si une option n'est pas cochee au niveau serveur, les directives concernees seront desactivees pour tout le serveur, quels que soient les reglages des niveaux inferieurs. Les niveaux inferieurs peuvent desactiver un reglage active a un niveau superieur, mais ne peuvent pas activer un reglage desactive a un niveau superieur.
Valeurs par defaut:
Niveau serveur: "None" (ignorer le fichier de controle d'acces)
Niveau VH: heriter du reglage du niveau serveur
Niveau contexte heriter du reglage du niveau VH
Syntaxe
Sélectionner avec des cases à cocher
Conseils
Performance S'il n'est pas necessaire de personnaliser la configuration au niveau repertoire, cochez Aucun.
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 autorisés)
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.
Accès autorisé
Description
Indique quelles IPs ou sous-reseaux sont autorises a acceder aux ressources sous ce contexte. Avec Accès refusé 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
Accès refusé
Description
Indique quelles IPs ou sous-reseaux ne sont PAS autorises a acceder aux ressources sous ce contexte. Avec Accès autorisé 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 jeu de caractères par défaut
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 Désactivé, cette fonction est desactivee. Avec Activé, le jeu de caracteres indique par Charset par défaut personnalisé ou le defaut "iso-8859-1" sera ajoute.
Syntaxe
Sélectionner avec les boutons radio
Charset par défaut personnalisé
Description
Indique un jeu de caracteres a utiliser lorsque Ajouter le jeu de caractères par défaut vaut Activé. C’est facultatif. La valeur par defaut est iso-8859-1. Cette entree n’a aucun effet lorsque Ajouter le jeu de caractères par défaut vaut Désactivé.
Syntaxe
Nom d’un jeu de caracteres.
Exemple
Âge du cache expiré (secondes)
Description
Indique combien de temps un objet continuera d'etre servi depuis le cache apres son expiration mais avant qu'une nouvelle copie cachee soit disponible. La valeur par defaut est "10" secondes.
Syntaxe
Nombre entier
Tout mettre en cache publiquement
Description
Met en cache publiquement toutes les URL servies sous le contexte actuel (hote virtuel ou niveau contexte).
Les hotes virtuels configures via httpd.conf d'Apache peuvent utiliser les directives "CacheEnable" et "CacheDisable" au niveau serveur, hote virtuel, contexte, fichier et emplacement ou dans .htaccess. Les directives "CacheEnable" et "CacheDisable" sont compatibles avec les directives Apache mod_cache. Cependant, lorsqu'elles sont utilisees au niveau contexte, fichier ou emplacement, ou dans .htaccess, "CacheEnable" et "CacheDisable" ne seront appliquees qu'aux repertoires situes sous le niveau actuel. Les parametres d'URL seront ignores.
Syntaxe
Sélectionner avec les boutons radio
Conseils
Information Desactive par defaut. N'activez pas ce parametre si vous utilisez des plugins LSCache.
Délai d'expiration du cache (secondes)
Description
Indique combien de temps un objet sera mis en cache. La valeur par defaut est "86400" secondes (un jour).
Syntaxe
Nombre entier
Tout mettre en cache en privé
Description
Met en cache en prive toutes les URL servies sous le contexte actuel (hote virtuel ou niveau contexte).
Une copie cachee separee sera creee par utilisateur selon son IP et les cookies definis.
Les hotes virtuels configures via httpd.conf d'Apache peuvent utiliser les directives "CacheEnable private /url" et "CacheDisable private /url" aux niveaux serveur, hote virtuel, repertoire, fichier et emplacement ou dans un fichier .htaccess. "CacheEnable private" et "CacheDisable private" sont compatibles avec les directives mod_cache d'Apache et seront appliquees a tous les repertoires sous le niveau actuel. Cependant, lorsqu'elles sont utilisees au niveau repertoire, fichier ou emplacement, ou dans un fichier .htaccess, "CacheEnable private" et "CacheDisable private" ne seront appliquees qu'aux repertoires situes sous le niveau actuel. Les parametres d'URL seront ignores.
Syntaxe
Sélectionner avec les boutons radio
Conseils
Information Desactive par defaut. N'activez pas ce parametre si vous utilisez des plugins LSCache.
Délai d'expiration du cache privé (secondes)
Description
Indique combien de temps un objet sera mis en cache dans le cache prive. La valeur par defaut est "60" secondes.
Syntaxe
Nombre entier
Micro-cache des réponses 5XX
Description
Met en cache pendant 10 secondes les pages repondant avec le code d'etat HTTP 5xx (500, 503, etc.) lorsque l'en-tete de reponse de cache indique que la page peut etre mise en cache.
Valeurs par defaut :
Niveau serveur : Yes
Niveau VH : Heriter du parametre du niveau serveur
Niveau contexte Heriter du parametre du niveau VH
Syntaxe
Sélectionner avec les boutons radio
Conseils
Performance Activer ce parametre est utile pour eviter les mauvaises requetes, mais peut aussi ajouter une protection DDoS.
Activer le cache POST
Description
Indique si les requetes POST peuvent etre mises en cache avec l'en-tete "x-litespeed-cache-control".
Valeur par defaut : Non
Syntaxe
Sélectionner avec les boutons radio
Activer la recherche de géolocalisation
Description
Enterprise Edition Only 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-tête, Chemin du fichier de BD,
Activer l'optimisation PageSpeed
Description
Choisissez d'activer ou non l'optimisation PageSpeed.
Syntaxe
Sélectionner avec les boutons radio
Conseils
Information Cela peut etre defini au niveau serveur et remplace aux niveaux hote virtuel et contexte. Les parametres du niveau contexte remplaceront les parametres du niveau hote virtuel.