{@link AbnormalAccessDetectionService}(#35)의 5유형 탐지 결과를 기간 단위로 보여준다. + * 화면: {@code /WEB-INF/jsp/site/mnt/sec/abnormal/list.jsp}
+ * + *왜 저장 테이블이 아니라 즉시 집계인가: 탐지 임계치는 정책값이라 언제든 바뀐다 + * ({@link AbnormalAccessPolicy}). 탐지 결과를 별도 테이블에 적재해 두면 임계치를 조정한 뒤에도 + * 과거 기준으로 굳은 행이 남아 "지금 기준으로 몇 건인가"에 답할 수 없다. 원천인 접속기록은 + * 730일 보존되므로, 조회 시점 기준으로 다시 세는 편이 정확하다. + * 월 단위 스냅샷이 필요한 경우는 정기점검 리포트(#43)가 {@code ABNORMAL_SUMMARY} 로 남긴다.
+ * + *조회 부하 주의: 5유형 각각이 접속기록 전체를 기간으로 훑는 집계라 기간이 넓으면 + * 무거워진다. 그래서 기본 조회기간을 최근 30일로 두고, 최대 {@link #MAX_RANGE_DAYS}일로 제한한다.
+ * + *접근통제: 인터셉터 ①인증판정이 비활성이라 화면 단에서 다시 판정한다 + * ({@link PersonalDataAccessLogController} 와 동일 방식). 롤 판정은 {@code urlRoleMapping} + * 의 {@code /mnt/sec/*} = ROLE_ADMIN 이 담당한다.
+ */ +@Controller +public class AbnormalAccessController { + + private static final String LOGIN_REDIRECT = "redirect:/uat/uia/egovLoginUsr.do"; + + /** 기본 조회기간(일) — 최근 30일. */ + private static final int DEFAULT_RANGE_DAYS = 30; + + /** 최대 조회기간(일). 5유형 집계가 접속기록 전체를 훑으므로 상한을 둔다. */ + private static final int MAX_RANGE_DAYS = 366; + + private static final String DATE_PATTERN = "yyyy-MM-dd"; + + @Resource(name = "abnormalAccessDetectionService") + private AbnormalAccessDetectionService abnormalAccessDetectionService; + + /** + * 비정상 접근 탐지 결과 화면. + * + * @param fromDt 시작일(yyyy-MM-dd). 미지정 시 오늘 - 30일 + * @param toDt 종료일(yyyy-MM-dd). 미지정 시 오늘 + */ + @RequestMapping(value = "/mnt/sec/abnormal/listView.do") + public String listView(@RequestParam(value = "fromDt", required = false) String fromDt, + @RequestParam(value = "toDt", required = false) String toDt, + ModelMap model) throws Exception { + if (handlerUser() == null) { + return LOGIN_REDIRECT; + } + + SimpleDateFormat dateFmt = new SimpleDateFormat(DATE_PATTERN); + Calendar cal = Calendar.getInstance(); + + String toDate = isBlank(toDt) ? dateFmt.format(cal.getTime()) : toDt.trim(); + String fromDate; + if (isBlank(fromDt)) { + cal.add(Calendar.DAY_OF_MONTH, -DEFAULT_RANGE_DAYS); + fromDate = dateFmt.format(cal.getTime()); + } else { + fromDate = fromDt.trim(); + } + + String rangeMsg = null; + long days = diffDays(dateFmt, fromDate, toDate); + if (days < 0) { + // 시작 > 종료 — 조회하지 않고 되돌린다(뒤집힌 조건으로 "이상징후 0건"이 나오면 오독한다) + rangeMsg = "시작일이 종료일보다 뒤입니다. 기간을 다시 지정하세요."; + } else if (days > MAX_RANGE_DAYS) { + rangeMsg = "조회기간은 최대 " + MAX_RANGE_DAYS + "일까지입니다. 기간을 좁혀 주세요."; + } + + if (rangeMsg == null) { + // 종료일 당일(23:59:59)까지 포함 — 접속기록 조회화면과 같은 규칙 + List알림함 화면(#49)이 "누가 걸렸는지"를 요약 문자열에서 파싱하지 않도록 원본 행을 그대로 싣는다. + * 개인정보 본문은 담지 않는다(접속자ID·집계값뿐).
+ */ + private List보관기간(730일) 경과 파티션을 파기한 내역과, 미래 월 파티션을 미리 확보한 내역을 보여준다. + * 화면: {@code /WEB-INF/jsp/site/mnt/sec/purgeHistory/list.jsp}
+ * + *조회 전용이다. 파기 이력 자체가 "접속기록을 규정대로 지웠고 그 외 경로로는 손대지 + * 않았다"는 증빙이므로, 화면에서 이력을 고치거나 지울 수 있으면 증빙 가치가 사라진다. + * 등록·수정·삭제 엔드포인트를 두지 않는다.
+ * + *접근통제: 인터셉터 3단 중 ①인증판정이 비활성이라 /mnt 하위라도 무인증 진입이 + * 가능하므로 {@link #handlerUser()} 로 화면 단에서 다시 판정한다 + * ({@link PersonalDataAccessLogController} 와 동일 방식). 롤 판정은 {@code urlRoleMapping} + * 의 {@code /mnt/sec/*} = ROLE_ADMIN 이 담당한다.
+ */ +@Controller +public class AccessLogPurgeHistoryController { + + private static final String LOGIN_REDIRECT = "redirect:/uat/uia/egovLoginUsr.do"; + + @Resource(name = "accessLogPartitionDAO") + private AccessLogPartitionDAO accessLogPartitionDAO; + + /** + * 파기이력 목록 화면. + * 뷰: /WEB-INF/jsp/site/mnt/sec/purgeHistory/list.jsp + */ + @RequestMapping(value = "/mnt/sec/purgeHistory/listView.do") + public String listView(@ModelAttribute("accessLogPurgeHistorySearchVO") AccessLogPurgeHistorySearchVO searchVO, + ModelMap model) throws Exception { + if (handlerUser() == null) { + return LOGIN_REDIRECT; + } + + if (searchVO.getPageIndex() < 1) { + searchVO.setPageIndex(1); + } + if (searchVO.getRecordCountPerPage() < 1) { + searchVO.setRecordCountPerPage(10); + } + searchVO.setFirstIndex((searchVO.getPageIndex() - 1) * searchVO.getRecordCountPerPage()); + + int totalCount = accessLogPartitionDAO.selectPurgeHistoryListCount(searchVO); + searchVO.setTotalRecordCount(totalCount); + List종료일 보정: 사용자가 {@code 2026-08-27} 처럼 날짜만 넣으면 그날 00:00:00 이 되어 + * 당일 파기분이 통째로 빠진다. {@link #getToDtParam()} 가 날짜만 들어온 경우 + * {@code 23:59:59} 를 붙여 당일을 포함시킨다 — 접속기록 조회화면 + * ({@link PersonalDataAccessLogSearchVO})과 같은 규칙이라 두 화면의 기간 검색이 어긋나지 않는다.
+ */ +public class AccessLogPurgeHistorySearchVO implements Serializable { + + private static final long serialVersionUID = 1L; + + /** 유형 — DROP / ADD / 전체(빈값). */ + private String purgeType; + /** 수행일시 시작(yyyy-MM-dd 또는 yyyy-MM-dd HH:mm:ss). */ + private String fromDt; + /** 수행일시 종료. */ + private String toDt; + + private int pageIndex = 1; + private int recordCountPerPage = 10; + /** 조회 시작 offset(0-base) = (pageIndex-1) * recordCountPerPage */ + private int firstIndex = 0; + private int totalRecordCount = 0; + + public String getPurgeType() { return purgeType; } + public void setPurgeType(String purgeType) { this.purgeType = purgeType; } + + public String getFromDt() { return fromDt; } + public void setFromDt(String fromDt) { this.fromDt = fromDt; } + + public String getToDt() { return toDt; } + public void setToDt(String toDt) { this.toDt = toDt; } + + public int getPageIndex() { return pageIndex; } + public void setPageIndex(int pageIndex) { this.pageIndex = pageIndex; } + + public int getRecordCountPerPage() { return recordCountPerPage; } + public void setRecordCountPerPage(int recordCountPerPage) { this.recordCountPerPage = recordCountPerPage; } + + public int getFirstIndex() { return firstIndex; } + public void setFirstIndex(int firstIndex) { this.firstIndex = firstIndex; } + + public int getTotalRecordCount() { return totalRecordCount; } + public void setTotalRecordCount(int totalRecordCount) { this.totalRecordCount = totalRecordCount; } + + /** 시작일시 바인딩값 — 날짜만 들어오면 00:00:00 을 붙인다. */ + public String getFromDtParam() { + return isDateOnly(fromDt) ? fromDt + " 00:00:00" : fromDt; + } + + /** 종료일시 바인딩값 — 날짜만 들어오면 당일 23:59:59 까지 포함시킨다. */ + public String getToDtParam() { + return isDateOnly(toDt) ? toDt + " 23:59:59" : toDt; + } + + private boolean isDateOnly(String v) { + return v != null && v.trim().length() == 10; + } +} diff --git a/src/main/java/egovframework/com/cmm/privacy/auditlog/AccessLogPurgeHistoryVO.java b/src/main/java/egovframework/com/cmm/privacy/auditlog/AccessLogPurgeHistoryVO.java new file mode 100644 index 0000000..4810279 --- /dev/null +++ b/src/main/java/egovframework/com/cmm/privacy/auditlog/AccessLogPurgeHistoryVO.java @@ -0,0 +1,60 @@ +/** + * Class Name : AccessLogPurgeHistoryVO.java + * Description : 개인정보 접속기록 파기·증설 이력 VO — 개인정보보호 기능개선 사업(SFR-004 / DBR-001 / SER-002) + * + * Modification Information + * + * 수정일 수정자 수정내용 + * ------- -------- --------------------------- + * 2026.08.27 개인정보보호 최초 생성 — 파기이력 조회 화면(#37 후속) + * + * @since 2026. 08. 27 + * @version 1.0 + */ +package egovframework.com.cmm.privacy.auditlog; + +import java.io.Serializable; + +/** + * {@code PDAL_PURGE_HISTORY} 한 행 — 파기 배치(#37)가 수행한 파티션 DROP(파기)·ADD(선행증설) 내역. + * + *이 이력이 증빙인 이유: 접속기록 본문 테이블은 UPDATE/DELETE statement 자체를 두지 않고, + * 삭제는 오직 파티션 DROP 으로만 일어난다. 그래서 "언제 무엇이 지워졌는가"를 답할 수 있는 유일한 + * 근거가 이 표다 — 보관기간 경과분을 실제로 파기했다는 사실(SER-002-2)과, 그 외 경로로는 지운 적이 + * 없다는 사실을 함께 보인다.
+ */ +public class AccessLogPurgeHistoryVO implements Serializable { + + private static final long serialVersionUID = 1L; + + /** 이력 일련번호. */ + private long purgeId; + /** 대상 파티션명(예: p202607). */ + private String partitionName; + /** 파티션 상한 경계값(LESS THAN). */ + private String boundaryDt; + /** 유형 — DROP:파기 / ADD:선행증설. */ + private String purgeType; + /** 수행 일시. */ + private String purgeDt; + /** 비고(보관기간·사유). */ + private String note; + + public long getPurgeId() { return purgeId; } + public void setPurgeId(long purgeId) { this.purgeId = purgeId; } + + public String getPartitionName() { return partitionName; } + public void setPartitionName(String partitionName) { this.partitionName = partitionName; } + + public String getBoundaryDt() { return boundaryDt; } + public void setBoundaryDt(String boundaryDt) { this.boundaryDt = boundaryDt; } + + public String getPurgeType() { return purgeType; } + public void setPurgeType(String purgeType) { this.purgeType = purgeType; } + + public String getPurgeDt() { return purgeDt; } + public void setPurgeDt(String purgeDt) { this.purgeDt = purgeDt; } + + public String getNote() { return note; } + public void setNote(String note) { this.note = note; } +} diff --git a/src/main/java/egovframework/com/cmm/privacy/batch/AccessLogPartitionDAO.java b/src/main/java/egovframework/com/cmm/privacy/batch/AccessLogPartitionDAO.java index 6d8b655..6191245 100644 --- a/src/main/java/egovframework/com/cmm/privacy/batch/AccessLogPartitionDAO.java +++ b/src/main/java/egovframework/com/cmm/privacy/batch/AccessLogPartitionDAO.java @@ -5,6 +5,8 @@ import java.util.Map; import org.springframework.stereotype.Repository; +import egovframework.com.cmm.privacy.auditlog.AccessLogPurgeHistorySearchVO; +import egovframework.com.cmm.privacy.auditlog.AccessLogPurgeHistoryVO; import egovframework.com.cmm.service.impl.EgovComAbstractDAO; /** @@ -54,4 +56,24 @@ public class AccessLogPartitionDAO extends EgovComAbstractDAO { public void insertPurgeHistory(Map배치가 쓰는 DAO 에 조회를 함께 두는 이유는 {@code PDAL_PURGE_HISTORY} 의 소유자가 + * 이 클래스이기 때문이다. 이력을 읽는 statement 를 다른 sqlmap 으로 흩어 놓으면 + * 적재 컬럼이 바뀔 때 조회 쪽이 조용히 어긋난다.
+ * + * @param searchVO 유형·기간·페이징 + */ + @SuppressWarnings("unchecked") + public List취급자 영역(/mnt) 백엔드 엔드포인트. 응답은 jsonView(화면 JSP는 #48 대시보드 후속). + *
취급자 영역(/mnt) 엔드포인트. 기존 {@code list.do}/{@code detail.do}/{@code saveResult.do} + * 는 jsonView 로 응답하는 백엔드 계약이고, 2026.08.27 추가된 {@code listView.do}/ + * {@code saveResultView.do} 가 관리자 화면(#48)이다 — 두 계약을 병존시켜 기존 호출부를 깨지 않는다. * 점검자 식별자는 세션 loginVO 에서 취득한다.
* + *화면이 필요한 이유: 월 1회 점검 자체는 배치(#43)가 집계하지만, "누가 언제 보고 무엇을 + * 조치했는가"는 사람이 입력해야 남는다. 그 입력 경로가 JSON 엔드포인트뿐이면 점검 사실을 + * 증빙으로 제출할 수 없다(SFR-004-7).
+ * * @author arko-privacy-auditlog (Fork C - 7차) * @since 2026-07-21 */ @@ -27,6 +35,8 @@ public class InspectionResultController { protected static final String JSON = "jsonView"; + private static final String LOGIN_REDIRECT = "redirect:/uat/uia/egovLoginUsr.do"; + @Resource(name = "inspectionResultService") private InspectionResultService inspectionResultService; @@ -35,6 +45,82 @@ public class InspectionResultController { return (o instanceof LoginVO) ? (LoginVO) o : null; } + /** + * 정기점검 리포트 목록·상세 화면(서버 렌더링, #48). + * 뷰: /WEB-INF/jsp/site/mnt/sec/inspection/list.jsp + * + *월 1행짜리 표라 페이징을 두지 않는다(연 12행). 연도 필터와 점검여부 필터만 제공한다. + * {@code rptId} 가 있으면 그 리포트 상세와 점검결과 입력 폼을 함께 편다 — + * 목록에서 상세로 화면을 옮기면 점검 중 다른 달과 대조하기가 불편하다.
+ */ + @RequestMapping(value = "/mnt/sec/inspection/listView.do") + public String listView(@org.springframework.web.bind.annotation.RequestParam(value = "rptYmPrefix", required = false) String rptYmPrefix, + @org.springframework.web.bind.annotation.RequestParam(value = "inspectedYn", required = false) String inspectedYn, + @org.springframework.web.bind.annotation.RequestParam(value = "rptId", required = false) Long rptId, + @org.springframework.web.bind.annotation.RequestParam(value = "resultMsg", required = false) String resultMsg, + ModelMap model) throws Exception { + if (handlerUser() == null) { + return LOGIN_REDIRECT; + } + Map배치가 적재한 집계값은 손대지 않고 점검자 입력 필드만 갱신한다 + * (감사 증빙이므로 집계값이 사후에 바뀌면 안 된다).
+ */ + @RequestMapping(value = "/mnt/sec/inspection/saveResultView.do") + public String saveResultView(InspectionReportVO vo, HttpServletRequest request) throws Exception { + LoginVO user = handlerUser(); + if (user == null) { + return LOGIN_REDIRECT; + } + vo.setInspectorId(user.getId()); + String message; + try { + int cnt = inspectionResultService.saveInspectionResult(vo); + message = (cnt > 0) ? "점검결과를 저장했습니다." : "저장 대상 리포트가 없습니다."; + } catch (IllegalArgumentException e) { + // 점검결과 미입력 등 유효성 위반 — 화면에 사유를 그대로 보여준다 + message = e.getMessage(); + } + // Spring 3.0.5 에는 RedirectAttributes 가 없다(3.1 도입). 이 코드베이스의 관용대로 + // 결과 메시지를 URL 인코딩해 쿼리스트링으로 넘긴다(AccountMngController 와 동일 방식). + return "redirect:/mnt/sec/inspection/listView.do?rptId=" + vo.getRptId() + + "&resultMsg=" + URLEncoder.encode(message == null ? "" : message, "UTF-8"); + } + + /** + * 인증된 업무사용자(USR)만 통과. 그 외에는 null. + * (인터셉터 ①인증판정이 비활성이라 화면 단에서 다시 판정한다 — 다른 개인정보보호 화면과 동일) + */ + private LoginVO handlerUser() { + if (!Boolean.TRUE.equals(EgovUserDetailsHelper.isAuthenticated())) { + return null; + } + Object o = EgovUserDetailsHelper.getAuthenticatedUser(); + if (!(o instanceof LoginVO)) { + return null; + } + LoginVO loginVO = (LoginVO) o; + return "USR".equals(loginVO.getUserSe()) ? loginVO : null; + } + /** 정기점검 리포트 월별 목록 (검색: rptYmPrefix 연도, inspectedYn Y/N) */ @RequestMapping(value = "/mnt/sec/inspection/list.do") public String list(@org.springframework.web.bind.annotation.RequestParam(value = "rptYmPrefix", required = false) String rptYmPrefix, diff --git a/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoAccessHistoryVO.java b/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoAccessHistoryVO.java new file mode 100644 index 0000000..49f0f38 --- /dev/null +++ b/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoAccessHistoryVO.java @@ -0,0 +1,90 @@ +/** + * Class Name : MberCryptoAccessHistoryVO.java + * Description : 암호화 회원정보 관리자 접근 이력 VO — 개인정보보호 기능개선 사업(추가제안 Action4) + * + * Modification Information + * + * 수정일 수정자 수정내용 + * ------- -------- --------------------------- + * 2026.08.27 개인정보보호 최초 생성 — 사유·재인증 이력 + * + * @since 2026. 08. 27 + * @version 1.0 + */ +package egovframework.com.cmm.privacy.crypto; + +import java.io.Serializable; + +/** + * {@code MBER_CRYPTO_ACCESS_HISTORY} 한 행 — 관리자가 평문 개인정보를 열람·변경한 행위의 소명 근거. + * + *개인정보 본문은 담지 않는다. 무엇을 바꿨는지는 {@link #changedItems}(항목명 목록)로만 + * 남기고 값은 적재하지 않는다 — 이력이 또 하나의 평문 개인정보 저장소가 되면 안 된다.
+ */ +public class MberCryptoAccessHistoryVO implements Serializable { + + private static final long serialVersionUID = 1L; + + /** 행위 — 복호화 조회. */ + public static final String ACTION_SELECT = "S"; + /** 행위 — 신규 등록. */ + public static final String ACTION_INSERT = "I"; + /** 행위 — 수정. */ + public static final String ACTION_UPDATE = "U"; + /** 행위 — 개인정보 파기. */ + public static final String ACTION_DELETE = "D"; + + private long histId; + /** 처리자(취급자) 계정ID. */ + private String handlrId; + /** 행위 S/I/U/D. */ + private String actionTy; + /** 대상 회원ID. */ + private String trgetMberId; + /** 사유(필수). */ + private String accessReason; + /** 변경 항목명 목록(값 미적재). */ + private String changedItems; + /** 처리자 IP. */ + private String handlrIp; + /** 재인증 통과 여부 Y/N. */ + private String reauthYn; + /** 처리 일시. */ + private String accessDt; + + public long getHistId() { return histId; } + public void setHistId(long histId) { this.histId = histId; } + + public String getHandlrId() { return handlrId; } + public void setHandlrId(String handlrId) { this.handlrId = handlrId; } + + public String getActionTy() { return actionTy; } + public void setActionTy(String actionTy) { this.actionTy = actionTy; } + + public String getTrgetMberId() { return trgetMberId; } + public void setTrgetMberId(String trgetMberId) { this.trgetMberId = trgetMberId; } + + public String getAccessReason() { return accessReason; } + public void setAccessReason(String accessReason) { this.accessReason = accessReason; } + + public String getChangedItems() { return changedItems; } + public void setChangedItems(String changedItems) { this.changedItems = changedItems; } + + public String getHandlrIp() { return handlrIp; } + public void setHandlrIp(String handlrIp) { this.handlrIp = handlrIp; } + + public String getReauthYn() { return reauthYn; } + public void setReauthYn(String reauthYn) { this.reauthYn = reauthYn; } + + public String getAccessDt() { return accessDt; } + public void setAccessDt(String accessDt) { this.accessDt = accessDt; } + + /** 행위코드의 한글 표기(화면·리포트용). */ + public String getActionNm() { + if (ACTION_SELECT.equals(actionTy)) { return "복호화조회"; } + if (ACTION_INSERT.equals(actionTy)) { return "등록"; } + if (ACTION_UPDATE.equals(actionTy)) { return "수정"; } + if (ACTION_DELETE.equals(actionTy)) { return "개인정보파기"; } + return actionTy; + } +} diff --git a/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoAdminController.java b/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoAdminController.java new file mode 100644 index 0000000..17cbb38 --- /dev/null +++ b/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoAdminController.java @@ -0,0 +1,426 @@ +/** + * Class Name : MberCryptoAdminController.java + * Description : 암호화 회원정보 관리자 전용 CRUD 화면 — 개인정보보호 기능개선 사업(추가제안 Action4) + * + * Modification Information + * + * 수정일 수정자 수정내용 + * ------- -------- --------------------------- + * 2026.08.27 개인정보보호 최초 생성 — 복호화 조회·수정·삭제·등록 + 사유·재인증 + * + * @since 2026. 08. 27 + * @version 1.0 + */ +package egovframework.com.cmm.privacy.crypto; + +import java.net.URLEncoder; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import javax.annotation.Resource; +import javax.servlet.http.HttpServletRequest; + +import org.springframework.stereotype.Controller; +import org.springframework.ui.ModelMap; +import org.springframework.web.bind.annotation.ModelAttribute; +import org.springframework.web.bind.annotation.RequestMapping; +import org.springframework.web.bind.annotation.RequestParam; + +import egovframework.com.cmm.LoginVO; +import egovframework.com.cmm.privacy.auditlog.ClientIpResolver; +import egovframework.com.cmm.privacy.util.MaskingUtil; +import egovframework.com.cmm.util.EgovUserDetailsHelper; +import egovframework.rte.ptl.mvc.tags.ui.pagination.PaginationInfo; + +/** + * 관리자 전용 회원정보(암호화 항목) 화면 — 제안서 추가제안 Action4(슬라이드16). + * + *화면 구성 + *
목록을 마스킹으로 고정한 이유: 관리자가 목록만 열어도 평문 이름·연락처가 화면 한 장에 + * 수십 건씩 뜨면, 사유를 받는 의미가 사라진다(정작 대량 노출은 목록에서 일어난다). + * 평문은 대상을 특정해 사유를 남긴 상세 한 건에서만 보이게 한다.
+ * + *접근통제 3중: ① {@code urlRoleMapping} 의 {@code /mnt/sec/*} = ROLE_ADMIN(전체관리자 + * 전용) ② {@link #handlerUser()} 로 업무사용자(USR) 세션 재확인 ③ 평문에 닿는 모든 경로에서 + * {@link MberCryptoReauth} 재인증(10분). 여기에 접속기록 인터셉터가 {@code /mnt/sec/**} 를 + * 자동 수집하므로 '언제 누가 열었는가'는 별도로도 남는다.
+ * + *상태 변경은 POST 만 받는다. 등록·수정·파기가 GET 으로도 열리면 링크 한 번, 이미지 + * 태그 하나로 실행될 수 있다.
+ */ +@Controller +public class MberCryptoAdminController { + + private static final String LOGIN_REDIRECT = "redirect:/uat/uia/egovLoginUsr.do"; + private static final String LIST_REDIRECT = "redirect:/mnt/sec/mberCrypto/listView.do?page=9100051"; + + /** 재인증 화면으로 되돌아올 수 있는 경로의 접두사. 이 밖의 값은 받지 않는다(오픈 리다이렉트 차단). */ + private static final String RETURN_URL_PREFIX = "/mnt/sec/mberCrypto/"; + + @Resource(name = "mberCryptoAdminService") + private MberCryptoAdminService mberCryptoAdminService; + + /* ================================================================ + * 목록 — 항상 마스킹 + * ================================================================ */ + + /** + * 회원정보 목록(마스킹). 뷰: /WEB-INF/jsp/site/mnt/sec/mberCrypto/list.jsp + * + *이름 검색은 완전일치만 된다(암호문은 부분검색이 원리적으로 불가). 그 사실을 화면 안내에 + * 명시하고, 검색 결과가 0건일 때 "부분일치로는 찾을 수 없다"는 점을 함께 보여준다.
+ */ + @RequestMapping(value = "/mnt/sec/mberCrypto/listView.do") + public String listView(@ModelAttribute("mberCryptoSearchVO") MberCryptoSearchVO searchVO, + @RequestParam(value = "resultMsg", required = false) String resultMsg, + HttpServletRequest request, ModelMap model) throws Exception { + if (handlerUser() == null) { + return LOGIN_REDIRECT; + } + + if (searchVO.getPageIndex() < 1) { + searchVO.setPageIndex(1); + } + if (searchVO.getRecordCountPerPage() < 1) { + searchVO.setRecordCountPerPage(10); + } + searchVO.setFirstIndex((searchVO.getPageIndex() - 1) * searchVO.getRecordCountPerPage()); + + List실패 문구는 사유를 구분하지 않는다(계정 없음/비밀번호 불일치 동일) — 계정 열거를 막는 + * 이 사업의 기존 처리(#23)와 같은 방침이다.
+ */ + @RequestMapping(value = "/mnt/sec/mberCrypto/reauth.do", method = org.springframework.web.bind.annotation.RequestMethod.POST) + public String reauth(@RequestParam(value = "password", required = false) String password, + @RequestParam(value = "returnUrl", required = false) String returnUrl, + HttpServletRequest request) throws Exception { + LoginVO user = handlerUser(); + if (user == null) { + return LOGIN_REDIRECT; + } + String target = safeReturnUrl(returnUrl); + + if (mberCryptoAdminService.verifyHandlerPassword(user.getId(), password)) { + MberCryptoReauth.markVerified(request); + return "redirect:" + target; + } + MberCryptoReauth.clear(request); + return "redirect:/mnt/sec/mberCrypto/reauthView.do?returnUrl=" + URLEncoder.encode(target, "UTF-8") + + "&resultMsg=" + URLEncoder.encode("본인 확인에 실패했습니다. 비밀번호를 다시 입력하세요.", "UTF-8"); + } + + /* ================================================================ + * 상세(복호화) — 사유 + 재인증 + * ================================================================ */ + + /** + * 회원 상세(평문). 사유 미입력이면 열지 않고, 재인증이 만료됐으면 재인증 화면으로 보낸다. + * 뷰: /WEB-INF/jsp/site/mnt/sec/mberCrypto/view.jsp + */ + @RequestMapping(value = "/mnt/sec/mberCrypto/view.do") + public String view(@RequestParam(value = "mberId", required = false) String mberId, + @RequestParam(value = "reason", required = false) String reason, + @RequestParam(value = "resultMsg", required = false) String resultMsg, + HttpServletRequest request, ModelMap model) throws Exception { + LoginVO user = handlerUser(); + if (user == null) { + return LOGIN_REDIRECT; + } + if (isBlank(mberId)) { + return listRedirect("대상 회원이 지정되지 않았습니다."); + } + if (isBlank(reason)) { + return listRedirect("개인정보 조회 사유는 필수입니다. 목록에서 사유를 입력한 뒤 조회하세요."); + } + if (!MberCryptoReauth.isVerified(request)) { + return reauthRedirect(viewUrl(mberId, reason)); + } + + MberCryptoVO vo = mberCryptoAdminService.selectMber(mberId); + if (vo == null) { + return listRedirect("대상 회원을 찾을 수 없습니다."); + } + + // 평문을 실제로 화면에 띄우는 시점에 사유와 함께 이력을 남긴다. + mberCryptoAdminService.recordDecryptView(mberId, user.getId(), + ClientIpResolver.getClientIp(request), reason); + + model.addAttribute("mber", vo); + model.addAttribute("reason", reason); + model.addAttribute("resultMsg", resultMsg); + model.addAttribute("reauthRemain", Long.valueOf(MberCryptoReauth.remainSeconds(request))); + return "site/mnt/sec/mberCrypto/view"; + } + + /* ================================================================ + * 등록 / 수정 / 파기 — 모두 POST + 사유 + 재인증 + * ================================================================ */ + + /** 신규 등록 화면. 뷰: /WEB-INF/jsp/site/mnt/sec/mberCrypto/regist.jsp */ + @RequestMapping(value = "/mnt/sec/mberCrypto/registView.do") + public String registView(@ModelAttribute("mberCryptoVO") MberCryptoVO vo, + @RequestParam(value = "resultMsg", required = false) String resultMsg, + HttpServletRequest request, ModelMap model) throws Exception { + if (handlerUser() == null) { + return LOGIN_REDIRECT; + } + if (!MberCryptoReauth.isVerified(request)) { + return reauthRedirect(RETURN_URL_PREFIX + "registView.do?page=9100051"); + } + model.addAttribute("resultMsg", resultMsg); + model.addAttribute("reauthRemain", Long.valueOf(MberCryptoReauth.remainSeconds(request))); + return "site/mnt/sec/mberCrypto/regist"; + } + + /** 신규 등록 처리. */ + @RequestMapping(value = "/mnt/sec/mberCrypto/regist.do", method = org.springframework.web.bind.annotation.RequestMethod.POST) + public String regist(@ModelAttribute("mberCryptoVO") MberCryptoVO vo, + @RequestParam(value = "reason", required = false) String reason, + HttpServletRequest request) throws Exception { + LoginVO user = handlerUser(); + if (user == null) { + return LOGIN_REDIRECT; + } + if (!MberCryptoReauth.isVerified(request)) { + return reauthRedirect(RETURN_URL_PREFIX + "registView.do?page=9100051"); + } + try { + String mberId = mberCryptoAdminService.registMber(vo, user.getId(), + ClientIpResolver.getClientIp(request), reason); + return listRedirect("회원을 등록했습니다: " + mberId); + } catch (IllegalArgumentException e) { + return registRedirect(e.getMessage()); + } + } + + /** 수정 처리. */ + @RequestMapping(value = "/mnt/sec/mberCrypto/update.do", method = org.springframework.web.bind.annotation.RequestMethod.POST) + public String update(@ModelAttribute("mberCryptoVO") MberCryptoVO vo, + @RequestParam(value = "reason", required = false) String reason, + HttpServletRequest request) throws Exception { + LoginVO user = handlerUser(); + if (user == null) { + return LOGIN_REDIRECT; + } + if (!MberCryptoReauth.isVerified(request)) { + return reauthRedirect(viewUrl(vo.getMberId(), reason)); + } + try { + int cnt = mberCryptoAdminService.updateMber(vo, user.getId(), + ClientIpResolver.getClientIp(request), reason); + return listRedirect(cnt > 0 ? "회원정보를 수정했습니다." : "수정 대상이 없습니다."); + } catch (IllegalArgumentException e) { + return listRedirect(e.getMessage()); + } + } + + /** + * 개인정보 파기 처리. + * + *되돌릴 수 없는 작업이라 화면에서 회원ID를 직접 입력해 확인시키고 + * ({@code confirmId}), 서버에서도 대상과 일치하는지 다시 본다 — 확인 절차가 화면에만 있으면 + * 요청을 직접 만드는 경로에서는 없는 것과 같다.
+ */ + @RequestMapping(value = "/mnt/sec/mberCrypto/deletePii.do", method = org.springframework.web.bind.annotation.RequestMethod.POST) + public String deletePii(@RequestParam(value = "mberId", required = false) String mberId, + @RequestParam(value = "confirmId", required = false) String confirmId, + @RequestParam(value = "reason", required = false) String reason, + HttpServletRequest request) throws Exception { + LoginVO user = handlerUser(); + if (user == null) { + return LOGIN_REDIRECT; + } + if (!MberCryptoReauth.isVerified(request)) { + return reauthRedirect(viewUrl(mberId, reason)); + } + if (isBlank(mberId) || confirmId == null || !mberId.trim().equals(confirmId.trim())) { + return listRedirect("파기 확인을 위해 대상 회원ID를 정확히 입력해야 합니다."); + } + try { + int cnt = mberCryptoAdminService.deleteMberPii(mberId, user.getId(), + ClientIpResolver.getClientIp(request), reason); + return listRedirect(cnt > 0 + ? "개인정보를 파기하고 회원상태를 탈퇴로 전환했습니다: " + mberId.trim() + : "파기 대상이 없습니다."); + } catch (IllegalArgumentException e) { + return listRedirect(e.getMessage()); + } + } + + /* ================================================================ + * 접근 이력 + * ================================================================ */ + + /** 이 화면에서 일어난 접근 이력(사유 포함) 조회. 뷰: .../mberCrypto/history.jsp */ + @RequestMapping(value = "/mnt/sec/mberCrypto/historyView.do") + public String historyView(@RequestParam(value = "trgetMberId", required = false) String trgetMberId, + @RequestParam(value = "handlrId", required = false) String handlrId, + @RequestParam(value = "actionTy", required = false) String actionTy, + @RequestParam(value = "pageIndex", required = false, defaultValue = "1") int pageIndex, + ModelMap model) throws Exception { + if (handlerUser() == null) { + return LOGIN_REDIRECT; + } + int page = pageIndex < 1 ? 1 : pageIndex; + int perPage = 10; + + Map복호화 지점을 여기 한 곳으로 모은다. 조회 statement 는 {@code MBER_NM_ENC} 를 + * {@code mberNm} 별칭으로 가져오고, 이 DAO 가 반환 직전 + * {@link MemberNmDecryptSupport} 로 같은 자리에 평문을 되돌려 쓴다. 서비스·화면은 복호화를 + * 의식하지 않는다 — 읽기 전환 시 정착된 이 코드베이스의 관용을 그대로 따른다.
+ * + *기존 회원관리(mberManageDAO)와 왜 분리했나: 표준 회원관리 VO 는 활동지역·재능 등 + * 수십 개 필드를 함께 다뤄 이 화면이 필요로 하지 않는 값까지 오간다. 개인정보 항목만 좁게 + * 취급하는 별도 계층을 두는 편이 "무엇을 읽고 무엇을 바꿨는가"를 이력에 정확히 남기기 쉽다.
+ */ +@Repository("mberCryptoAdminDAO") +public class MberCryptoAdminDAO extends EgovComAbstractDAO { + + /** 회원 목록(검색·페이징). 반환 직전 이름을 복호화해 {@code mberNm} 에 되돌려 쓴다. */ + @SuppressWarnings("unchecked") + public List제안서 추가제안 Action4(슬라이드16)의 요건을 구현한다 — + * 관리자 전용 화면에서 복호화 조회·수정·삭제·신규 등록, 조회·수정·삭제 시 사유 입력 및 재인증 연계.
+ * + *사유는 서비스가 강제한다. 화면에서만 막으면 URL 을 직접 부르는 경로가 뚫린다. + * 사유가 비어 있으면 {@link IllegalArgumentException} 으로 작업 자체를 거절한다 + * (접속기록 다운로드 사유 필수 처리와 같은 방식).
+ * + *모든 변경은 이력과 한 트랜잭션이다. {@code egovframework.com..*Impl.*} 이 + * 트랜잭션 어드바이스 대상이라, 회원정보 변경만 커밋되고 이력이 빠지는 상태가 생기지 않는다.
+ */ +public interface MberCryptoAdminService { + + /** 회원 목록(검색·페이징). 이름 검색은 완전일치(해시)로 처리된다. */ + List암호화 헬퍼를 필드로 들고 있는 이유: {@link MemberDataCipher}·{@link MemberDataHasher} + * 는 생성 시점에 키·pepper 를 읽고 없으면 예외를 던진다. 매 호출마다 새로 만들면 키 미설정을 + * 요청 시점에야 알게 되므로, 최초 사용 시 한 번 만들어 재사용한다(둘 다 불변·스레드 안전).
+ * + *왜 지연 생성인가: 필드 초기화로 생성하면 키가 없는 개발 환경에서 이 빈 하나 때문에 + * 컨텍스트 기동이 통째로 실패한다. 회원정보 암호화가 적용되지 않은 환경에서도 나머지 관리자 + * 기능은 떠야 하므로, 이 화면을 실제로 쓸 때 실패하게 미룬다.
+ */ +@Service("mberCryptoAdminService") +public class MberCryptoAdminServiceImpl implements MberCryptoAdminService { + + /** 파기 후 평문 이름 컬럼(NOT NULL)에 남기는 표식. */ + private static final String PII_PURGED_MARK = "(파기)"; + + /** 신규 등록 시 평문 이름 컬럼(NOT NULL)에 남기는 표식 — 평문은 저장하지 않는다. */ + private static final String ENCRYPTED_MARK = "(암호화)"; + + @Resource(name = "mberCryptoAdminDAO") + private MberCryptoAdminDAO mberCryptoAdminDAO; + + /** ESNTL_ID 채번 — 표준 회원관리(EgovMberManageServiceImpl)와 같은 채번기를 쓴다. */ + @Resource(name = "egovUsrCnfrmIdGnrService") + private EgovIdGnrService idgenService; + + private volatile MemberDataCipher cipher; + private volatile MemberDataHasher hasher; + + private MemberDataCipher cipher() { + MemberDataCipher c = cipher; + if (c == null) { + synchronized (this) { + c = cipher; + if (c == null) { + c = new MemberDataCipher(); + cipher = c; + } + } + } + return c; + } + + private MemberDataHasher hasher() { + MemberDataHasher h = hasher; + if (h == null) { + synchronized (this) { + h = hasher; + if (h == null) { + h = new MemberDataHasher(); + hasher = h; + } + } + } + return h; + } + + @Override + public List{@code COMTNGNRLMBER} 는 ZIP·ADRES·MBTLNUM 등이 NOT NULL 이라, 화면에서 비워 둔 값이 + * 그대로 null 로 내려가면 INSERT/UPDATE 가 제약 위반으로 실패한다. SQL 쪽에서 {@code IFNULL} + * 로 감싸는 방법도 있으나, 그러면 "이 컬럼은 비어도 되는가"의 답이 SQL 에 흩어진다. + * 값의 형태를 맞추는 일은 서비스가 한 곳에서 한다.
+ */ + private void normalizeBlanks(MberCryptoVO vo) { + vo.setZip(blankIfNull(vo.getZip())); + vo.setAdres(blankIfNull(vo.getAdres())); + vo.setDetailAdres(blankIfNull(vo.getDetailAdres())); + vo.setSexdstnCode(blankIfNull(vo.getSexdstnCode())); + vo.setMoblphonNo(blankIfNull(vo.getMoblphonNo())); + // MBER_EMAIL_ADRES 는 NULL 허용 컬럼이라 그대로 둔다(빈 문자열과 미입력을 구분). + } + + private String blankIfNull(String v) { + return v == null ? "" : v.trim(); + } + + /** 사유 필수 검증. 통과하면 앞뒤 공백을 다듬은 값을 돌려준다. */ + private String requireReason(String reason) { + if (!isNotBlank(reason)) { + throw new IllegalArgumentException("개인정보 처리 사유는 필수 입력입니다. (접근 이력에 기록됩니다)"); + } + String r = reason.trim(); + return r.length() > 500 ? r.substring(0, 500) : r; + } + + /** 변경된 항목명만 콤마로 잇는다(값은 담지 않는다). */ + private String diffItems(MberCryptoVO before, MberCryptoVO after) { + StringBuilder sb = new StringBuilder(); + appendIfChanged(sb, "이름", before.getMberNm(), after.getMberNm()); + appendIfChanged(sb, "이메일", before.getMberEmailAdres(), after.getMberEmailAdres()); + appendIfChanged(sb, "휴대폰", before.getMoblphonNo(), after.getMoblphonNo()); + appendIfChanged(sb, "우편번호", before.getZip(), after.getZip()); + appendIfChanged(sb, "주소", before.getAdres(), after.getAdres()); + appendIfChanged(sb, "상세주소", before.getDetailAdres(), after.getDetailAdres()); + appendIfChanged(sb, "성별", before.getSexdstnCode(), after.getSexdstnCode()); + appendIfChanged(sb, "회원상태", before.getMberSttus(), after.getMberSttus()); + return sb.toString(); + } + + private void appendIfChanged(StringBuilder sb, String label, String before, String after) { + String b = before == null ? "" : before; + String a = after == null ? "" : after; + if (b.equals(a)) { + return; + } + if (sb.length() > 0) { + sb.append(','); + } + sb.append(label); + } + + private boolean isNotBlank(String v) { + return v != null && v.trim().length() > 0; + } +} diff --git a/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoReauth.java b/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoReauth.java new file mode 100644 index 0000000..377e369 --- /dev/null +++ b/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoReauth.java @@ -0,0 +1,90 @@ +/** + * Class Name : MberCryptoReauth.java + * Description : 암호화 회원정보 화면 재인증 세션 표식 — 개인정보보호 기능개선 사업(추가제안 Action4) + * + * Modification Information + * + * 수정일 수정자 수정내용 + * ------- -------- --------------------------- + * 2026.08.27 개인정보보호 최초 생성 + * + * @since 2026. 08. 27 + * @version 1.0 + */ +package egovframework.com.cmm.privacy.crypto; + +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpSession; + +/** + * 관리자 회원정보 화면의 재인증 상태를 세션에 표시하고 유효시간을 판정한다. + * + *제안서 슬라이드16의 "조회·수정·삭제 시 사유 입력 및 재인증 연계" 요건이다. + * 로그인 자체가 아니라 이 화면에 들어올 때 한 번 더 본인을 확인한다 — 자리를 비운 사이 + * 열려 있던 세션으로 평문 개인정보를 훑는 경로를 끊는 것이 목적이다.
+ * + *왜 로그인 2차 인증(SECOND_FACTOR_DONE)을 재사용하지 않는가: 2차 인증은 로그인 시점에 + * 한 번 통과하면 세션 내내 유지된다(30분 자동 로그아웃까지). 그 표식을 그대로 쓰면 "다시 확인"이 + * 되지 못한다. 또 OTP 를 등록하지 않은 취급자는 2차 인증을 통과한 적이 없어 이 화면에 영영 + * 들어오지 못한다. 그래서 본인 비밀번호 재확인이라는 독립 표식을 둔다.
+ * + *유효시간을 짧게 두는 이유: 한 번 통과하면 세션이 끝날 때까지 열어 두는 방식은 + * 사실상 재인증이 없는 것과 같다. {@link #TTL_MILLIS}(10분)마다 다시 묻는다. 작업 중 만료되면 + * 재인증 화면을 거쳐 원래 위치로 돌아온다.
+ * + *연장하지 않는다. 통과 시각을 갱신하지 않고 최초 통과 시각을 그대로 두므로, 화면을 + * 계속 쓰더라도 10분마다 반드시 다시 확인한다(슬라이딩 만료가 아니다).
+ */ +public final class MberCryptoReauth { + + /** 재인증 통과 시각(밀리초)을 담는 세션 속성명. */ + public static final String SESSION_KEY = "MBER_CRYPTO_REAUTH_AT"; + + /** 재인증 유효시간 — 10분. */ + public static final long TTL_MILLIS = 10L * 60L * 1000L; + + private MberCryptoReauth() { + } + + /** 재인증이 유효한 상태인지 판정한다. 세션이 없거나 만료면 false. */ + public static boolean isVerified(HttpServletRequest request) { + HttpSession session = request.getSession(false); + if (session == null) { + return false; + } + Object v = session.getAttribute(SESSION_KEY); + if (!(v instanceof Long)) { + return false; + } + long at = ((Long) v).longValue(); + return (System.currentTimeMillis() - at) < TTL_MILLIS; + } + + /** 재인증 통과를 표시한다(현재 시각 기록). */ + public static void markVerified(HttpServletRequest request) { + request.getSession(true).setAttribute(SESSION_KEY, Long.valueOf(System.currentTimeMillis())); + } + + /** 재인증 표식을 지운다(화면을 벗어나거나 실패했을 때). */ + public static void clear(HttpServletRequest request) { + HttpSession session = request.getSession(false); + if (session != null) { + session.removeAttribute(SESSION_KEY); + } + } + + /** 남은 유효시간(초). 만료·미인증이면 0. 화면에 남은 시간을 알려 주기 위한 값이다. */ + public static long remainSeconds(HttpServletRequest request) { + HttpSession session = request.getSession(false); + if (session == null) { + return 0L; + } + Object v = session.getAttribute(SESSION_KEY); + if (!(v instanceof Long)) { + return 0L; + } + long elapsed = System.currentTimeMillis() - ((Long) v).longValue(); + long remain = TTL_MILLIS - elapsed; + return remain <= 0 ? 0L : remain / 1000L; + } +} diff --git a/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoSearchVO.java b/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoSearchVO.java new file mode 100644 index 0000000..a376736 --- /dev/null +++ b/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoSearchVO.java @@ -0,0 +1,117 @@ +/** + * Class Name : MberCryptoSearchVO.java + * Description : 암호화 회원정보 관리자 화면 검색조건 VO — 개인정보보호 기능개선 사업(추가제안 Action4) + * + * Modification Information + * + * 수정일 수정자 수정내용 + * ------- -------- --------------------------- + * 2026.08.27 개인정보보호 최초 생성 + * + * @since 2026. 08. 27 + * @version 1.0 + */ +package egovframework.com.cmm.privacy.crypto; + +import java.io.Serializable; + +/** + * 관리자 회원정보 검색조건 + 페이징. + * + *이름은 완전일치만 된다. 이름은 랜덤 IV AES-GCM 으로 저장돼 같은 이름도 매번 다른 + * 암호문이라 {@code LIKE '%홍%'} 이 원리적으로 불가능하다. 대신 검색 전용 HMAC 해시 컬럼 + * ({@code MBER_NM_HASH})에 인덱스가 걸려 있어 정확히 같은 이름은 빠르게 찾는다. + * 서비스가 입력 이름을 {@link MemberDataHasher#hashName(String)} 로 바꿔 {@link #setMberNmHash} + * 에 실어 주면 SQL 은 해시만 비교한다 — 평문 이름은 SQL 에 등장하지 않는다.
+ * + *이메일·휴대폰·회원ID 는 아직 평문 컬럼이라 전방일치 검색이 가능하다 + * (암호화 대상 확대는 후속 단계 — 확대되면 이 필드들도 해시 검색으로 옮겨야 한다).
+ */ +public class MberCryptoSearchVO implements Serializable { + + private static final long serialVersionUID = 1L; + + /** 회원ID(전방일치). */ + private String mberId; + /** 이름(완전일치 — 해시 검색). 화면 입력값이며 SQL 에는 해시만 나간다. */ + private String mberNm; + /** 이메일(전방일치). */ + private String mberEmailAdres; + /** 휴대폰(전방일치). */ + private String moblphonNo; + /** 회원상태 P/D. 빈값이면 전체. */ + private String mberSttus; + + /** 서비스가 채우는 이름 해시(파생값). 화면에서 직접 입력받지 않는다. */ + private String mberNmHash; + + private int pageIndex = 1; + private int recordCountPerPage = 10; + /** 조회 시작 offset(0-base) = (pageIndex-1) * recordCountPerPage */ + private int firstIndex = 0; + private int totalRecordCount = 0; + + private static final String LIKE_ESCAPE = "!"; + + public String getMberId() { return mberId; } + public void setMberId(String mberId) { this.mberId = mberId; } + + public String getMberNm() { return mberNm; } + public void setMberNm(String mberNm) { this.mberNm = mberNm; } + + public String getMberEmailAdres() { return mberEmailAdres; } + public void setMberEmailAdres(String mberEmailAdres) { this.mberEmailAdres = mberEmailAdres; } + + public String getMoblphonNo() { return moblphonNo; } + public void setMoblphonNo(String moblphonNo) { this.moblphonNo = moblphonNo; } + + public String getMberSttus() { return mberSttus; } + public void setMberSttus(String mberSttus) { this.mberSttus = mberSttus; } + + public String getMberNmHash() { return mberNmHash; } + public void setMberNmHash(String mberNmHash) { this.mberNmHash = mberNmHash; } + + public int getPageIndex() { return pageIndex; } + public void setPageIndex(int pageIndex) { this.pageIndex = pageIndex; } + + public int getRecordCountPerPage() { return recordCountPerPage; } + public void setRecordCountPerPage(int recordCountPerPage) { this.recordCountPerPage = recordCountPerPage; } + + public int getFirstIndex() { return firstIndex; } + public void setFirstIndex(int firstIndex) { this.firstIndex = firstIndex; } + + public int getTotalRecordCount() { return totalRecordCount; } + public void setTotalRecordCount(int totalRecordCount) { this.totalRecordCount = totalRecordCount; } + + /** 회원ID 전방일치 바인딩값. */ + public String getMberIdLike() { return toPrefixLike(mberId); } + + /** 이메일 전방일치 바인딩값. */ + public String getMberEmailAdresLike() { return toPrefixLike(mberEmailAdres); } + + /** 휴대폰 전방일치 바인딩값. */ + public String getMoblphonNoLike() { return toPrefixLike(moblphonNo); } + + /** + * 전방일치 LIKE 값으로 변환한다. 사용자가 넣은 {@code %} {@code _} 는 와일드카드가 아니라 + * 글자 그대로 찾게 이스케이프한다(SQL 은 {@code ESCAPE '!'} 로 받는다). + */ + private String toPrefixLike(String v) { + if (v == null) { + return null; + } + String t = v.trim(); + if (t.length() == 0) { + return null; + } + StringBuilder sb = new StringBuilder(t.length() + 8); + for (int i = 0; i < t.length(); i++) { + char c = t.charAt(i); + if (c == '%' || c == '_' || c == '!') { + sb.append(LIKE_ESCAPE); + } + sb.append(c); + } + return sb.append('%').toString(); + } +} diff --git a/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoVO.java b/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoVO.java new file mode 100644 index 0000000..3f7be27 --- /dev/null +++ b/src/main/java/egovframework/com/cmm/privacy/crypto/MberCryptoVO.java @@ -0,0 +1,110 @@ +/** + * Class Name : MberCryptoVO.java + * Description : 암호화 회원정보 관리자 화면 VO — 개인정보보호 기능개선 사업(추가제안 Action4) + * + * Modification Information + * + * 수정일 수정자 수정내용 + * ------- -------- --------------------------- + * 2026.08.27 개인정보보호 최초 생성 — 관리자 전용 복호화 CRUD 화면 + * + * @since 2026. 08. 27 + * @version 1.0 + */ +package egovframework.com.cmm.privacy.crypto; + +import java.io.Serializable; + +/** + * 관리자 전용 회원정보 화면이 다루는 {@code COMTNGNRLMBER} 한 행. + * + *{@code mberNm} 에 무엇이 들어있는가는 단계에 따라 다르다. DAO 가 조회하는 컬럼은 + * {@code MBER_NM_ENC}(암호문)이고, DAO 반환 직전 {@link MemberNmDecryptSupport} 가 같은 자리에 + * 평문을 되돌려 쓴다 — 서비스·화면은 항상 평문으로 본다. 저장(등록·수정) 방향은 서비스가 + * 평문을 받아 {@link MemberDataCipher#encrypt(String)}·{@link MemberDataHasher#hashName(String)} + * 로 {@code mberNmEnc}/{@code mberNmHash} 를 채운 뒤 DAO 에 넘긴다.
+ * + *평문 컬럼 {@code MBER_NM} 은 이 화면이 건드리지 않는다. 암호화 이관 당시 롤백 창구로 + * 남겨둔 컬럼이라, 관리자 화면이 여기에 새 평문을 쓰기 시작하면 "이관이 끝나면 평문 컬럼을 지운다"는 + * 계획이 조용히 무너진다. 신규 등록 시에도 평문 자리에는 마스킹 표식만 넣는다 + * ({@code MBER_NM} 이 NOT NULL 이라 빈 값을 넣을 수 없기 때문이다).
+ */ +public class MberCryptoVO implements Serializable { + + private static final long serialVersionUID = 1L; + + /** 회원ID(PK). */ + private String mberId; + /** 내부 식별자 ESNTL_ID. */ + private String uniqId; + + /** + * 이름 — 조회 결과에서는 복호화된 평문, 등록·수정 입력에서도 평문. + * (DB 컬럼 MBER_NM_ENC 와 이 필드를 잇는 변환은 서비스·DAO 가 담당한다) + */ + private String mberNm; + /** 이름 암호문(내부 전달용). 화면에 노출하지 않는다. */ + private String mberNmEnc; + /** 이름 검색용 HMAC 해시(내부 전달용). */ + private String mberNmHash; + /** 암호화 키 버전. 미암호화 행은 null. */ + private Integer cryptoKeyVer; + + private String mberEmailAdres; + private String moblphonNo; + private String zip; + private String adres; + private String detailAdres; + private String sexdstnCode; + /** 회원상태 — P:정상 D:탈퇴(기존 코드계 그대로). */ + private String mberSttus; + private String sbscrbDe; + + /** 신규 등록 시 초기 비밀번호(평문 입력). 저장 시 솔트 해시로 변환되며 조회에는 실리지 않는다. */ + private String password; + + public String getMberId() { return mberId; } + public void setMberId(String mberId) { this.mberId = mberId; } + + public String getUniqId() { return uniqId; } + public void setUniqId(String uniqId) { this.uniqId = uniqId; } + + public String getMberNm() { return mberNm; } + public void setMberNm(String mberNm) { this.mberNm = mberNm; } + + public String getMberNmEnc() { return mberNmEnc; } + public void setMberNmEnc(String mberNmEnc) { this.mberNmEnc = mberNmEnc; } + + public String getMberNmHash() { return mberNmHash; } + public void setMberNmHash(String mberNmHash) { this.mberNmHash = mberNmHash; } + + public Integer getCryptoKeyVer() { return cryptoKeyVer; } + public void setCryptoKeyVer(Integer cryptoKeyVer) { this.cryptoKeyVer = cryptoKeyVer; } + + public String getMberEmailAdres() { return mberEmailAdres; } + public void setMberEmailAdres(String mberEmailAdres) { this.mberEmailAdres = mberEmailAdres; } + + public String getMoblphonNo() { return moblphonNo; } + public void setMoblphonNo(String moblphonNo) { this.moblphonNo = moblphonNo; } + + public String getZip() { return zip; } + public void setZip(String zip) { this.zip = zip; } + + public String getAdres() { return adres; } + public void setAdres(String adres) { this.adres = adres; } + + public String getDetailAdres() { return detailAdres; } + public void setDetailAdres(String detailAdres) { this.detailAdres = detailAdres; } + + public String getSexdstnCode() { return sexdstnCode; } + public void setSexdstnCode(String sexdstnCode) { this.sexdstnCode = sexdstnCode; } + + public String getMberSttus() { return mberSttus; } + public void setMberSttus(String mberSttus) { this.mberSttus = mberSttus; } + + public String getSbscrbDe() { return sbscrbDe; } + public void setSbscrbDe(String sbscrbDe) { this.sbscrbDe = sbscrbDe; } + + public String getPassword() { return password; } + public void setPassword(String password) { this.password = password; } +} diff --git a/src/main/resources/egovframework/sqlmap/config/mysql/sql-map-config-mysql-0-site.xml b/src/main/resources/egovframework/sqlmap/config/mysql/sql-map-config-mysql-0-site.xml index 7ed2e38..ccbccf3 100644 --- a/src/main/resources/egovframework/sqlmap/config/mysql/sql-map-config-mysql-0-site.xml +++ b/src/main/resources/egovframework/sqlmap/config/mysql/sql-map-config-mysql-0-site.xml @@ -152,4 +152,7 @@| NO. | +접속자ID | +
+ |
+ 원본 확인 | +
|---|---|---|---|
|
+ |
+
+ <%-- 접속기록 조회화면(#47)으로 조건을 넘겨 원본을 바로 확인한다.
+ 인증실패반복은 처리결과 F, 대량조회는 처리구분 S 로 좁혀 준다. --%>
+ &processResult=F |
+