[JSP] JAVA로 우체국 Open API 복호화/암호화 화면 띄우기

 우체국 Open API를 호출할 때, 암호화된 변수로 넘겨야 리턴을 받을 수 있어서 암호화/복호화 화면을 띄워놓고 테스트하는 것이 정신 건강에 이롭다. 구글링해보면 전부 php로만 만들어서 쓰고 있는데, java가 훨씬 익숙해서 java 버전으로 세팅해서 쓰고 있다.

 가장 먼저 필요한 건 eclipse, jre, tomcat이 깔려있어야 한다. 현재 자신이 사용하는 환경에 맞게 적당한 버전을 사용하면 될 것 같다. 해당 포스팅은 위 나열된 IDE 및 java의 기초 세팅(시스템 변수 설정 등)이 되어있다는 전제 하에 진행된다.

필자가 사용한 버전
Eclipse : 2020-06 (4.16.0)
     JRE : jre1.8.0_231
Tomcat : apache-tomcat-8.5.40

 

우체국 API 사용 안내 페이지에 있는 SEED128forJAVA 파일을 다운 받은 후 압축을 풀어둔다.

압축을 풀면 위와 같은 파일 두 개가 나오는데, 일단 열어볼 필요 없으니 냅두자.

 

디렉토리 생성

 

c드라이브 내에 작업하기 위한 임의의 workspace를 하나 만들어준다.

그리고 이클립스를 실행해, 해당 디렉토리를 Workspace로 설정한다.

 

Dynamic Web project 생성

 

Dynamic Web project 생성 클릭

 

프로젝트 명은 원하는 이름으로 해도 되는데, 필자는 헷갈리지 않게 SEED128로 설정했다.

여기서 Dynamic web module version이 중요한데, 이클립스에 설정되어있는 버전으로 맞춰서 설정해주어야 한다. 잘못설정했다면 추후 프로젝트 설정에서 수정 가능하기 때문에 일단은 무시하고 넘어가도 된다. 만약 본인 이클립스에 설정된 버전을 알고 싶다면 아래 포스팅을 참고하면 된다.

[Eclipse] Dynamic Web Module version 확인/수정하기

 

다음으로 넘어가 build path 경로를 위와 같이 설정해준다. 기존에 src라고 되어있다면 제거 후 src/main/java로 바꿔주면 된다.

마지막으로 Content directory도 위와 같이 설정해주면 된다. 만약 WebContent라고 되어있다면 삭제 후 바꿔주면 된다.

 

서버 설정

 

설치되어있는 tomcat 디렉토리를 설정해주고, jre 버전을 선택해준다.

그리고 만들어진 서버와 프로젝트를 연결해준다.

서버 우클릭 - Add and Remove

만들었던 프로젝트 선택 후 Add - Finish

그 후 서버를 더블클릭하면 서버 설정 화면이 열리는데, 여기서 Modules 탭으로 이동

Edit - Path를 SEED128에서 / 로 바꿔준다.

 

프로젝트 세팅

 

위에서 압축 풀었던 파일을 가져와서 넣어 준다.

src/main/java 하위에 seed128 폴더 생성 후 SEED128.java 파일 copy
src/main/webapp 하위에 apiSeedTest.jsp 파일 copy

 

그러면 최종적으로 프로젝트가 아래와 같은 디렉토리 구조를 갖게 된다.

그리고 여기서 apiSeedTest.jsp 파일을 연다.

import하는 부분을 위와 같이 수정해준다.

마찬가지로 SEED128.java 파일도 열어서 package 경로를 수정해준다.

 그 다음, server 디렉토리 내부에 있는 web.xml을 열어서 index.jsp를 호출하는 welcome-file-list 태그를 찾아서 아래와 같이 바꿔준다. (맨 밑에 있다)

 

다음으로 프로젝트 설정을 해준다.

프로젝트 우클릭 - Properties

 

Properties - Java Build Path - Libraries

처음 들어오면 톰캣 라이브러리가 추가되지 않았을 것이다. Add Library - Server Runtime - 사용할 톰캣 버전 선택하여 추가해준다. 또한 JRE 버전이 사용할 버전과 다르다면 지우고 Add Library - JRE System Library - 사용할 JRE 버전 선택하여 추가해준다.

 

Properties - Project Facets

맨 처음 프로젝트를 만들 때, Dynamic Web Module version을 잘못 선택했다면, 여기서 수정할 수 있다. 꼭 이클립스 설정과 맞는 버전을 선택해주자. 또한 Java 버전도 사용할 JRE와 동일한 버전으로 선택해준다.

 

이제 서버 동작 후 localhost:8080에 접속하면,

이렇게 잘 나온다.

 보안키 부분에 발급받은 보안키를 넣고, 암호화가 목적이라면 평문에만 값 입력 후 버튼 클릭, 복호화가 목적이라면 암호문에만 값 입력 후 버튼을 클릭하면 된다.