Rinjae
144 lines
5.8 KiB
Markdown
144 lines
5.8 KiB
Markdown
# 작업내역 — 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` 등록:
|
|
```java
|
|
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` 실행 → `QCryptoModuleConfig` Q-class 생성 확인
|
|
- [ ] 관리자 메뉴 테이블에 경로 등록 (`/onl/admin/security/cryptoModuleMan.view`)
|
|
- [ ] 화면 접근 권한(ACL) 등록
|
|
- [ ] 전체 파일 커밋 (eapim-admin)
|