가상 서버에 사용할 수 있는 추가 속성은 다음과 같습니다.
sso-max-inactive-seconds
클라이언트 작업이 수신되지 않을 경우 사용자의 Single Sign-On 레코드를 제거할 수 있는 경과 시간(초 단위)을 지정합니다. Single Sign-On은 같은 가상 서버에 있는 여러 응용 프로그램에 적용되므로 응용 프로그램 중 하나에 액세스하면 Single Sign-On 레코드가 활성 상태를 유지합니다.
기본값은 300초(5분)입니다. 이 값이 높을수록 사용자에 대한 Single Sign-On 지속 시간이 길어지지만 서버의 메모리 사용량은 많아집니다.
sso-reap-interval-seconds
만료된 Single Sign-On 레코드의 제거 간격(초 단위)을 지정합니다.
기본값은 60입니다.
ssoCookieSecure
이 가상 서버에 배치된 웹 응용 프로그램과 연관된 JSESSIONIDSSO
쿠키의 Secure
속성을 설정합니다. 이 속성은 Single Sign-On을 사용으로 설정한 경우에만 적용됩니다. 허용되는 값은 다음과 같습니다.
true
Secure
를 true로 설정합니다.
false
Secure
를 false로 설정합니다.
dynamic
JSESSIONIDSSO
쿠키는 SSO에 참여하는 첫번째 세션의 Secure
설정을 상속합니다.
JSESSIONID
쿠키의 Secure 속성을 설정하려면 sun-web.xml
파일에서 cookieSecure
cookie-properties
속성을 사용합니다. 자세한 내용은 Oracle GlassFish Server Application Deployment Guide의 cookie-properties를 참조하십시오.
setCacheControl
Cache-Control
응답 지시어의 콤마로 구분된 목록을 지정합니다. 적합한 지시어 목록은 http://www.ietf.org/rfc/rfc2616.txt (http://www.ietf.org/rfc/rfc2616.txt
)에 있는 문서의 Section 14.9를 참조하십시오.
accessLogBufferSize
액세스 로그 호출이 저장되는 버퍼의 크기(바이트)를 지정합니다. 값이 5120보다 작으면 경고 메시지가 표시되고 값이 5120으로 설정됩니다. 기본값은 32768입니다.
accessLogWriterInterval
로그가 디스크에 기록되기 전까지의 시간(초)을 지정합니다. 액세스 로그는 버퍼가 가득 차거나 간격이 만료되면 기록됩니다. 값이 0이면 버퍼가 가득 차지 않더라도 항상 기록됩니다. 즉, 서버에 액세스할 때마다 로그 메시지가 직접 파일에 저장됩니다. 기본값은 300입니다.
allowRemoteAddress
원격 클라이언트의 IP 주소를 비교하는 정규 표현식 패턴의 콤마로 구분된 목록을 지정합니다. 이 속성이 지정된 경우 요청이 승인되려면 원격 주소가 반드시 일치해야 합니다. 이 속성이 지정되지 않은 경우에는 원격 주소가 denyRemoteAddress
패턴과 일치하지 않는 한 모든 요청이 승인됩니다.
denyRemoteAddress
원격 클라이언트의 IP 주소를 비교하는 정규 표현식 패턴의 콤마로 구분된 목록을 지정합니다. 이 속성이 지정된 경우 요청이 승인되려면 원격 주소가 이 요청과 일치하지 않아야 합니다. 속성이 지정되지 않은 경우에는 allowRemoteAddress
속성에 따라서만 요청 승인 여부가 결정됩니다.
allowRemoteHost
원격 클라이언트의 호스트 이름([java.net.]Socket.getInetAddress().getHostName()
에서 반환됨)과 비교될 콤마로 구분된 정규 표현식 패턴 목록을 지정합니다. 이 속성이 지정된 경우 요청이 승인되려면 원격 호스트 이름이 반드시 일치해야 합니다. 이 속성이 지정되지 않은 경우에는 원격 호스트 이름이 denyRemoteHost
패턴과 일치하지 않는 한 모든 요청이 승인됩니다.
denyRemoteHost
원격 클라이언트의 호스트 이름([java.net.]Socket.getInetAddress().getHostName()
에서 반환됨)과 비교될 콤마로 구분된 정규 표현식 패턴 목록을 지정합니다. 이 속성이 지정된 경우 요청이 승인되려면 원격 호스트 이름이 이 요청과 일치하지 않아야 합니다. 속성이 지정되지 않은 경우에는 allowRemoteHost
속성에 따라서만 요청 승인 여부가 결정됩니다.
JK 리스너 옵션을 사용하는 네트워크 리스너를 통해 GlassFish Server 도메인에 액세스하는 경우에는 이 속성을 설정해도 효과가 없습니다.
authRealm
이 가상 서버에 배치된 독립형 웹 응용 프로그램의 서버 인스턴스 기본 영역을 대체하는 인증 영역의 이름을 지정합니다. 독립형 웹 응용 프로그램의 web.xml
파일에 정의된 영역은 가상 서버의 영역을 대체합니다. 자세한 내용은 영역을 참조하십시오.
securePagesWithPragma
이 가상 서버에 있는 모든 웹 응용 프로그램이 Internet Explorer에서 SSL을 통해 제대로 다운로드되게 하려면 이 속성을 false
로 설정합니다.
개별 웹 응용 프로그램에서는 sun-web.xml
파일의 sun-web-app
요소를 사용하여 이 설정을 대체할 수 있습니다. 자세한 내용은 Oracle GlassFish Server Application Deployment Guide의 glassfish-web-app를 참조하십시오.
기본값은 true
입니다.
alternatedocroot_
n대체 문서 루트(docroot)를 지정합니다. 여기서 n은 값을 두 개 이상 지정할 수 있게 해 주는 양의 정수입니다. 대체 docroot를 사용하면 웹 응용 프로그램의 대체 docroot에 있는 URI 패턴 하나 이상과 요청이 일치하는지 여부에 따라 docroot 외부에서 오는 몇몇 리소스 요청을 처리할 수 있습니다.
요청이 대체 docroot의 URI 패턴과 일치하면 대체 docroot의 실제 위치(디렉토리)에 요청 URI(웹 응용 프로그램의 컨텍스트 루트는 제외)를 추가하여 대체 docroot에 매핑됩니다. 요청이 여러 URI 패턴과 일치하는 경우에는 다음과 같은 우선순위에 따라 대체 docroot가 결정됩니다.
정확하게 일치
가장 긴 경로 일치
확장자 일치
예를 들어 다음 속성은 세 개의 대체 docroot를 지정합니다. 첫번째 대체 docroot의 URI 패턴에서는 정확하게 일치를 사용하고, 두번째 및 세번째 대체 docroot의 URI 패턴에서는 확장자와 가장 긴 경로 일치를 각각 사용합니다.
<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"
각 대체 docroot의 value
에는 두 가지 구성 요소가 있습니다. 첫번째 구성 요소인 from
은 대체 docroot의 URI 패턴을 지정하고 두번째 구성 요소인 dir
은 대체 docroot의 실제 위치(디렉토리)를 지정합니다. dir
구성 요소에는 공백을 사용할 수 있습니다.
개별 웹 응용 프로그램에서는 sun-web.xml
파일의 sun-web-app
요소를 사용하여 이 설정을 대체할 수 있습니다. 자세한 내용은 Oracle GlassFish Server Application Deployment Guide의 glassfish-web-app를 참조하십시오.
contextXmlDefault
이 가상 서버에 대해 context.xml
파일을 사용하는 경우 domain-dir에 대한 상대 위치를 지정합니다. context.xml
파일에 대한 자세한 내용은 The Context Container(http://tomcat.apache.org/tomcat-5.5-doc/config/context.html
)를 참조하십시오.
allowLinking
true
이면 기호 링크인 리소스가 이 가상 서버에 배치된 모든 웹 응용 프로그램에 대해 작동합니다. sun-web.xml
파일의 sun-web-app
속성 allowLinking
을 사용하여 개별 웹 응용 프로그램이 이 설정을 대체할 수 있습니다.
<sun-web-app> <property name="allowLinking" value="{true|false}" </sun-web-app>
자세한 내용은 Oracle GlassFish Server Application Deployment Guide의 glassfish-web-app를 참조하십시오.
기본값은 false
입니다.
주의:
Windows 시스템에서 이 속성을 true로 설정하면 JSP 소스 코드가 노출됩니다.send-error_
n가상 서버에 배치된 모든 웹 응용 프로그램에서 상속하는 가상 서버의 사용자 정의 오류 페이지 매핑을 지정합니다. 웹 응용 프로그램에서는 web.xml
배치 기술자에서 이러한 사용자 정의 오류 페이지 매핑을 대체할 수 있습니다. 각 send-error_
n 속성의 값에는 세 가지 구성 요소가 있으며 각각 어떤 순서로든 지정할 수 있습니다.
첫번째 구성 요소인 code
는 응답에 사용자 정의 오류 페이지를 반환하는 세 가지 HTTP 응답 상태 코드를 지정합니다.
두번째 구성 요소인 path
는 사용자 정의 오류 페이지의 절대 또는 상대 파일 시스템 경로를 지정합니다. 상대 파일 시스템 경로는 domain-dir/config
디렉토리에 상대적인 값으로 해석됩니다.
세번째 구성 요소인 reason
은 선택적이며 Unauthorized
또는 Forbidden
과 같이 반환되는 이유 문자열의 텍스트를 지정합니다.
예를 들면 다음과 같습니다.
<property name="send-error_1" value="code=401 path=/myhost/401.html reason=MY-401-REASON"
이 예제 속성 정의에서는 다음 응답 행과 함께 401 응답과 /myhost/401.html
의 내용이 반환되게 만듭니다.
HTTP/1.1 401 MY-401-REASON
redirect_
n이전 URL에 대한 요청이 새 URL에 대한 요청으로 처리되도록 지정합니다. 가상 서버에 배치되는 모든 웹 응용 프로그램에서 이 속성을 상속합니다. 각 redirect_
n 속성의 값에는 두 가지 구성 요소가 있으며 각각 어떤 순서로든 지정할 수 있습니다.
첫번째 구성 요소인 from
은 일치시킬 요청한 URI의 접두어를 지정합니다.
두번째 구성 요소인 url-prefix
는 클라이언트에 반환할 새 URL 접두어를 지정합니다. from
접두어는 이 URL 접두어로 대체됩니다.
예를 들면 다음과 같습니다.
<property name="redirect_1" value="from=/dummy url-prefix=http://etude"
valve_
n사용자 정의 밸브의 정규화된 클래스 이름을 지정합니다. 여기서 n은 둘 이상의 사양을 허용하는 양의 정수입니다. 밸브 클래스는 Tomcat 또는 이전 GlassFish Server 릴리스의 org.apache.catalina.Valve
인터페이스 또는 현재 GlassFish Server 릴리스의 org.glassfish.web.valve.GlassFishValve
인터페이스를 구현해야 합니다. 예를 들면 다음과 같습니다.
<property name="valve_1" value="org.glassfish.extension.Valve"
특정 웹 응용 프로그램에 대해 이 속성을 설정할 수 있습니다. 자세한 내용은 Oracle GlassFish Server Application Deployment Guide의 glassfish-web-app를 참조하십시오.
listener_
n사용자 정의 Catalina 리스너의 정규화된 클래스 이름을 지정합니다. 여기서 n은 둘 이상의 사양을 허용하는 양의 정수입니다. 리스너 클래스는 org.apache.catalina.ContainerListener
또는 org.apache.catalina.LifecycleListener
인터페이스를 구현해야 합니다. 예를 들면 다음과 같습니다.
<property name="listener_1" value="org.glassfish.extension.MyLifecycleListener"
특정 웹 응용 프로그램에 대해 이 속성을 설정할 수 있습니다. 자세한 내용은 Oracle GlassFish Server Application Deployment Guide의 glassfish-web-app를 참조하십시오.
errorReportValve
가상 서버에서 응용 프로그램에 대한 기본 오류 페이지를 생성하는 사용자 지정 밸브의 정규화된 클래스 이름을 지정합니다. 빈 문자열을 지정하여 이 가상 서버에 대한 기본 오류 페이지 방식을 사용 안함으로 설정합니다.