As propriedades a seguir adicionais estão disponíveis para um servidor virtual.
sso-max-inactive-seconds
Especifica o número de segundos após o qual o registro de sign-on único de um usuário se torna qualificado para expurgação, caso nenhuma atividade do cliente seja recebida. Como o single sign-on é aplicável em várias aplicações no mesmo servidor virtual, o acesso a qualquer um das aplicações mantém ativo o registro de sign-on único.
O valor default é 300 segundos (5 minutos). Valor mais altos fornecem uma persistência mais longa de sign-on único para os usuários, porém, exige um uso de memória maior no servidor.
sso-reap-interval-seconds
Especifica o número de segundos entre as expurgações de registros de sign-on único expirados.
O valor default é 60.
ssoCookieSecure
Define o atributo Secure
de quaisquer cookies JSESSIONIDSSO
associados às aplicações Web implantadas para esse servidor virtual. Essa propriedade só se aplicará se o sign-on único estiver ativado. Os valores permitidos são como segue:
true
Define Secure
como verdadeiro.
false
Define Secure
como falso.
dynamic
O cookie JSESSIONIDSSO
herda a definição Secure
da primeira sessão participando no SSO.
Para definir um atributo Secure de um cookie JSESSIONID
, use a propriedade cookieSecure
cookie-properties
no arquivo sun-web.xml
. Para obter mais detalhes, consultecookie-properties em Oracle GlassFish Server Application Deployment Guide.
setCacheControl
Especifica uma lista separada por vírgulas de diretivas de resposta Controle por Cache
. Para obter uma lista de diretivas válidas, consulte Section 14.9 do documento em http://www.ietf.org/rfc/rfc2616.txt (http://www.ietf.org/rfc/rfc2616.txt
).
accessLogBufferSize
Especifica o tamanho em bytes do buffer onde as chamadas de log de acesso são armazenadas. Se o valor for menor do que 5.120, uma mensagem de advertência será emitida, e o valor é definido como 5.120. O valor default é 32.768.
accessLogWriterInterval
Especifica o número de segundos antes que o log seja gravado no disco. O log de acesso é gravado quando o buffer está cheio ou quando o intervalo expira. Se o valor é 0, o buffer é sempre gravado mesmo que não esteja cheio. Isso significa que, a cada vez que o servidor é acessado, a mensagem de log é armazenada diretamente no arquivo. O valor default é 300.
allowRemoteAddress
Especifica uma lista separada por vírgulas de padrões de expressões regulares, em relação a qual o endereço IP do cliente remoto é comparado. Se essa propriedade for especificada. o endereço remoto deverá coincidir para que a solicitação seja aceita. Se a propriedade não for especificada, todas as solicitações serão aceitas, a menos que o endereço remoto coincida com o padrão denyRemoteAddress
.
denyRemoteAddress
Especifica uma lista separada por vírgulas de padrões de expressões regulares, em relação a qual o endereço IP do cliente remoto é comparado. Se essa propriedade for especificada. o endereço remoto não deverá coincidir para que a solicitação seja aceita. Se a propriedade não for especificada, a aceitação da solicitação será administrada exclusivamente pela propriedade allowRemoteAddress
.
allowRemoteHost
Especifica uma lista separada por vírgulas de padrões de expressões regulares aos quais o nome do host do cliente remoto (conforme retornado por [java.net.]Socket.getInetAddress().getHostName()
) é comparado. Se essa propriedade for especificada. o nome de host remoto deverá coincidir para que a solicitação seja aceita. Se a propriedade não for especificada, todas as solicitações serão aceitas, a menos que o nome de host remoto coincida com o padrão denyRemoteHost
.
denyRemoteHost
Especifica uma lista separada por vírgulas de padrões de expressões regulares aos quais o nome do host do cliente remoto (conforme retornado por [java.net.]Socket.getInetAddress().getHostName()
) é comparado. Se essa propriedade for especificada. o nome de host remoto não deverá coincidir para que a solicitação seja aceita. Se a propriedade não for especificada, a aceitação da solicitação será administrada exclusivamente pela propriedade allowRemoteHost
.
A definição desta propriedade não tem efeito se o domínio do GlassFish Server é acessado através de um listener de rede que tenha a opção Interpretador JK ativada.
authRealm
Especifica o nome de um realm de autenticação, que substitui o realm default da instância do servidor por aplicações Web standalone implantadas neste servidor virtual. Um realm definido no arquivo web.xml
de uma aplicação da web standalone substitui o realm do servidor virtual. Para obter mais informações, consulte Realms .
securePagesWithPragma
Defina essa propriedade como falso
para garantir que todas as aplicações Web em downloads de arquivos do servidor virtual, usando SSL, funcionem adequadamente no Internet Explorer.
aplicações Web individuais podem substituir essa definição, usando o elemento sun-web-app
do arquivo sun-web.xml
. Para obter mais detalhes, consulte glassfish-web-app em Oracle GlassFish Server Application Deployment Guide.
O valor default é true
.
alternatedocroot_
nEspecifica uma raiz de documento alternativa (docroot), onde n é um inteiro positivo que permite a especificação de mais de um. Docroots alternativas permite que as aplicações da Web atendam solicitações de determinados recursos externos à própria docroot, dependendo de tais solicitações corresponderem a um (ou mais) dos padrões URI das docroots alternativas da aplicação Web.
Se uma solicitação corresponder a um padrão URI da docroot alternativa, ela será mapeada para uma docroot alternativa, acrescentando o URI da solicitação (menos a raiz de contexto da aplicação Web) à localização física (diretório) da docroot alternativa. Se uma solicitação corresponder a vários padrões URI, a docroot alternativa será determinada de acordo com esta ordem de precedência:
Correspondência exata
Correspondência de caminho mais longo
Correspondência de extensão
Por exemplo, as seguintes propriedades especificam três docroots alternativas: O padrão URI da primeira docroot alternativa usa uma correspondência exata, ao passo que os padrões URI da segunda e terceira docroots alternativas usam correspondências de prefixo de extensão e caminho mais longo, 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"
O valor
de cada docroot alternativa tem dois componentes: o primeiro componente, de
, especifica o padrão URI da docroot alternativa; o seguindo componente, dir
, especifica a localização física (diretório) da docroot alternativa. Espaços são permitidos no componente dir
.
aplicações Web individuais podem substituir essa definição, usando o elemento sun-web-app
do arquivo sun-web.xml
. Para obter mais detalhes, consulte glassfish-web-app em Oracle GlassFish Server Application Deployment Guide.
contextXmlDefault
Especifica a localização, relativa ao domain-dir do arquivo context.xml
para este servidor virtual, se utilizado. Para obter mais informações sobre o arquivo context.xml
, consulte o Contêiner de Contexto (http://tomcat.apache.org/tomcat-5.5-doc/config/context.html
).
allowLinking
Se true
, os recursos que forem links simbólicos serão atendidos por todas as aplicações Web implantadas no servidor virtual. aplicações Web individuais podem substituir essa definição, usando a propriedade sun-web-app
allowLinking
do arquivo sun-web.xml
:
<sun-web-app> <property name="allowLinking" value="{true|false}" </sun-web-app>
Para obter mais detalhes, consulte glassfish-web-app em Oracle GlassFish Server Application Deployment Guide.
O valor default é false
.
Cuidado:
A definição desta propriedade como verdadeira nos sistemas Windows expõe o código de origem JSP.send-error_
nEspecifica mapeamentos de páginas personalizadas de erros para o servidor virtual, os quais são herdados por todas as aplicações implantadas no servidor virtual. Uma aplicação Web pode substituir esses mapeamentos de páginas personalizadas de erros no respectivo descritor de implantação web.xml
. O valor de cada propriedade send-error_
n tem três componentes, que podem ser especificados em qualquer ordem:
O primeiro componente, code
, especifica o código de três dígitos do status de resposta HTTP para o qual a página de erro personalizada deve ser retornada na resposta.
O segundo componente, path
, especifica o caminho absoluto ou relativo do sistema de arquivos da página de erro personalizada. Um caminho relativo de sistema de arquivos é interpretado como relativo no diretório domain-dir/config
.
O terceiro componente, reason
, é opcional e especifica o texto da string de motivo (por exemplo, Unauthorized
ou Forbidden
) a ser retornado.
Por exemplo:
<property name="send-error_1" value="code=401 path=/myhost/401.html reason=MY-401-REASON"
Este exemplo de definição da propriedade faz com que o conteúdo de /myhost/401.html
seja retornado com 401 respostas, junto dessa linha de respostas:
HTTP/1.1 401 MY-401-REASON
redirect_
nEspecifica que uma solicitação para um URL antigo seja tratado como uma solicitação para um novo URL. Essas propriedades são herdadas por todas as aplicações Web implantadas no servidor virtual. O valor de cada propriedade de redirect_
n tem dois componentes, que podem ser especificados em qualquer ordem:
O primeiro componente, from
, especifica o prefixo do URI solicitado cuja correspondência deve ser localizada.
O segundo componente, url-prefix
, especifica o prefixo do novo URL a ser retornado para o cliente. O prefixo from
é simplesmente substituído por esse prefixo de URL.
Por exemplo:
<property name="redirect_1" value="from=/dummy url-prefix=http://etude"
valve_
nEspecifica um nome de classe totalmente qualificada de uma válvula personalizada, onde n é um inteiro positivo que permite a especificação de mais de um. A classe da válvula deve implementar a interface org.apache.catalina.Valve
do Tomcat ou versões anteriores do GlassFish Server ou da interface org.glassfish.web.valve.GlassFishValve
da versão atual do GlassFish Server. Por exemplo:
<property name="valve_1" value="org.glassfish.extension.Valve"
Você pode definir esta propriedade para uma aplicação Web específica. Para obter mais detalhes, consulte glassfish-web-app em Oracle GlassFish Server Application Deployment Guide.
listener_
nEspecifica um nome de classe totalmente qualificada de um listenter Catalina personalizado, em que n é um positivo inteiro que permite especificar mais de uma. A classe de listener deve implementar a interface org.apache.catalina.ContainerListener
ou org.apache.catalina.LifecycleListener
. Por exemplo:
<property name="listener_1" value="org.glassfish.extension.MyLifecycleListener"
Você pode definir esta propriedade para uma aplicação Web específica. Para obter mais detalhes, consulte glassfish-web-app em Oracle GlassFish Server Application Deployment Guide.
errorReportValve
Especifica um nome de classe totalmente qualificado de uma válvula personalizada que cria páginas de erro default para as aplicações deste servidor virtual. Especifique uma string vazia para desativar o mecanismo da página de erro default deste servidor virtual.