시작하기

세외수입개별시스템(Non-Tax Revenue Individual System) 은
과태료 부과에 대한 실시간 API 4종(부과결과/부과취소/수납정보/감액정보)을 지원 하며,
API 4종의 데이터는 세외수입시스템측에서 제공 한다.

• 출발지: 세외수입시스템
• 목적지: 개별시스템(ntri)

버전관리

1. 배포하기

1. 원하는 경로에 ntri.zip 압축파일을 unzip 한다.
2. %NTRI_APP_HOME%/bin/setenv.bat 파일을 열어 배포환경에 맞게 환경변수를 수정 한다.
   • NTRI_JAVA_HOME 및 SSL/DB 설정 등..
3. %NTRI_APP_HOME%/bin/service-regist.bat 파일을 "관리자권한" 으로 실행
4. %NTRI_APP_HOME%/webapp 디렉토리에 "ntri-0.0.1-SNAPSHOT.jar" 파일 복사
5. %NTRI_APP_HOME%/bin/service-start.bat 파일을 실행하여 "서비스 시작"
   • 서비스 실행 오류가 발생할 경우 %NTRI_APP_HOME%/logs/stderr.log 내용 확인
6. %NTRI_APP_HOME%/bin/service-logprint.bat 파일을 실행하여 "서비스 실시간 로그" 확인

2. SSL 인증서 발급

1. OpenSSL 다운로드(https://sourceforge.net/projects/openssl)
   • openssl-1.0.2j-fips-x86_64/openssl-1.0.2j-fips-x86_64.zip
2. 다운로드한 압축파일을 unzip 후 OpenSSL 디렉토리를 C드라이브(C:/) 밑으로 이동
3. 관리자 권한으로 cmd창 열기
4. cd 커맨드로 C:\OpenSSL\bin 디렉토리로 이동

      cd C:\Openssl\bin

    

5. 인증서 발급 커맨드 실행

      openssl req -config ./openssl.cnf -x509 -sha256 -nodes -newkey rsa:2048 -keyout private.key -out public.pem -days 3650
	-> 커맨드 종료시까지 엔터키(Enter) 입력	
	
openssl pkcs12 -export -inKey private.key -in public.pem -name alias_name -out certificate.p12
	-> 인증서 패스워드 `xit5811807` 입력 
	※ openssl.cnf 관련 오류 발생 시 openssl.cnf 파일을 C:/OpenSSL 밑으로 복사

    

6. 생성된 certificate.p12 파일을 "%NTRI_APP_HOME%/ssl/cert" 디렉토리로 복사

3. API 테스트

1. "~/bin/test" 디렉토리로 이동
2. 테스트 배치파일(.bat) 실행하여 API 호출
   • 일괄: curl-all.bat
   • 부과취소: curl-LevyCancel.bat
   • 부과결과: curl-LevyResult.bat
   • 수납정보: curl-RcivInfo.bat
   • 감액정보: curl-RdcamtInfo.bat

부록

디렉토리 구성

파일 설명

실행 환경

• Java 버전: JDK11 이상
• Tomcat 버전: Tomcat9 이상
• JDBC: ojdbc8.jar