Las siguientes propiedades adicionales están disponibles para un servidor virtual.
sso-max-inactive-seconds
Especifica el número de segundos después de los cuales el registro de single sign-on de un usuario cumple con los requisitos necesarios para la depuración si no se detecta ninguna actividad de cliente. Dado que el single sign-on se aplica en varias aplicaciones en el mismo servidor virtual, el acceso a cualquiera de las aplicaciones mantiene activo el registro de single sign-on.
El valor por defecto es 300 segundos (5 minutos). Los valores más altos proporcionan una persistencia de single sign-on más larga para los usuarios a costa de un mayor consumo de memoria en el servidor.
sso-reap-interval-seconds
Especifica el número de segundos entre depuraciones de registros de single sign-on caducados.
El valor por defecto es 60.
ssoCookieSecure
Define el atributo Secure
de cualquier cookie JSESSIONIDSSO
asociada a las aplicaciones web desplegadas en este servidor virtual. Esta propiedad únicamente se aplica si se activa el single sign-on. Los valores permitidos son los siguientes:
true
Define Secure
en true.
false
Define Secure
en false.
dynamic
La cookie JSESSIONIDSSO
hereda el valor Secure
de la primera sesión que participa en el SSO.
Para definir el atributo Secure de una cookie JSESSIONID
, utilice la propiedad cookieSecure
cookie-properties
del archivo sun-web.xml
. Para obtener más información, consulte cookie-properties en Oracle GlassFish Server Application Deployment Guide.
setCacheControl
Especifica una lista separada por comas de las directivas de respuesta de Cache-Control
. Para obtener una lista de directivas válidas, consulte la sección 14.9 del documento en http://www.ietf.org/rfc/rfc2616.txt (http://www.ietf.org/rfc/rfc2616.txt
).
accessLogBufferSize
Especifica el tamaño (en bytes) del buffer en el que se almacenan las llamadas del log de acceso. Si el valor es inferior a 5120, se muestra una advertencia y el valor se define en 5120. El valor por defecto es 32768.
accessLogWriterInterval
Especifica el número de segundos antes de que el log se escriba en el disco. El log de acceso se escribe cuando el buffer está lleno o cuando caduca el intervalo. Si el valor es 0, el buffer siempre se escribirá aunque no esté lleno. Esto significa que cada vez que se accede al servidor, el mensaje de log se almacena directamente en el archivo. El valor por defecto es 300.
allowRemoteAddress
Especifica una lista de patrones de expresión regular separados por comas con los que se compara la dirección IP del cliente. Si se especifica esta propiedad, la dirección remota debe coincidir para que se acepte esta solicitud. Si no se especifica esta propiedad, se aceptan todas las solicitudes a menos que la dirección remota coincida con un patrón denyRemoteAddress
.
denyRemoteAddress
Especifica una lista de patrones de expresión regular separados por comas con los que se compara la dirección IP del cliente. Si se especifica esta propiedad, la dirección remota no debe coincidir para que se acepte esta solicitud. Si no se especifica esta propiedad, la aceptación de la solicitud se regula sólo por medio de la propiedad allowRemoteAddress
.
allowRemoteHost
Especifica una lista de patrones de expresión regular separados por comas que se compara con el nombre de host del cliente remoto (devuelto por [java.net.]Socket.getInetAddress().getHostName()
). Si se especifica esta propiedad, el nombre de host remoto debe coincidir para que se acepte esta solicitud. Si no se especifica esta propiedad, se aceptan todas las solicitudes a menos que el nombre de host remoto coincida con un patrón denyRemoteHost
.
denyRemoteHost
Especifica una lista de patrones de expresión regular separados por comas que se compara con el nombre de host del cliente remoto (devuelto por [java.net.]Socket.getInetAddress().getHostName()
). Si se especifica esta propiedad, el nombre de host remoto no debe coincidir para que se acepte esta solicitud. Si no se especifica esta propiedad, la aceptación de la solicitud se regula sólo por medio de la propiedad allowRemoteHost
.
La definición de esta propiedad no tiene ningún efecto si se accede al dominio de GlassFish Server a través del listener de red que tiene activada la opción Listener JK.
authRealm
Especifica el nombre de un dominio de autenticación que sustituye el dominio por defecto de la instancia del servidor para las aplicaciones web independientes desplegadas en este servidor virtual. Un dominio definido en el archivo web.xml
de una aplicación web independiente sustituye al dominio del servidor virtual. Para obtener más información, consulte Dominios.
securePagesWithPragma
Defina esta propiedad en false
para garantizar que todas las aplicaciones web de las descargas de archivos de este servidor virtual que utilicen SSL funcionen correctamente en Internet Explorer.
Las aplicaciones web individuales pueden sustituir esta configuración utilizando el elemento sun-web-app
del archivo sun-web.xml.
Para obtener más información, consulte glassfish-web-app en Oracle GlassFish Server Application Deployment Guide.
El valor por defecto es true
.
alternatedocroot_
nEspecifica una raíz de documento alternativa (raíz de documento), donde n es un entero positivo que permite la especificación de más de uno. Las raíces de documento alternativas permiten que las aplicaciones web sirven solicitudes para ciertos recursos desde fuera de su propia raíz de documento, en función de si dichas solicitudes coinciden o no con uno (o más) de los patrones URI de las raíces de documento alternativas de la aplicación web.
Si una solicitud coincide con el patrón URI de la raíz de documento alternativa, se asigna agregando la solicitud URI (menos la raíz de contexto de la aplicación web) a la ubicación física de la raíz de documento alternativa (directorio). Si una solicitud coincide con varios patrones URI, se determina la raíz de documento alternativa según el orden especificado anteriormente:
Coincidencia exacta
Ruta de acceso de coincidencia más larga
Coincidencia de extensión
Por ejemplo, las siguientes propiedades especifican tres raíces de documento alternativas. El patrón de URI de la primera raíz de documento alternativa utiliza una coincidencia exacta, mientras que los patrones URI de la segunda y tercera raíces de documento alternativas usan una extensión y coincidencias del prefijo de la ruta de acceso más larga, respectivamente.
<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"
El value
de cada raíz de documento alternativa posee dos componentes: el primero, from
, especifica el patrón URI de la raíz de documento alternativa, y el segundo, dir
, especifica la ubicación física de la raíz de documento alternativa (directorio). Se permiten espacios en el componente dir
.
Las aplicaciones web individuales pueden sustituir esta configuración utilizando el elemento sun-web-app
del archivo sun-web.xml.
Para obtener más información, consulte glassfish-web-app en Oracle GlassFish Server Application Deployment Guide.
contextXmlDefault
Especifica la ubicación, con respecto a domain-dir del archivo context.xml
de este servidor virtual, si se utiliza uno. Para obtener más información sobre el archivo context.xml
, consulte la sección sobre el contenedor de contexto (http://tomcat.apache.org/tomcat-5.5-doc/config/context.html
).
allowLinking
Si está propiedad es true
, se servirán los recursos que son enlaces simbólicos para todas las aplicaciones web desplegadas en este servidor virtual. Las aplicaciones web individuales pueden sustituir esta configuración utilizando la propiedad allowLinking
de sun-web-app
en el archivo sun-web.xml
:
<sun-web-app> <property name="allowLinking" value="{true|false}" </sun-web-app>
Para obtener más información, consulte glassfish-web-app en Oracle GlassFish Server Application Deployment Guide.
El valor por defecto es false
.
Atención:
La definición de esta propiedad como true en los sistemas Windows expone el código fuente JSP.send-error_
nEspecifica las asignaciones de la página de errores personalizados para el servidor virtual, que heredan todas las aplicaciones web desplegadas en el servidor virtual. Una aplicación web puede sustituir estas asignaciones de páginas de errores personalizadas en su descriptor de despliegue web.xml
. El valor de cada propiedad send-error_
n posee tres componentes, que pueden especificarse en cualquier orden:
El primer componente, code
, especifica el código de estado de la respuesta HTTP de tres dígitos para el que la página de errores personalizados debería devolverse como respuesta.
El segundo componente path
, especifica la ruta de acceso absoluta o relativa del sistema de archivos de la página de errores personalizados. Una ruta de acceso del sistema de archivos relativa se interpreta como relativa con respecto al directorio /config
de domain-dir
El tercer componente, reason
, es opcional y especifica el texto de la cadena razón (como, por ejemplo Unauthorized
o Forbidden
) que se debe devolver.
Por ejemplo:
<property name="send-error_1" value="code=401 path=/myhost/401.html reason=MY-401-REASON"
Este ejemplo de definición de la propiedad provoca que se devuelva el contenido de /myhost/401.html
con las respuestas 401, junto con la línea de respuesta:
HTTP/1.1 401 MY-401-REASON
redirect_
nEspecifica que una solicitud de una URL antigua de trata como una solicitud de una URL nueva. Todas las aplicaciones web desplegadas en el servidor virtual heredan estas propiedades. El valor de cada propiedad redirect_
n posee dos componentes, que pueden especificarse en cualquier orden:
El primer componente, from
, especifica el prefijo de la URI cuya coincidencia se solicita.
El segundo componente, url-prefix
, especifica el nuevo prefijo de URL para devolverlo al cliente. El prefijo from
se sustituye simplemente con este prefijo de URL.
Por ejemplo:
<property name="redirect_1" value="from=/dummy url-prefix=http://etude"
valve_
nEspecifica un nombre de clase completamente cualificado de una válvula personalizada, donde n es un número entero positivo que permite especificación de más de uno. La clase de válvula debe implantar la interfaz org.apache.catalina.Valve
de Tomcat o de versiones anteriores de GlassFish Server, o la interfaz org.glassfish.web.valve.GlassFishValve
de la versión actual de GlassFish Server. Por ejemplo:
<property name="valve_1" value="org.glassfish.extension.Valve"
Puede configurar esta propiedad para una determinada aplicación web. Para obtener más información, consulte glassfish-web-app en Oracle GlassFish Server Application Deployment Guide.
listener_
nEspecifica un nombre de clase completo de un listener Catalina personalizado, donde n es un número entero positivo que permite la especificación de más de uno. La clase de listener debe implantar la interfaz org.apache.catalina.ContainerListener
o org.apache.catalina.LifecycleListener
. Por ejemplo:
<property name="listener_1" value="org.glassfish.extension.MyLifecycleListener"
Puede configurar esta propiedad para una determinada aplicación web. Para obtener más información, consulte glassfish-web-app en Oracle GlassFish Server Application Deployment Guide.
errorReportValve
Especifica un nombre de clase completamente cualificado de una válvula personalizada que genera páginas de error por defecto para aplicaciones en este servidor virtual. Especifique una cadena vacía para desactivar el mecanismo de páginas de error por defecto para este servidor virtual.