부록 B   HTTP/HTTPS 지원(엔터프라이즈판)

Sun™ ONE Message Queue (MQ) 엔터프라이즈판("제품 판" 참조)은 HTTP 및 HTTPS 연결을 모두 지원합니다. (HTTPS는 Secure Socket Layer 표준을 사용하는 HTTP상의 보안 연결입니다.) 이 지원을 사용하면 클라이언트 응용 프로그램에서 직접적인 TCP 연결 대신 HTTP 프로토콜을 사용하여 브로커와 통신할 수 있습니다. 이 부록에서는 이 지원의 구현에 사용되는 구조를 설명하고, 클라이언트에서 MQ 메시징에 HTTP 기반 연결을 사용할 때 필요한 설정 작업에 대해서도 설명합니다.

HTTP/HTTPS 지원 구조

---

MQ 메시징은 HTTP/HTTPS 연결 위에서 실행할 수 있습니다. HTTP/HTTPS 연결은 보통 방화벽을 통해서도 허용되기 때문에 이렇게 하면 방화벽으로 클라이언트 응용 프로그램과 브로커를 분리할 수 있습니다.

그림 B-1에서는 HTTP/HTTPS 지원과 관련된 주요 구성 요소를 보여줍니다.

• 클라이언트쪽에서는 HTTP 전송 드라이버가 MQ 메시지를 HTTP 요청으로 캡슐화하고 요청이 정확한 순서로 웹 서버에 전송되는지 확인합니다.
• JMS 클라이언트는 필요한 경우 HTTP 프록시 서버를 사용해서 브로커와 통신할 수 있습니다. 프록시의 주소는 클라이언트를 시작할 때 명령줄 옵션을 사용해서 지정합니다. 자세한 내용은 "HTTP 프록시 사용"을 참조하십시오.
• HTTP 또는 HTTPS 터널 서브릿(모두 MQ와 함께 제공)이 웹 서버에 로드되고 JMS 메시지를 브로커로 전달하기 전에 클라이언트 HTTP 요청으로부터 추출하는 데 사용됩니다. HTTP/HTTPS 터널 서브릿은 클라이언트에서 이루어진 HTTP 요청에 대한 응답으로 브로커 메시지를 클라이언트에 다시 보내는 작업도 수행합니다. 한 HTTP/HTTPS 터널 서브릿을 사용해서 여러 브로커에 액세스할 수 있습니다.

그림 B-1    HTTP/HTTPS 지원 구조

• 브로커쪽에서는 httpjms 또는 httpsjms 연결 서비스가 해당 터널 서브릿에서 들어오는 메시지를 분해하고 다중화를 해제합니다.
• 웹 서버가 오류로 다시 시작되면 모든 연결이 복원되며 클라이언트에는 아무 영향도 주지 않습니다. 브로커가 오류로 다시 시작되면 예외가 발생하며 클라이언트는 연결을 다시 설정해야 합니다. 드물기는 하지만, 웹 서버와 브로커에 모두 오류가 발생하고 브로커가 다시 시작되지 않은 경우에는 웹 서버가 클라이언트 연결을 복원한 후 클라이언트에 알리지 않고 브로커 연결을 계속 기다릴 수 있습니다. 이런 상황을 방지하려면 항상 브로커를 다시 시작해야 합니다.

그림 B-1에서 알 수 있듯이, HTTP와 HTTPS가 지원하는 구조는 서로 매우 비슷합니다. 가장 큰 차이는 HTTPS (httpsjms 연결 서비스)의 경우 터널 서브릿이 클라이언트 응용 프로그램과 브로커 모두에 대해 보안 연결을 갖는다는 점입니다.

브로커에 대한 보안 연결은 MQ의 HTTPS 터널 서브릿에 해당하는 SSL 사용 터널 서브릿을 통해 제공되며 연결을 요청하는 모든 브로커에 자체 서명된 인증서를 전달합니다. 인증서는 브로커가 HTTPS 터널 서브릿에 대해 암호화된 연결을 설정할 때 사용합니다. 이 연결이 설정되고 나면 클라이언트 응용 프로그램과 웹 서버에서 클라이언트 응용 프로그램과 터널 서브릿 사이의 보안 연결을 처리할 수 있습니다.

HTTP 지원 구현

---

다음 절에서는 HTTP 지원을 구현하기 위해 수행해야 하는 단계에 대해 설명합니다.

HTTP 지원을 구현하는 방법

1. HTTP 터널 서브릿을 웹 서버에 배포합니다.
2. 브로커의 httpjms 연결 서비스를 구성하고 브로커를 시작합니다.
3. HTTP 연결을 구성합니다.

1단계. 웹 서버에 HTTP 터널 서브릿 배포

웹 서버에 HTTP 터널 서브릿을 배포하는 일반적인 방법에는 두 가지가 있습니다.

• jar 파일로 배포 - Servlet 2.1 이전 버전을 지원하는 웹 서버용
• 웹 아카이브(WAR) 파일로 배포 - Servlet 2.2 이상 버전을 지원하는 웹 서버용

Jar 파일로 배포

MQ 터널 서브릿 배포는 호스트 웹 서버에 액세스할 수 있는 적절한 jar 파일을 작성하고 시작 시 서브릿을 로드하도록 웹 서버를 구성하여 이루어집니다.

