Rinjae
5.8 KiB
작업내역 — feature/crypto-module (eapim-admin)
작업일: 2026-05-06 브랜치:
feature/crypto-module작업자: curry772 프로젝트:eapim-admin
작업 목적
eapim-online에서 구현된 암호화모듈 프레임워크(CryptoModuleManager)의 설정 데이터(crypto_module_config)를
관리자 화면에서 CRUD할 수 있는 관리 화면 개발.
설정 변경 즉시 게이트웨이 엔진에 동적 반영되어야 한다.
변경 파일 목록
JPA 데이터 레이어 — com.eactive.eai.rms.data.entity.onl.security
| 파일 | 설명 |
|---|---|
CryptoModuleConfigRepository.java |
BaseRepository + QuerydslPredicateExecutor 조합 Repository |
CryptoModuleConfigDataService.java |
데이터 서비스 인터페이스. findAll(pageable, searchName, algType, keySourceType, useYn) |
CryptoModuleConfigDataServiceImpl.java |
QueryDSL predicate 기반 검색 구현. QCryptoModuleConfig 사용 |
관리 화면 레이어 — com.eactive.eai.rms.onl.manage.crypto
| 파일 | 설명 |
|---|---|
CryptoModuleConfigUI.java |
UI VO (@Data, @JsonProperty 대문자+언더스코어 규칙). @NotNull 검증 포함 |
CryptoModuleConfigUiMapper.java |
MapStruct Entity↔UI 매퍼. updateToEntity (null 무시) 포함 |
CryptoModuleConfigManService.java |
CRUD 비즈니스 서비스. insert/update 시 modifiedBy·modifiedAt 자동 설정 |
CryptoModuleConfigManController.java |
Spring MVC Controller. INSERT/UPDATE/DELETE 후 엔진 재로드 커맨드 broadcast |
JSP 화면 — WebContent/jsp/onl/admin/security/
| 파일 | 설명 |
|---|---|
cryptoModuleMan.jsp |
목록 화면. jqGrid, 4가지 검색 조건(모듈명·알고리즘·키소스·사용여부) |
cryptoModuleManDetail.jsp |
상세/등록/수정 화면. keySourceType 선택에 따라 STATIC/DYNAMIC 섹션 토글 |
URL 구조
| 용도 | URL |
|---|---|
| 목록 View | GET /onl/admin/security/cryptoModuleMan.view |
| 상세 View | GET /onl/admin/security/cryptoModuleMan.view?cmd=DETAIL&cryptoId={id} |
| 목록 조회 | POST /onl/admin/security/cryptoModuleMan.json?cmd=LIST |
| 상세 조회 | POST /onl/admin/security/cryptoModuleMan.json?cmd=DETAIL |
| 등록 | POST /onl/admin/security/cryptoModuleMan.json?cmd=INSERT |
| 수정 | POST /onl/admin/security/cryptoModuleMan.json?cmd=UPDATE |
| 삭제 | POST /onl/admin/security/cryptoModuleMan.json?cmd=DELETE |
엔진 동적 반영 구조
Controller (INSERT / UPDATE / DELETE)
└─ service.insert() / update() / delete() ← DB 반영
└─ CommonCommand.builder()
.name("com.eactive.eai.agent.security.ReloadCryptoModuleCommand")
.args(cryptoId)
.build()
.broadcast(agentUtilService) ← 게이트웨이 전 인스턴스 broadcast
└─ CryptoModuleManager.reload(cryptoId)
├─ configMap 에서 cryptoId 항목 제거
├─ dynamicKeyCache 에서 관련 항목 제거
└─ DB 재조회 → useYn=Y 이면 configMap 재등록
(DELETE 후 호출 시: DB에 없으므로 제거만 수행)
RELOAD_CRYPTO_MODULE_COMMAND상수는CommonCommand.java에 추가하지 않고CryptoModuleConfigManController내부에private static final String으로 선언
화면 설계
목록 화면 (cryptoModuleMan.jsp)
검색 조건
| 항목 | 유형 | 비고 |
|---|---|---|
| 모듈명 | text | 부분 일치 (containsIgnoreCase) |
| 알고리즘 | select | 전체 / AES / ARIA |
| 키 소스 | select | 전체 / STATIC / DYNAMIC |
| 사용 여부 | select | 전체 / Y / N |
그리드 컬럼: 모듈명 · 설명 · 알고리즘 · 운영모드 · 키 소스 · 사용여부 (CRYPTO_ID는 hidden 컬럼으로 포함, 더블클릭 시 상세 화면 이동에 사용)
상세 화면 (cryptoModuleManDetail.jsp)
공통 필드: 모듈명* · 설명 · 알고리즘* · 운영모드* · 패딩 · IV(Hex) · 키소스유형* · 동적키캐시* · 캐시TTL · 사용여부*
STATIC 섹션 (keySourceType = STATIC 일 때만 표시):
- 암호화 키(Hex) *
- 복호화 키(Hex) (미입력 시 암호화 키와 동일)
DYNAMIC 섹션 (keySourceType = DYNAMIC 일 때만 표시):
- 키 도출 전략 FQCN *
- 키 도출 파라미터 JSON *
keySourceType select 변경 시 JavaScript toggleKeySourceFields()로 즉시 토글.
주요 설계 결정
1. @InitBinder — Integer 빈 문자열 처리
cacheTtlSec(Integer)에 빈 문자열이 전송될 수 있으므로 Controller에 @InitBinder 등록:
binder.registerCustomEditor(Integer.class, new CustomNumberEditor(Integer.class, true));
2. 로그인 사용자 — SessionManager.getUserId(request)
HttpServletRequest를 Controller에서 받아 SessionManager.getUserId(request)로 추출,
Service의 insert() / update() 에 loginId로 전달 → modifiedBy 설정.
3. JSON 필드명 규칙
@JsonProperty는 DB 컬럼명 기반 대문자+언더스코어 (CRYPTO_ID, KEY_SOURCE_TYPE 등).
JSP detail() 함수에서 제네릭 루프 대신 명시적 필드 매핑으로 처리
(기존 name.toUpperCase() 패턴은 언더스코어 있는 컬럼명과 불일치하므로).
4. DELETE 후 엔진 반영
CryptoModuleManager.reload(cryptoId) — DB에서 삭제된 후 호출하면
loader.findById(cryptoId) 가 empty를 반환 → configMap 에서 제거만 수행.
별도 RemoveCommand 없이 동일한 ReloadCryptoModuleCommand 재사용.
미완료 / 다음 작업
./gradlew compileJava실행 →QCryptoModuleConfigQ-class 생성 확인- 관리자 메뉴 테이블에 경로 등록 (
/onl/admin/security/cryptoModuleMan.view) - 화면 접근 권한(ACL) 등록
- 전체 파일 커밋 (eapim-admin)