Les autres propriétés suivantes sont disponibles pour un serveur virtuel.
sso-max-inactive-seconds
Indique le délai (en secondes) au-delà duquel l'enregistrement de connexion unique d'un utilisateur peut être purgé si aucune activité client n'est détectée. Etant donné que la connexion unique s'applique à plusieurs applications sur le même serveur virtuel, le fait d'accéder à une application permet de garder l'enregistrement de connexion unique actif.
La valeur par défaut est de 300 secondes (5 minutes). Des valeurs supérieures offrent aux utilisateurs une persistance de connexion unique supérieure, au détriment d'une plus grande consommation de mémoire sur le serveur.
sso-reap-interval-seconds
Indique le nombre de secondes entre les purges des enregistrements de connexion unique arrivés à expiration.
La valeur par défaut est 60.
ssoCookieSecure
Définit l'attribut Secure
de tous les cookies JSESSIONIDSSO
associés aux applications Web déployées sur ce serveur virtuel. Cette propriété s'applique uniquement si la fonction de connexion unique est activée. Les valeurs autorisées sont les suivantes :
True
Attribue la valeur True à l'attribut Secure
.
False
Attribue la valeur False à l'attribut Secure
.
dynamic
Le cookie JSESSIONIDSSO
hérite du paramètre Secure
de la première session participant à la connexion unique.
Pour définir l'attribut Secure d'un cookie JSESSIONID
, utilisez la propriété cookieSecure
cookie-properties
dans le fichier sun-web.xml
. Pour plus d'informations, reportez vous à cookie-properties dans le manuel Oracle GlassFish Server Application Deployment Guide.
setCacheControl
Fournit la liste des directives de réponse Cache-Control
séparées par des virgules. Pour obtenir la liste des directives valides, reportez-vous à la section 14.9 du document disponible à l'adresse http://www.ietf.org/rfc/rfc2616.txt (http://www.ietf.org/rfc/rfc2616.txt
).
accessLogBufferSize
Indique la taille (en octets) de la mémoire tampon dans laquelle sont stockés les appels du journal des accès. Si la valeur est inférieure à 5 120, un message d'avertissement est émis et la valeur est définie sur 5 120. La valeur par défaut est 32 768.
accessLogWriterInterval
Spécifie le délai (en secondes) avant que l'écriture du journal sur le disque. Le journal des accès est écrit lorsque la mémoire tampon est pleine ou que l'intervalle expire. Si la valeur est égale à zéro, l'écriture continue dans la mémoire tampon même si elle n'est pas pleine. Autrement dit, chaque fois que l'utilisateur accède au serveur, le message du fichier journal est directement stocké dans le fichier. La valeur par défaut est 300.
allowRemoteAddress
Fournit une liste de modèles d'expressions régulières (séparés par des virgules) auxquels l'adresse IP du client distant est comparée. Si cette propriété est spécifiée, l'adresse distante doit correspondre pour que cette demande soit acceptée. Si cette propriété n'est pas spécifiée, toutes les demandes sont acceptées à moins que l'adresse distante ne corresponde à un modèle denyRemoteAddress
.
denyRemoteAddress
Fournit une liste de modèles d'expressions régulières (séparés par des virgules) auxquels l'adresse IP du client distant est comparée. Si cette propriété est spécifiée, l'adresse distante ne doit pas correspondre pour que cette demande soit acceptée. Si cette propriété n'est pas spécifiée, l'acceptation de la demande est régie uniquement par la propriété allowRemoteAddress
.
allowRemoteHost
Fournit une liste de modèles d’expressions régulières (séparés par des virgules) auxquels le nom d’hôte du client distant (tel que renvoyé par [java.net.]Socket.getInetAddress().getHostName()
) est comparé. Si cette propriété est spécifiée, le nom d'hôte distant doit correspondre pour que cette demande soit acceptée. Si cette propriété n'est pas spécifiée, toutes les demandes sont acceptées à moins que le nom d'hôte distant ne corresponde à un modèle denyRemoteHost
.
denyRemoteHost
Fournit une liste de modèles d’expressions régulières (séparés par des virgules) auxquels le nom d’hôte du client distant (tel que renvoyé par [java.net.]Socket.getInetAddress().getHostName()
) est comparé. Si cette propriété est spécifiée, le nom d'hôte distant ne doit pas correspondre pour que cette demande soit acceptée. Si cette propriété n'est pas spécifiée, l'acceptation de la demande est régie uniquement par la propriété allowRemoteHost
.
Définir cette propriété n'a aucun effet si l'accès au domaine de GlassFish Server est effectué par l'intermédiaire d'un processus d'écoute réseau dont l'option Processus d'écoute JK est activée.
authRealm
Spécifie le nom d'un domaine d'authentification, qui remplace le domaine par défaut de l'instance du serveur pour les applications Web autonomes déployées sur ce serveur virtuel. Un domaine défini dans le fichier web.xml
d'une application Web autonome remplace le domaine du serveur virtuel. Pour plus d'informations, reportez-vous à Domaines.
securePagesWithPragma
Attribuez la valeur False
à cette propriété afin de vous assurer que, pour toutes les applications Web de ce serveur virtuel, les téléchargements de fichiers utilisant SSL fonctionnent correctement dans Internet Explorer.
Les applications Web individuelles peuvent remplacer ce paramètre en utilisant l'élément sun-web-app
du fichier sun-web.xml
. Pour plus d'informations, reportez-vous à glassfish-web-app dans le manuel Oracle GlassFish Server Application Deployment Guide.
La valeur par défaut est True
.
alternatedocroot_
nIndique une autre racine de document (docroot), où n est un entier positif qui permet de spécifier d'autres racines. Les autres racines de document permettent aux applications Web de traiter les demandes de certaines ressources en dehors de leur propre racine de document, selon que ces demandes correspondent à des modèles d'URI des autres racines de document de l'application Web.
Si une demande correspond au modèle d'URI d'une autre racine de document, elle est mise en correspondance avec cette autre racine en ajoutant l'URI de demande (moins la racine de contexte de l'application Web) à la fin de l'emplacement physique (répertoire) de l'autre racine de document. Si une demande correspond à plusieurs modèles d'URI, l'autre racine de document est déterminée en fonction de l'ordre de priorité suivant :
Correspondance exacte
Correspondance du chemin le plus long
Correspondance d'extension
Par exemple, les propriétés suivantes spécifient trois autres racines de document. Le modèle d'URI de la première autre racine de document utilise une correspondance exacte, tandis que les modèles d'URI des deuxième et troisième racines de document utilisent des correspondances d'extension et de préfixe de chemin le plus long, respectivement.
<property name="alternatedocroot_1" value="from=/my.jpg dir=/srv/images/jpg"/> <property name="alternatedocroot_2" value="from=*.jpg dir=/srv/images/jpg"/> <property name="alternatedocroot_3" value="from=/jpg/* dir=/src/images"/>
La valeur
de chacune de ces racines de document dispose de deux composants : le premier composant, from
, spécifie le modèle d'URI de la racine de document et le second, dir
, en spécifie l'emplacement physique (répertoire). Les espaces sont autorisés dans le composant dir
.
Les applications Web individuelles peuvent remplacer ce paramètre en utilisant l'élément sun-web-app
du fichier sun-web.xml
. Pour plus d'informations, reportez-vous à glassfish-web-app dans le manuel Oracle GlassFish Server Application Deployment Guide.
contextXmlDefault
Indique l'emplacement, en fonction de domain-dir, du fichier context.xml
pour ce serveur virtuel, si un serveur virtuel est utilisé. Pour plus d'informations sur le fichier context.xml
, reportez-vous au document The Context Container (http://tomcat.apache.org/tomcat-5.5-doc/config/context.html
).
allowLinking
Si la valeur est True
, les ressources représentant des liens symboliques seront utilisées pour toutes les applications Web déployées sur ce serveur virtuel. Les applications Web individuelles peuvent remplacer ce paramètre en utilisant la propriété sun-web-app
allowLinking
du fichier sun-web.xml :
<sun-web-app> <property name="allowLinking" value="{true|false}"/> </sun-web-app>
Pour plus d'informations, reportez-vous à glassfish-web-app dans le manuel Oracle GlassFish Server Application Deployment Guide.
La valeur par défaut est False
.
Attention:
Sous Windows, si vous attribuez la valeur True à cette propriété, le code source JSP devient visible.send-error_
nSpécifie les correspondances de page d'erreur personnalisée pour le serveur virtuel, qui sont héritées par toutes les applications Web déployées sur ce serveur virtuel. Une application Web peut remplacer les correspondances de page d'erreur personnalisée dans son descripteur de déploiement web.xml
. La valeur de chaque propriété send-error_
n comporte trois composants, qui peuvent être spécifiés dans n'importe quel ordre :
Le premier composant, code
, spécifie le code de statut de la réponse HTTP à trois chiffres pour lequel la page d'erreur personnalisée doit être renvoyée dans la réponse.
Le deuxième composant, path
, spécifie le chemin du système de fichiers absolu ou relatif de la page d'erreur personnalisée. Un chemin de système de fichiers relatif est interprété comme étant relatif au répertoire domain-dir/config
.
Le troisième composant, reason
, est facultatif et spécifie le texte de la chaîne de motif (comme Unauthorized
ou Forbidden
) à renvoyer.
Exemple :
<property name="send-error_1" value="code=401 path=/myhost/401.html reason=MY-401-REASON"/>
Cet exemple de définition de propriété entraîne le renvoi du contenu de /myhost/401.html
avec les réponses 401, ainsi que la ligne de réponse suivante :
HTTP/1.1 401 MY-401-REASON
redirect_
nSpécifie qu'une demande d'ancienne URL est traitée comme une demande de nouvelle URL. Toutes les applications Web déployées sur le serveur virtuel héritent de ces propriétés. La valeur de chaque propriété redirect_
n comporte deux composants, qui peuvent être spécifiés dans n'importe quel ordre :
Le premier composant, from
, spécifie le préfixe de l'URI demandé à associer.
Le second composant, url-prefix
, spécifie le nouveau préfixe d'URL à renvoyer au client. Le préfixe from
est simplement remplacé par ce préfixe d'URL.
Exemple :
<property name="redirect_1" value="from=/dummy url-prefix=http://etude"/>
valve_
nSpécifie le nom de classe qualifié complet d'une valve personnalisée, où n est un entier positif qui permet d'en spécifier plusieurs. La classe valve doit implémenter l'interface org.apache.catalina.Valve
depuis Tomcat ou des versions précédentes de GlassFish Server ou l'interface org.glassfish.web.valve.GlassFishValve
à partir de la version en cours de GlassFish Server. Exemple :
<property name="valve_1" value="org.glassfish.extension.Valve"/>
Vous pouvez définir cette propriété pour une application Web spécifique. Pour plus d'informations, reportez-vous à glassfish-web-app dans le manuel Oracle GlassFish Server Application Deployment Guide.
listener_
nSpécifie le nom de classe qualifié complet d'un processus d'écoute Catalina personnalisé, où n correspond à un entier positif qui permet d'en spécifier plusieurs. La classe de processus d'écoute doit implémenter l'interface org.apache.catalina.ContainerListener
ou org.apache.catalina.LifecycleListener
. Exemple :
<property name="listener_1" value="org.glassfish.extension.MyLifecycleListener"/>
Vous pouvez définir cette propriété pour une application Web spécifique. Pour plus d'informations, reportez-vous à glassfish-web-app dans le manuel Oracle GlassFish Server Application Deployment Guide.
errorReportValve
Spécifie le nom de classe qualifié complet d'une valve personnalisée produisant des pages d'erreur par défaut pour les applications sur ce serveur virtuel. Spécifiez une chaîne vide pour désactiver le mécanisme de page d'erreur par défaut pour ce serveur virtuel.