터널 서브릿 jar 파일(imqservlet.jar)은 HTTP 터널 서브릿에 필요한 모든 클래스를 포함하며 다음 디렉토리에 있습니다.

IMQ_HOME/lib (Solaris의 경우 /usr/share/lib/imq)

서브릿 2.x를 지원하는 모든 웹 서버를 사용하여 이 서브릿을 로드할 수 있습니다. 서브릿 클래스 이름은 다음과 같습니다.

com.sun.messaging.jmq.transport.
httptunnel.servlet.HttpTunnelServlet

웹 서버에서 imqservlet.jar 파일을 볼 수 있어야 합니다. 웹 서버와 브로커를 서로 다른 호스트에서 실행하려면 imqservlet.jar 파일의 복사본을 웹 서버에서 액세스할 수 있는 위치에 저장해야 합니다.

시작 시 이 서브릿을 로드하도록 웹 서버를 구성해야 합니다("예: HTTP 터널 서브릿 배포" 참조).

또한 성능 향상을 위해 웹 서버의 액세스 로깅 기능은 사용하지 않는 것이 좋습니다.

웹 아카이브 파일로 배포

HTTP 터널 서브릿을 WAR 파일로 배포하는 작업은 웹 서버에서 제공하는 메커니즘을 사용하여 수행합니다. HTTP 터널 서브릿 WAR 파일(imqhttp.war)은 다음 디렉토리에 있습니다.

IMQ_HOME/lib (Solaris의 경우 /usr/share/lib/imq)

WAR 파일에는 웹 서버에서 서브릿을 로드하여 실행하는 데 필요한 기본 구성 정보가 들어 있는 배포 설명자가 포함되어 있습니다.

2단계. httpjms 연결 서비스 구성

MQ 3.0.1 브로커에는 HTTP 지원이 기본적으로 사용되지 않기 때문에 httpjms 연결 서비스를 사용하도록 브로커를 재구성해야 합니다. 재구성한 경우 "브로커 시작"에 설명된 대로 브로커를 시작할 수 있습니다.

httpjms 연결 서비스를 사용하는 방법

1. 다음 위치에서 브로커의 인스턴스 구성 파일을 엽니다.

IMQ_VARHOME/instances/brokerName/props/config.properties
(Solaris의 경우 /var/imq/instances/brokerName/props/config.properties)

여기서 brokerName은 브로커 인스턴스의 이름입니다.

2. imq.service.activelist 등록 정보에 httpjms 값을 추가합니다.

imq.service.activelist=jms,admin,httpjms

브로커는 시작할 때 호스트 시스템에서 실행 중인 웹 서버와 HTTP 터널 서브릿을 찾습니다. 그러나 원격 터널 서브릿에 액세스하기 위해 servletHost 및 servletPort 연결 서비스 등록 정보를 재구성할 수 있습니다.

또한 성능 향상을 위해 pullPeriod 등록 정보를 재구성할 수도 있습니다. httpjms 연결 서비스 구성 등록 정보에 대한 자세한 설명은 표 B-1을 참조하십시오.

표 B-1    httpjms 연결 서비스 등록 정보 

등록 정보 이름	설명
imq.httpjms.http. servletHost	필요한 경우 이 값을 변경하여 HTTP 터널 서브릿을 실행하는 호스트의 이름(호스트 이름 또는 IP 주소)을 지정합니다(원격 호스트이거나 로컬 호스트의 특정 호스트 이름일 수 있음). 기본값: localhost
imq.httpjms.http. servletPort	이 값을 변경하여 브로커가 HTTP 터널 서브릿에 액세스하는 데 사용하는 포트 번호를 지정합니다(웹 서버에서 기본 포트를 변경한 경우 이 등록 정보를 적절히 변경해야 함). 기본값: 7675
imq.httpjms.http. pullPeriod	브로커에서 메시지를 가져오기 위해 각 클라이언트가 만든 HTTP 요청 사이의 간격(초)을 지정합니다. 값이 0 또는 음수인 경우 클라이언트는 하나의 HTTP 요청을 항상 보류 상태로 두고 가능한 빨리 메시지를 가져오도록 준비합니다. 클라이언트 수가 많은 경우 웹 서버 자원을 많이 사용하여 서버가 응답하지 않을 수 있습니다. 그런 경우 pullPeriod 등록 정보를 양수(초)로 설정해야 합니다. 이 등록 정보는 후속 가져오기 요청을 만들기 전에 클라이언트의 HTTP 전송 드라이버가 대기하는 시간을 설정합니다. 값을 양수로 설정하면 클라이언트가 응답 시간 동안 대기하는 대신 웹 서버 자원이 절약됩니다. 기본값: -1

3단계. HTTP 연결 구성

클라이언트 응용 프로그램에서는 제대로 구성된 연결 팩토리 관리 객체를 사용해서 브로커에 대한 HTTP 연결을 설정해야 합니다. 이 절에서는 HTTP 연결 구성 문제에 대해 논의합니다.

연결 팩토리 속성 설정

HTTP 지원을 구현하려면 다음 연결 팩토리 속성을 설정합니다("연결 팩토리 관리 객체" 참조).

• imqConnectionType 속성을 HTTP로 설정합니다.
• imqConnectionURL을 HTTP 터널 서브릿 URL로 설정합니다.

