eastargh
5.6 KiB
5.6 KiB
작업내역 — feature/crypto-module (eapim-admin)
작업일: 2026-05-07 브랜치:
feature/crypto-module작업자: curry772 프로젝트:eapim-admin
작업 목적
2026-05-06 작업 미완료 항목 처리 및 기능 테스트 중 발견된 버그 수정, UX 개선.
변경 파일 목록
DB DDL
| 항목 | 내용 |
|---|---|
EMSAPP.CRYPTO_MODULE_CONFIG 테이블 컬럼 추가 |
기존 DDL에서 누락된 MODIFIED_BY, MODIFIED_AT 컬럼 추가 |
ALTER TABLE EMSAPP.CRYPTO_MODULE_CONFIG
ADD (
MODIFIED_BY VARCHAR2(50),
MODIFIED_AT TIMESTAMP
);
전체 DDL (신규 환경용)
CREATE TABLE EMSAPP.CRYPTO_MODULE_CONFIG (
CRYPTO_ID VARCHAR2(36) NOT NULL,
CRYPTO_NAME VARCHAR2(100) NOT NULL,
CRYPTO_DESC VARCHAR2(500),
ALG_TYPE VARCHAR2(10) NOT NULL,
CIPHER_MODE VARCHAR2(20) NOT NULL,
PADDING VARCHAR2(30),
IV_HEX VARCHAR2(200),
KEY_SOURCE_TYPE VARCHAR2(20) NOT NULL,
ENC_KEY_HEX VARCHAR2(200),
DEC_KEY_HEX VARCHAR2(200),
KEY_DERIV_STRATEGY VARCHAR2(200),
KEY_DERIV_PARAMS VARCHAR2(2000),
CACHE_YN CHAR(1) NOT NULL,
CACHE_TTL_SEC NUMBER(10),
USE_YN CHAR(1) NOT NULL,
MODIFIED_BY VARCHAR2(50),
MODIFIED_AT TIMESTAMP,
CONSTRAINT PK_CRYPTO_MODULE_CONFIG PRIMARY KEY (CRYPTO_ID),
CONSTRAINT UQ_CRYPTO_MODULE_CONFIG_NAME UNIQUE (CRYPTO_NAME)
);
비즈니스 레이어 — CryptoModuleConfigManService.java
버그 수정: detached entity passed to persist
원인
AbstractEntity가Persistable<I>를 구현하고@Transient boolean isNew = true로 선언@PostLoad에서isNew = false로 전환하는 구조AbstractDataService.getById(id)는repository.getReferenceById(id)(lazy proxy) 반환- lazy proxy는 실제 DB 조회를 하지 않아
@PostLoad가 호출되지 않음 →isNew = true유지 save(proxy)호출 시isNew() = true→em.persist(proxy)→ detached entity 에러
수정 내용
| 메서드 | 변경 전 | 변경 후 |
|---|---|---|
selectDetail() |
dataService.getById(cryptoId) |
dataService.findById(cryptoId).orElseThrow(...) |
update() |
dataService.getById(ui.getCryptoId()) |
dataService.findById(ui.getCryptoId()).orElseThrow(...) |
insert() |
— | entity.setCryptoId(null) 추가 |
findById()는 실제 DB 조회 →@PostLoad호출 →isNew = false→merge()정상 동작insert()에서setCryptoId(null)추가: JSP<input type="hidden" name="cryptoId" />가 빈 문자열""로 전송될 때 UUID 생성기가 정상 동작하도록 보장
목록 화면 — cryptoModuleMan.jsp
버그 수정: 검색 조건 누락
원인
- 공통 함수
getSearchForJqgrid()는name^=search패턴 필드만 자동 수집 algType,keySourceType,useYn은 해당 패턴이 아니어서 검색 버튼 클릭 시 postData에서 누락
수정 내용
- 검색 버튼 클릭 핸들러에서 세 필드를 명시적으로 postData에 추가
var postData = getSearchForJqgrid("cmd", "LIST");
postData['algType'] = $('select[name=algType]').val();
postData['keySourceType'] = $('select[name=keySourceType]').val();
postData['useYn'] = $('select[name=useYn]').val();
상세 화면 — cryptoModuleManDetail.jsp
기능 추가 1: 텍스트 → HEX 변환 보조 입력 + 키 길이 표시
배경
- AES/ARIA 암호화 키, 복호화 키, IV를 HEX 값으로 직접 입력하는 것은 불편
- 단, HEX → 텍스트 역변환이 항상 가능하지 않음 (랜덤 바이트 키는 유효하지 않은 UTF-8 시퀀스 포함 가능)
- 텍스트 변환 기능은 개발/테스트 편의용, 운영 환경에서는 랜덤 키 생성 권장
추가 내용
encKeyHex,decKeyHex,ivHex각 필드에 텍스트 입력 보조 필드 추가- 텍스트 입력 시
TextEncoder(UTF-8)로 HEX 자동 변환 → HEX 필드에 반영 - 보조 입력 필드는
name속성 없음 → form submit에 포함되지 않음
- 텍스트 입력 시
- HEX 필드 옆에 키 길이 실시간 표시 (
N bytes (M자)형식)- HEX 직접 입력 시 및 조회 시에도 즉시 반영
- 참고 기준: AES-128: 16bytes / AES-192: 24bytes / AES-256: 32bytes
추가 함수
textToHex(text) // TextEncoder UTF-8 기반 HEX 변환
updateHexFromText(...) // 텍스트 입력 → HEX 필드 갱신 + 길이 표시
updateHexLength(hex, id) // HEX 문자열 길이 계산 및 표시
기능 추가 2: 수정자 / 수정일시 정보 표시
- 테이블 하단에 수정자/수정일시 행 추가 (read-only
<span>표시) - 신규 등록 화면: 행 숨김 (
display:none) - 상세 조회 화면: 값이 있을 때만 행 표시
MODIFIED_AT포맷:LocalDateTime.toString()결과의T→ 공백 치환 (2026-05-07 09:30:00)
주요 설계 결정
getById() vs findById()
이 프로젝트에서 AbstractDataService.getById()는 getReferenceById()를 래핑한다.
AbstractEntity가 Persistable<isNew>를 구현하므로, lazy proxy 상태에서는 isNew = true가 유지되어 save() 시 persist()가 호출되는 문제가 있다.
수정/조회 후 저장이 필요한 경우 반드시 findById()를 사용해야 한다.
미완료 / 다음 작업
- 관리자 메뉴 테이블에 경로 등록 (
/onl/admin/security/cryptoModuleMan.view) - 화면 접근 권한(ACL) 등록
- 전체 파일 커밋 (eapim-admin + eapim-online 양쪽)