Las siguientes propiedades adicionales están disponibles para un servidor virtual.
Especifica el número de segundos después de los cuales el registro de inicio de sesión único de un usuario cumple con los requisitos necesarios para depurarse si no se detecta actividad en el cliente. Dado que el inicio de sesión único se aplica en varias aplicaciones en el mismo servidor virtual, el acceso a cualquiera de las aplicaciones mantiene activo el registro de inicio de sesión único.
El valor predeterminado es 300 segundos (5 minutos). Los valores más altos proporcionan una persistencia de inicio de sesión único más larga para los usuarios a costa de un mayor consumo de memoria en el servidor.
Especifica el número de segundos entre depuraciones de registros de inicio de sesión único caducados.
El valor predeterminado es 60.
Establece el atributo Secure de cualquier cookie JSESSIONIDSSO asociada a las aplicaciones web implementadas en este servidor virtual. Esta propiedad sólo se aplica si se habilita el inicio de sesión único. Los valores permitidos son los siguientes:
Establece Secure en true.
Establece Secure en false.
La cookie JSESSIONIDSSO hereda el valor Secure de la primera sesión que participa en el SSO.
Para establecer 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 de Oracle GlassFish Server 3.1 Application Deployment Guide.
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 .
Especifica el tamaño (en bytes) del búfer en el que se almacenan las llamadas de registro de acceso. Si el valor es inferior a 5120, se muestra un mensaje de advertencia y el valor se establece en 5120. El valor predeterminado es 32768.
Especifica el número de segundos antes de que el registro se escriba en el disco. El registro de acceso se escribe cuando el búfer está lleno o cuando caduca el intervalo. Si el valor es 0, el búfer siempre se escribirá aunque no esté lleno. Esto significa que cada vez que se accede al servidor, el mensaje de registro se almacena directamente en el archivo. El valor predeterminado es 300.
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.
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.
Especifica una lista de patrones de expresión regular separados por comas que el nombre del sistema del cliente remoto (devuelto por [java.net.]Socket.getInetAddress().getHostName() ) con el que se compara. Si se especifica esta propiedad, el nombre del 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 del host remoto coincida con un patrón denyRemoteHost.
Especifica una lista de patrones de expresión regular separados por comas que el nombre del sistema del cliente remoto (devuelto por [java.net.]Socket.getInetAddress().getHostName() ) con el que se compara. Si se especifica esta propiedad, el nombre del 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 configuración de esta propiedad no tiene ningún efecto si se accede al dominio de GlassFish Server a través de la escucha de red que tiene habilitada la opción Escucha JK.
Especifica el nombre de un dominio de autenticación que anula el dominio predeterminado de la instancia del servidor para las aplicaciones web independientes implementadas en este servidor virtual. Un dominio definido en el archivo web.xml de una aplicación web independiente reemplaza al dominio del servidor virtual. Para obtener más información, consulte Dominios.
Establezca 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 reemplazar esta configuración utilizando el elemento sun-web-app del archivo sun-web.xml. Para obtener más información, consulte glassfish-web-app de Oracle GlassFish Server 3.1 Application Deployment Guide.
El valor predeterminado es verdadero.
Especifica una raíz de documento alternativa (docroot), donde n es un entero positivo que permite la especificación de más de uno. Los docroots alternativos permiten que las aplicaciones web atiendan solicitudes para ciertos recursos desde fuera de su propio docroot, en función de si dichas solicitudes coinciden o no con uno (o más) de los patrones URI de los docroots alternativos de la aplicación web.
Si una solicitud coincide con el patrón URI del docroot alternativo, se asigna agregando la solicitud URI (menos la raíz de contexto de la aplicación web) a la ubicación física del docroot alternativo (directorio). Si una solicitud coincide con varios patrones URI, se determina el docroot alternativo según el orden especificado anteriormente:
Coincidencia exacta
Ruta de coincidencia más larga
Coincidencia de extensión
Por ejemplo, las siguientes propiedades especifican tres docroots diferentes. El patrón de URI del primer docroot alternativo utiliza una coincidencia exacta, mientras que los patrones URI del segundo y tercer docroots alternativos usan una extensión y coincidencias del prefijo de la ruta 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 docroot alternativo posee dos componentes: el primero, from, especifica el patrón URI del docroot alternativo, y el segundo, dir, especifica la ubicación física del docroot alternativo (directorio). Se permiten espacios en el componente dir.
Las aplicaciones Web individuales pueden reemplazar esta configuración utilizando el elemento sun-web-app del archivo sun-web.xml. Para obtener más información, consulte glassfish-web-app de Oracle GlassFish Server 3.1 Application Deployment Guide.
Especifica la ubicación, relativa a domain-dir, del archivo context.xml de este servidor virtual, si se utiliza uno. Para obtener más información sobre el archivocontext.xml, consulte Contenedor de contexto.
Si está propiedad es true, se atenderán los recursos que son vínculos simbólicos para todas las aplicaciones web implementadas en este servidor virtual. Las aplicaciones Web individuales pueden reemplazar 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 de Oracle GlassFish Server 3.1 Application Deployment Guide.
El valor predeterminado es falso.
Precaución - La configuración de esta propiedad como true en los sistemas Windows expone el código fuente JSP.
Especifica las asignaciones de la página de errores personalizados para el servidor virtual, que se heredan por todas las aplicaciones implementadas en el servidor virtual. Una aplicación web puede anular estas asignaciones de páginas de errores personalizadas en su descriptor de implementación 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 absoluta o relativa del sistema de archivos de la página de errores personalizados. Una ruta del sistema de archivos relativa se interpreta como relativa al directorio domain-dir/config.
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"/>
Esta definición de la propiedad example 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
Especifica que una solicitud de una URL antigua de trata como una solicitud de una URL nueva. Todas las aplicaciones web implementadas heredan estas propiedades del servidor virtual. 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"/>
Especifica un nombre de clase completo 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 implementar la interfaz org.apache.catalina.Valve de Tomcat o versiones anteriores de GlassFish Server, o bien 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 de Oracle GlassFish Server 3.1 Application Deployment Guide.
Especifica un nombre de clase completo de una escucha Catalina personalizada, donde n es un número entero positivo que permite la especificación de más de uno. La clase listener deben implementar las interfaces org.apache.catalina.ContainerListener u 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 de Oracle GlassFish Server 3.1 Application Deployment Guide.
Especifica un nombre de clase completo de una válvula personalizada que genera páginas de error predeterminadas para aplicaciones en este servidor virtual. Especifique una cadena vacía para inhabilitar el mecanismo de páginas de error predeterminadas para este servidor virtual.