http://hostName:port/imq/tunnel

다음 방법 중 하나를 사용하여 연결 팩토리 속성을 설정할 수 있습니다.

• 연결 팩토리 관리 객체를 만드는 imqobjmgr 명령에 -o 옵션을 사용하거나("연결 팩토리 추가" 참조) 관리 콘솔(imqadmin)을 사용하여 연결 팩토리 관리 객체를 만들 때 속성을 설정합니다.
• 클라이언트 응용 프로그램을 시작하는 명령에 -D 옵션을 사용합니다(MQ Developer's Guide 참조).
• JMS API 호출을 사용하여 연결 팩토리를 클라이언트 응용 프로그램 코드에서 프로그래밍 방식으로 만든 후 해당 연결 팩토리의 속성을 설정합니다(MQ Developer's Guide 참조).

단일 서브릿을 사용하여 다중 브로커에 액세스

다중 브로커를 실행할 경우 다중 웹 서버 및 서브릿 인스턴스를 구성하지 않아도 됩니다. 동시에 실행 중인 브로커 간에 단일 웹 서버와 HTTP 터널 서브릿을 공유할 수 있습니다. 이를 위해 imqConnectionURL 연결 팩토리 속성을 다음과 같이 구성해야 합니다.

http://hostName:port/imq/tunnel?ServerName=hostName:brokerName

여기서 hostName은 브로커 호스트 이름이고 brokerName은 클라이언트가 액세스할 특정 브로커 인스턴스의 이름입니다.

hostName과 brokerName에 정확한 문자열을 입력했는지 확인하려면 브라우저에서 서브릿 URL에 액세스하여 HTTP 터널 서브릿의 상태 보고서를 생성합니다. 보고서에는 서브릿이 액세스하는 모든 브로커가 나열됩니다.

---

HTTP tunnel servlet ready. Servlet Start Time : Thu May 30 01:08:18 PDT 2002 Accepting TCP connections from brokers on port : 7675 Total available brokers = 2 Broker List :    jpgserv:broker2    cochin:broker1

---

HTTP 프록시 사용

HTTP 프록시를 사용해서 HTTP 터널 서브릿에 액세스하는 경우:

• http.proxyHost 시스템 등록 정보를 프록시 서버 호스트 이름으로 설정합니다.
• http.proxyPort 시스템 등록 정보를 프록시 서버 포트 번호로 설정합니다.

클라이언트 응용 프로그램을 시작하는 명령에 -D 옵션을 사용하여 이러한 등록 정보를 설정할 수 있습니다.

예: HTTP 터널 서브릿 배포

이 절에서는 Sun ONE WEB Server에서 HTTP 터널 서브릿을 jar 파일과 WAR 파일로 배포하는 방법을 모두 설명합니다. 사용 방법은 Sun ONE Web Server의 버전에 따라 다르지만, Servlet 2.2 이상 버전을 지원하지 않는 경우 WAR 파일 배포를 처리할 수 없습니다.

Jar 파일로 배포

다음은 브라우저 기반 관리 GUI를 사용하는 Sun ONE Web Server, FastTrack Edition 4.1에 배포 시의 참조 지침입니다. 이 절차는 다음과 같은 일반적인 단계로 구성됩니다.

1. 서브릿 추가
2. 서브릿 가상 경로 구성
3. 서브릿 로드
4. 서브릿 액세스 로그 비활성화

이러한 단계는 다음 하위 절에 설명되어 있습니다. 웹 브라우저를 사용하여 서브릿 URL에 액세스함으로써 HTTP 터널 서브릿 배포 성공 여부를 확인할 수 있습니다. 상태 정보를 표시해야 합니다.

서브릿 추가

터널 서브릿을 추가하는 방법

1. 서브릿 탭을 선택합니다.
2. 서브릿 속성 구성을 선택합니다.
3. 서브릿 이름 필드에 터널 서브릿의 이름을 지정합니다.
4. 서브릿 코드(클래스 이름) 필드를 다음 값으로 설정합니다.

com.sun.messaging.jmq.transport.
httptunnel.servlet.HttpTunnelServlet

5. 서브릿 클래스 경로 필드에 imqservlet.jar에 대한 전체 경로를 입력합니다. 예를 들면 다음과 같습니다.

IMQ_HOME/lib/imqservlet.jar
(Solaris의 경우 /usr/share/lib/imq/imqservlet.jar)

6. 서브릿 인수 필드에 표 B-2와 같은 선택 인수를 입력합니다.

표 B-2    HTTP 터널 서브릿 Jar 파일 배포에 사용되는 서브릿 인수

인수	기본값	참조
servletHost	모든 호스트	표 B-1 참조
servletPort	7675	표 B-1 참조

두 인수를 모두 사용하는 경우에는 인수 사이를 쉼표로 구분합니다.

servletPort=portnumber, servletHost=...

serverHost 및 serverPort 인수는 웹 서버와 브로커 간 통신에만 적용되며 기본값에 문제가 있는 경우에만 설정됩니다. 그런 경우에도 브로커 구성 등록 정보를 적절하게 설정해야 합니다(표 B-1 참조). 예를 들면 다음과 같습니다.

imq.httpjms.http.servletPort

서브릿 가상 경로(서브릿 URL) 구성

터널 서브릿에 대한 가상 경로(서브릿 URL)를 구성하는 방법

1. 서브릿 탭을 선택합니다.
2. 서브릿 가상 경로 변환 구성을 선택합니다.
3. 가상 경로 필드를 설정합니다.

예를 들어, URL을 http://hostName:port/imq/tunnel로 지정하려는 경우 가상 경로 필드에 다음 문자열을 입력합니다.

/imq/tunnel

4. 서브릿 이름 필드를 "서브릿 추가"의 3단계와 동일한 값으로 설정합니다.

서브릿 로드

웹 서버 시작 시 터널 서브릿을 로드하는 방법

1. 서브릿 탭을 선택합니다.
2. 전역 속성 구성을 선택합니다.
3. 시작 서브릿 필드에 "서브릿 추가"의 3단계와 동일한 서브릿 이름 값을 입력합니다.

서버 액세스 로그 비활성화

서버 액세스 로그를 비활성화할 필요는 없지만 그렇게 하면 성능이 향상됩니다.

서버 액세스 로그를 비활성화하는 방법

1. 상태 탭을 선택합니다.
2. 로그 기본 설정 페이지를 선택합니다.
3. 로그 클라이언트 액세스 제어를 사용하여 로깅을 비활성화합니다.

WAR 파일로 배포

다음은 Sun ONE Web Server 6.0 서비스 팩 2에 배포 시의 참조 지침입니다.
웹 브라우저를 사용하여 서브릿 URL에 액세스하면 HTTP 터널 서브릿의 배포 성공 여부를 확인할 수 있습니다. 상태 정보를 표시해야 합니다.

http 터널 서브릿을 WAR 파일로 배포하는 방법

1. 브라우저 기반 관리 GUI에서 가상 서버 클래스 탭을 선택한 후 클래스 관리를 선택합니다.
2. 해당 가상 서버 클래스 이름(예: defaultclass)을 선택하고 관리 버튼을 누릅니다.
3. 가상 서버 관리를 선택합니다.
4. 해당 가상 서버 이름을 선택하고 관리 버튼을 누릅니다.
5. 웹 응용 프로그램 탭을 선택합니다.
6. 웹 응용 프로그램 배포를 누릅니다.
7. WAR 파일 위치와 WAR 파일 경로 필드에서 imqhttp.war 파일을 가리키는 적절한 값을 선택합니다. 이 파일은 다음 디렉토리에 있습니다.

IMQ_HOME/lib (Solaris의 경우 /usr/share/lib/imq)

8. 응용 프로그램 URI 필드에 "/imq"(따옴표 없이)를 입력합니다.
9. 서브릿을 배포할 설치 디렉토리 경로(일반적으로 Sun ONE Web Server 설치 루트 아래)를 입력합니다.
10. 확인을 누릅니다.
11. 웹 서버 인스턴스를 다시 시작합니다.

이제 서브릿을 다음 주소에서 사용할 수 있습니다.

http://hostName:port/imq/tunnel

이제 클라이언트에서 이 URL을 통해 HTTP 연결을 사용하는 메시지 서비스에 연결할 수 있습니다.

HTTPS 지원 구현

---

다음 절에서는 HTTPS 지원을 구현하기 위해 수행해야 하는 단계에 대해 설명합니다. "HTTP 지원 구현"과 비슷한 내용에 SSL 인증서 생성 및 액세스에 필요한 단계가 추가되어 있습니다.

HTTPS 지원을 구현하는 방법

1. HTTPS 터널 서브릿에 대해 자체 서명된 인증서를 생성합니다.
2. HTTPS 터널 서브릿을 웹 서버에 배포합니다.
3. 브로커의 httpsjms 연결 서비스를 구성하고 브로커를 시작합니다.
4. HTTPS 연결을 구성합니다.

각 단계에 대해서는 뒤에서 자세히 설명합니다.

1단계. HTTPS 터널 서브릿에 대해 자체 서명된 인증서 생성

MQ 3.0.1의 SSL 지원은 클라이언트가 알려지고 신뢰할 수 있는 서버와 통신한다는 가정하에 전송 데이터를 보호하기 위한 것입니다. 따라서 MQ 3.0.1에서는 자체 서명된 서버 인증서만 사용하여 SSL을 구현합니다. httpsjms 연결 서비스 구조에서 HTTPS 터널 서브릿은 브로커와 응용 프로그램 클라이언트에 대해 서버 역할을 담당합니다.

imqkeytool 유틸리티를 실행하여 터널 서브릿에 대해 자체 서명된 인증서를 생성합니다. 명령 프롬프트에서 다음을 입력합니다.

imqkeytool -servlet keystore_location

유틸리티는 필요한 정보를 묻는 메시지를 표시합니다. (Unix 시스템에서 키 저장소를 만들 권한을 가지려면 imqkeytool을 수퍼유저(루트)로 실행해야 할 수도 있습니다.)

imqkeytool은 키 저장소 비밀번호, 일부 조직 정보 및 사용자의 확인을 묻는 메시지를 차례로 표시합니다. 확인이 끝나면 키 쌍을 생성하는 동안 일시 중지됩니다. 그런 다음 특정 키 쌍을 잠글 비밀번호(키 비밀번호)를 묻습니다. 이 프롬프트에 대한 응답으로 Return 키를 눌러야 합니다. 그러면 키 비밀번호가 키 저장소 비밀번호와 동일하게 지정됩니다.

---

주	입력한 비밀번호를 기억해야 합니다. 나중에 이 비밀번호를 제공해야 터널 서브릿이 키 저장소를 열 수 있습니다.

---

imqkeytool을 실행하면 JDK keytool 유틸리티를 실행하여 자체 서명된 인증서를 생성하고 keystore_location 인수에서 지정한 위치의 MQ 키 저장소 파일에 넣을 수 있습니다. (키 저장소의 형식은 JDK1.2 keytool에서 지원하는 것과 같습니다.)

---

주	HTTPS 터널 서브릿에서 키 저장소를 볼 수 있어야 합니다. keystore_location에 생성된 키 저장소를 HTTPS 터널 서브릿에서 액세스할 수 있는 위치로 이동/복사합니다("2단계. 웹 서버에 HTTPS 터널 서브릿 배포" 참조).

---

2단계. 웹 서버에 HTTPS 터널 서브릿 배포

웹 서버에 HTTPS 터널 서브릿을 배포하는 일반적인 방법에는 두 가지가 있습니다.

• jar 파일로 배포 - Servlet 2.1 이전 버전을 지원하는 웹 서버용
• 웹 아카이브(WAR) 파일로 배포 - Servlet 2.2 이상 버전을 지원하는 웹 서버용

두 경우 모두 클라이언트와 브로커 사이에서 종단간 보안 통신이 이루어질 수 있도록 웹 서버에 암호화가 활성화되었는지 확인해야 합니다.

Jar 파일로 배포

MQ 터널 서브릿 배포는 호스트 웹 서버에 액세스할 수 있는 적절한 jar 파일을 작성하고 시작 시 서브릿을 로드하도록 웹 서버를 구성하여 이루어집니다.

터널 서브릿 jar 파일(imqservlet.jar)은 HTTPS 터널 서브릿에 필요한 모든 클래스를 포함하며 다음 디렉토리에 있습니다.

IMQ_HOME/lib (Solaris의 경우 /usr/share/lib/imq)

서브릿 2.x를 지원하는 모든 웹 서버를 사용하여 이 서브릿을 로드할 수 있습니다. 서브릿 클래스 이름은 다음과 같습니다.

com.sun.messaging.jmq.transport.
httptunnel.servlet.HttpsTunnelServlet

웹 서버에서 imqservlet.jar 파일을 볼 수 있어야 합니다. 웹 서버와 브로커를 서로 다른 호스트에서 실행하려면 imqservlet.jar 파일의 복사본을 웹 서버에서 액세스할 수 있는 위치에 저장해야 합니다.

시작 시 이 서브릿을 로드하도록 웹 서버를 구성해야 합니다("예: HTTPS 터널 서브릿 배포" 참조).

JSSE jar 파일이 웹 서버에서 서브릿을 실행하는 클래스 경로에 있는지 확인합니다. 수행 방법은 웹 서버 설명서를 확인하십시오.

웹 서버 구성에서 중요한 부분 중 하나는 HTTPS 터널 서브릿에서 브로커와 보안 연결을 설정할 때 사용할 자체 서명된 인증서의 위치와 비밀번호를 지정하는 것입니다. "1단계. HTTPS 터널 서브릿에 대해 자체 서명된 인증서 생성"에서 만든 키 저장소를 HTTPS 터널 서브릿에서 액세스할 수 있는 위치에 두어야 합니다.

또한 성능 향상을 위해 웹 서버의 액세스 로깅 기능은 사용하지 않는 것이 좋습니다.

웹 아카이브 파일로 배포

HTTPS 터널 서브릿을 WAR 파일로 배포하는 작업은 웹 서버에서 제공하는 배포 메커니즘을 사용하여 수행합니다. HTTPS 터널 서브릿 WAR 파일(imqhttps.war)은 다음 디렉토리에 있습니다.

IMQ_HOME/lib (Solaris의 경우 /usr/share/lib/imq)

WAR 파일에는 웹 서버에서 서브릿을 로드하여 실행하는 데 필요한 기본 구성 정보가 들어 있는 배포 설명자가 포함되어 있습니다.

하지만 imqhttps.war 파일의 배포 설명자에서는 터널 서브릿에 필요한 키 저장소 파일이 있는 위치를 알 수 없습니다("1단계. HTTPS 터널 서브릿에 대해 자체 서명된 인증서 생성" 참조). 따라서 imqhttps.war 파일을 배포하기 전에 터널 서브릿의 배포 설명자(XML 파일)를 편집하여 키 저장소 위치를 지정해야 합니다.

3단계. httpsjms 연결 서비스 구성

MQ 3.0.1 브로커에는 HTTPS 지원이 기본적으로 사용되지 않기 때문에 httpsjms 연결 서비스를 사용하도록 브로커를 재구성해야 합니다. 재구성한 경우 "브로커 시작"에 설명된 대로 브로커를 시작할 수 있습니다.

httpsjms 연결 서비스를 사용하는 방법

1. 다음 위치에서 브로커의 인스턴스 구성 파일을 엽니다.

IMQ_VARHOME/instances/brokerName/props/config.properties
(Solaris의 경우 /var/imq/instances/brokerName/props/config.properties)

여기서 brokerName은 브로커 인스턴스의 이름입니다.

2. imq.service.activelist 등록 정보에 httpsjms 값을 추가합니다.

imq.service.activelist=jms,admin,httpsjms

브로커는 시작할 때 호스트 시스템에서 실행 중인 웹 서버와 HTTPS 터널 서브릿을 찾습니다. 그러나 원격 터널 서브릿에 액세스하기 위해 servletHost 및 servletPort 연결 서비스 등록 정보를 재구성할 수 있습니다.

또한 성능 향상을 위해 pullPeriod 등록 정보를 재구성할 수도 있습니다. httpsjms 연결 서비스 구성 등록 정보에 대한 자세한 설명은 표 B-3을 참조하십시오.

표 B-3    httpsjms 연결 서비스 등록 정보 

등록 정보 이름	설명
imq.httpsjms.https servletHost	필요한 경우 이 값을 변경하여 HTTPS 터널 서브릿을 실행하는 호스트의 이름(호스트 이름 또는 IP 주소)을 지정합니다(원격 호스트이거나 로컬 호스트의 특정 호스트 이름일 수 있음). 기본값: localhost
imq.httpsjms.https servletPort	이 값을 변경하여 브로커가 HTTPS 터널 서브릿에 액세스하는 데 사용하는 포트 번호를 지정합니다(웹 서버에서 기본 포트를 변경한 경우 이 등록 정보를 적절히 변경해야 함). 기본값: 7674
imq.httpsjms.https pullPeriod	브로커에서 메시지를 가져오기 위해 각 클라이언트가 만든 HTTP 요청 사이의 간격(초)을 지정합니다. 값이 0 또는 음수인 경우 클라이언트는 하나의 HTTP 요청을 항상 보류 상태로 두고 가능한 빨리 메시지를가져오도록 준비합니다. 클라이언트 수가 많은 경우 웹 서버 자원을 많이 사용하여 서버가 응답하지 않을 수 있습니다. 그런 경우 pullPeriod 등록 정보를 양수(초)로 설정해야 합니다. 이 등록 정보는 후속 가져오기 요청을 만들기 전에 클라이언트의 HTTP 전송 드라이버가 대기하는 시간을 설정합니다. 값을 양수로 설정하면 클라이언트가 응답 시간 동안 대기하는 대신 웹 서버 자원이 절약됩니다. 기본값: -1

4단계. HTTPS 연결 구성

클라이언트 응용 프로그램에서는 제대로 구성된 연결 팩토리 관리 객체를 사용해서 브로커에 대한 HTTPS 연결을 설정해야 합니다.

하지만 클라이언트는 Java Secure Socket Extension (JSSE)에서 제공하는 SSL 라이브러리에도 액세스해야 하며 루트 인증서도 있어야 합니다. SSL 라이브러리는 JDK 1.4와 함께 제공됩니다. 이전 버전의 JDK가 있는 경우에는 "JSSE 구성,"을 참조하십시오. 그렇지 않으면 "루트 인증서 가져오기."로 이동하십시오.

이 문제를 해결하고 나면 계속해서 HTTPS 연결을 구성할 수 있습니다.

JSSE 구성

JSSE를 구성하는 방법

1. JSSE jar 파일을 JRE_HOME/lib/ext 디렉토리로 복사합니다.

jsse.jar, jnet.jar, jcert.jar

2. JSSE 보안 공급자를 정적으로 추가합니다. 이 작업은

security.provider.n=com.sun.net.ssl.internal.ssl.Provider

를 JRE_HOME/lib/security/java.security 파일에 추가하여 수행할 수 있습니다. (여기서 n은 보안 공급자 패키지에서 다음으로 사용할 수 있는 우선 순위 번호입니다.)

3. JDK1.4를 사용하지 않는 경우에는 클라이언트 응용 프로그램을 시작하는 명령에 -D 옵션을 사용해서 다음 JSSE 등록 정보를 설정해야 합니다.

java.protocol.handler.pkgs=com.sun.net.ssl.internal.www.protocol

루트 인증서 가져오기

웹 서버 인증서에 서명한 CA의 루트 인증서가 기본적으로 트러스트 데이터베이스에 있지 않거나 독자적인 웹 서버 인증서를 사용하는 경우에는 인증서를 트러스트 데이터베이스에 추가해야 합니다. 여기에 해당되면 다음 지침에 따르고, 그렇지 않으면 "연결 팩토리 속성 설정"으로 이동합니다.

인증서가 cert_file에 저장되어 있고 trust_store_file이 키 저장소라면 다음 명령을 실행합니다.

JRE_HOME/bin/keytool -import -trustcacerts
-alias alias_for_certificate -file cert_file
-keystore trust_store_file

다음 질문에 YES로 응답합니다. Trust this certificate?

클라이언트 응용 프로그램을 시작하는 명령에 -D 옵션을 사용해서 다음과 같은 JSSE 등록 정보도 지정해야 합니다.

javax.net.ssl.trustStore=trust_store_file

javax.net.ssl.trustStorePassword=trust_store_passwd

연결 팩토리 속성 설정

HTTPS 지원을 구현하려면 다음 연결 팩토리 속성을 설정합니다("연결 팩토리 관리 객체" 참조).

• imqConnectionType 속성을 HTTP로 설정합니다.

브로커에 대한 보안 연결을 설정하려면 HTTP 터널 서브릿 대신 HTTPS 터널 서브릿을 통해 배포 및 연결을 수행합니다. 두 서브릿에는 같은 연결 유형이 사용됩니다.

• imqConnectionURL을 HTTPS 터널 서브릿 URL로 설정합니다.

https://hostName:port/imq/tunnel

다음 방법 중 하나를 사용하여 연결 팩토리 속성을 설정할 수 있습니다.

• 연결 팩토리 관리 객체를 만드는 imqobjmgr 명령에 -o 옵션을 사용하거나("연결 팩토리 추가" 참조) 관리 콘솔(imqadmin)을 사용하여 연결 팩토리 관리 객체를 만들 때 속성을 설정합니다.
• 클라이언트 응용 프로그램을 시작하는 명령에 -D 옵션을 사용합니다(MQ Developer's Guide 참조).
• JMS API 호출을 사용하여 연결 팩토리를 클라이언트 응용 프로그램 코드에서 프로그래밍 방식으로 만든 후 해당 연결 팩토리의 속성을 설정합니다(MQ Developer's Guide 참조).

단일 서브릿을 사용하여 다중 브로커에 액세스

다중 브로커를 실행할 경우 다중 웹 서버 및 서브릿 인스턴스를 구성하지 않아도 됩니다. 동시에 실행 중인 브로커 간에 단일 웹 서버와 HTTPS 터널 서브릿을 공유할 수 있습니다. 이를 위해 imqConnectionURL 연결 팩토리 속성을 다음과 같이 구성해야 합니다.

https://hostName:port/imq/tunnel?ServerName=hostName:brokerName

여기서 hostName은 브로커 호스트 이름이고 brokerName은 클라이언트가 액세스할 특정 브로커 인스턴스의 이름입니다.

hostName과 brokerName에 정확한 문자열을 입력했는지 확인하려면 브라우저에서 서브릿 URL에 액세스하여 HTTPS 터널 서브릿의 상태 보고서를 생성합니다. 보고서에는 서브릿이 액세스하는 모든 브로커가 나열됩니다.

---

HTTPS tunnel servlet ready. Servlet Start Time : Thu May 30 01:08:18 PDT 2002 Accepting TCP connections from brokers on port : 7674 Total available brokers = 2 Broker List :    jpgserv:broker2    cochin:broker1

---

HTTP 프록시 사용

HTTP 프록시를 사용해서 HTTPS 터널 서브릿에 액세스하는 경우:

• http.proxyHost 시스템 등록 정보를 프록시 서버 호스트 이름으로 설정합니다.
• http.proxyPort 시스템 등록 정보를 프록시 서버 포트 번호로 설정합니다.

클라이언트 응용 프로그램을 시작하는 명령에 -D 옵션을 사용하여 이러한 등록 정보를 설정할 수 있습니다.

예: HTTPS 터널 서브릿 배포

이 절에서는 Sun ONE Web Server에서 HTTPS 터널 서브릿을 jar 파일과 WAR 파일로 배포하는 방법을 모두 설명합니다. 사용 방법은 Sun ONE Web Server의 버전에 따라 다르지만, Servlet 2.2 이상 버전을 지원하지 않는 경우 WAR 파일 배포를 처리할 수 없습니다.

Jar 파일로 배포

다음은 브라우저 기반 관리 GUI를 사용하는 Sun ONE Web Server, FastTrack Edition 4.1에 배포 시의 참조 지침입니다. 이 절차는 다음과 같은 일반적인 단계로 구성됩니다.

1. 서브릿 추가
2. 서브릿 가상 경로 구성
3. 서브릿 로드
4. 서브릿 액세스 로그 비활성화

이러한 단계는 다음 하위 절에 설명되어 있습니다. 웹 브라우저를 사용하여 서브릿 URL에 액세스함으로써 HTTP 터널 서브릿 배포 성공 여부를 확인할 수 있습니다. 상태 정보를 표시해야 합니다.

서브릿 추가

터널 서브릿을 추가하는 방법

1. 서브릿 탭을 선택합니다.
2. 서브릿 속성 구성을 선택합니다.
3. 서브릿 이름 필드에 터널 서브릿의 이름을 지정합니다.
4. 서브릿 코드(클래스 이름) 필드를 다음 값으로 설정합니다.

com.sun.messaging.jmq.transport.
httptunnel.servlet.HttpsTunnelServlet

5. 서브릿 클래스 경로 필드에 imqservlet.jar에 대한 전체 경로를 입력합니다. 예를 들면 다음과 같습니다.

IMQ_HOME/lib/imqservlet.jar
(Solaris의 경우 /usr/share/lib/imq/imqservlet.jar)

6. 서브릿 인수 필드에 표 B-4와 같은 필수 및 선택 인수를 입력합니다.

표 B-4    HTTPS 터널 서브릿 Jar 파일 배포에 사용되는 서브릿 인수

인수	기본값	필수?	참조
keystoreLocation	없음	예	표 8-8
keystorePassword	없음	예	표 8-8
serverHost	모든 호스트	아니요	표 B-3
serverPort	7674	아니요	표 B-3

인수를 다음 예와 같이 쉼표로 분리합니다.

keystoreLocation=keystore_location,keystorePassword=keystore_password, servletPort=portnumber

serverHost 및 serverPort 인수는 웹 서버와 브로커 간 통신에만 적용되며 기본값에 문제가 있는 경우에만 설정됩니다. 그런 경우에도 브로커 구성 등록 정보를 적절하게 설정해야 합니다(표 B-3 참조). 예를 들면 다음과 같습니다.

imq.httpsjms.https.servletPort

서브릿 가상 경로(서브릿 URL) 구성

터널 서브릿에 대한 가상 경로(서브릿 URL)를 구성하는 방법

1. 서브릿 탭을 선택합니다.
2. 서브릿 가상 경로 변환 구성을 선택합니다.
3. 가상 경로 필드를 설정합니다.

예를 들어, URL을 http://hostName:port/imq/tunnel로 지정하려는 경우 가상 경로 필드에 다음 문자열을 입력합니다.

/imq/tunnel

4. 서브릿 이름 필드를 "서브릿 추가"의 3단계와 동일한 값으로 설정합니다.

서브릿 로드

웹 서버 시작 시 터널 서브릿을 로드하는 방법

1. 서브릿 탭을 선택합니다.
2. 전역 속성 구성을 선택합니다.
3. 시작 서브릿 필드에 "서브릿 추가"의 3단계와 동일한 서브릿 이름 값을 입력합니다.

서버 액세스 로그 비활성화

서버 액세스 로그를 비활성화할 필요는 없지만 그렇게 하면 성능이 향상됩니다.

서버 액세스 로그를 비활성화하는 방법

1. 상태 탭을 선택합니다.
2. 로그 기본 설정 페이지를 선택합니다.
3. 로그 클라이언트 액세스 제어를 사용하여 로깅을 비활성화합니다.

WAR 파일로 배포

다음은 Sun ONE Web Server 6.0 서비스 팩 2에 배포 시의 참조 지침입니다.
웹 브라우저를 사용하여 서브릿 URL에 액세스하면 HTTPS 터널 서브릿의 배포 성공 여부를 확인할 수 있습니다. 상태 정보를 표시해야 합니다.

HTTPS 터널 서브릿을 배포하기 전에 웹 서버의 클래스 경로에 JSSE jar 파일이 포함되어 있는지 확인합니다. 이 작업을 수행하는 가장 간단한 방법은 jsse.jar, jnet.jar, jcert.jar 파일을 IWS60_TOPDIR/bin/https/jre/lib/ext로 복사하는 것입니다.

또한, HTTPS 터널 서브릿을 배포하기 전에 키 저장소 파일의 위치를 가리키고 키 저장소 비밀번호를 지정하도록 배포 설명자를 수정해야 합니다.

HTTPS 터널 서브릿 WAR 파일을 수정하는 방법

1. WAR 파일을 임시 디렉토리로 복사합니다.

$ cp IMQ_HOME/lib/imqhttps.war /tmp
(Solaris의 경우 $ cp /usr/share/lib/imq/imqhttps.war /tmp)

2. 임시 디렉토리를 현재 디렉토리로 만듭니다.

$ cd /tmp

3. WAR 파일의 내용을 추출합니다.

$ jar xvf imqhttps.war

4. WAR 파일의 배포 설명자를 나열합니다.

$ ls -l WEB-INF/web.xml

5. keystoreLocation과 keystorePassword 인수(필요한 경우 serverPort 및 serverHost 인수도)에 정확한 값을 제공하도록 web.xml 파일을 편집합니다.
6. WAR 파일의 내용을 다시 어셈블합니다.

$ jar uvf imqhttps.war WEB-INF/web.xml

이제 수정된 imqhttps.war 파일을 사용하여 HTTPS 터널 서브릿을 배포할 수 있습니다. (키 저장소 비밀번호 노출이 우려되는 경우에는 파일 시스템 권한을 사용하여 imqhttps.war 파일에 대한 액세스를 제한할 수 있습니다.)

https 터널 서브릿을 WAR 파일로 배포하는 방법

1. 브라우저 기반 관리 GUI에서 가상 서버 클래스 탭을 선택합니다. 클래스 관리를 누릅니다.
2. 해당 가상 서버 클래스 이름(예: defaultclass)을 선택하고 관리 버튼을 누릅니다.
3. 가상 서버 관리를 선택합니다.
4. 해당 가상 서버 이름을 선택하고 관리 버튼을 누릅니다.
5. 웹 응용 프로그램 탭을 선택합니다.
6. 웹 응용 프로그램 배포를 누릅니다.
7. WAR 파일 위치와 WAR 파일 경로 필드에서 수정된 imqhttps.war 파일("HTTPS 터널 서브릿 WAR 파일을 수정하는 방법" 참조)을 가리키는 적절한 값을 선택합니다.
8. 응용 프로그램 URI 필드에 "/imq"(따옴표 없이)를 입력합니다.
9. 서브릿을 배포할 설치 디렉토리 경로(일반적으로 Sun ONE Web Server 설치 루트 아래)를 입력합니다.
10. 확인을 누릅니다.
11. 웹 서버 인스턴스를 다시 시작합니다.

이제 서브릿을 다음 주소에서 사용할 수 있습니다.

https://hostName:port/imq/tunnel

이제 클라이언트에서 이 URL을 통해 보안 HTTPS 연결을 사용하는 메시지 서비스에 연결할 수 있습니다.