| 메세지 코드 | ++ | ||
|---|---|---|---|
| 제목 | ++ | ||
| 유형 | ++ | 상태 | ++ |
| 수신자명 | ++ | 메신저 ID | ++ |
| 이메일 | ++ | 휴대폰 | ++ |
| 요청 시간 | ++ | 발송 시간 | ++ |
| EAI 인터페이스 ID | ++ | 서비스 ID | ++ |
| UMS UID | ++ | ||
| 메세지 내용 | ++ | ||
elink-portal-common 의 {@code template.repository.MessageRequestRepository}(JpaRepository) 와 + * 단순 클래스명이 겹치면 Spring Data 빈 이름이 충돌하므로(둘 다 admin 컨텍스트에 스캔됨) + * 이름을 분리한다. 또한 QueryDSL {@code findAll(predicate, pageable)} 를 쓰기 위해 + * {@link BaseRepository} 를 상속한다.
+ */ +@EMSDataSource +public interface MessageRequestEmsRepository extends BaseRepository본문(message) 안에 섞여 있는 개인정보/인증정보를 패턴으로 찾아 마스킹하고, + * 패턴 종류별로 색상 강조 {@code } 으로 감싼 안전한 HTML 을 만든다. + * 매칭되지 않은 영역과 마스킹 결과 모두 HTML escape 하므로 본문에 스크립트가 있어도 무력화된다.
+ * + *+ * 이메일 test@gmail.com → <span class="mask-email">**st@gmail.com</span> + * 휴대폰(하이픈) 010-1234-5678 → <span class="mask-phone">010-12**-56**</span> + * 6자리+ 숫자 123456 → <span class="mask-digits">123***</span> (앞 3자리 제외) + * 메신저ID kakao_abcd → kakao_ab** (뒤 2자리) + *+ * + *
실제 이메일/휴대폰 마스킹 규칙은 표준 구현 + * {@link com.eactive.eai.common.util.MaskingUtils}(elink-online-core)에 위임한다.
+ */ +public final class MessagePatternMaskingUtils { + + private MessagePatternMaskingUtils() {} + + private static final int DIGITS_KEEP_HEAD = 3; + + /** + * 매칭 우선순위(이메일 > 하이픈 휴대폰 > 6자리+ 숫자)를 단일 패스로 보장하는 결합 정규식. + * 휴대폰 하이픈 형식이 "6자리 이상 숫자" 규칙에 이중 적용되지 않도록 한 Matcher 로 순회한다. + */ + private static final Pattern COMBINED = Pattern.compile( + "(?조회 전용 + PENDING→FAILED 상태 전환만 제공한다. (등록/수정/삭제 없음)
+ */ +@Controller +@RequiredArgsConstructor +public class MessageRequestManController extends BaseAnnotationController { + + private final MessageRequestManService messageRequestManService; + + @GetMapping(value = "/onl/apim/messagerequest/messageRequestMan.view") + public void view() { + // 목록 view + } + + @GetMapping(value = "/onl/apim/messagerequest/messageRequestMan.view", params = "cmd=DETAIL") + public String detailView() { + return "/onl/apim/messagerequest/messageRequestManDetail"; + } + + @PostMapping(value = "/onl/apim/messagerequest/messageRequestMan.json", params = "cmd=LIST") + public ResponseEntity개인정보는 모두 마스킹된 값으로 채워지며, 본문(messageHtml)은 패턴 마스킹 + 색상강조가 적용된 + * 안전한 HTML 이다. 날짜는 표시용(short)/툴팁용(full) 두 가지 포맷 문자열로 제공한다.
+ */ +@Data +public class MessageRequestUI { + + private String id; + + /* 제목/코드 — subject 가 없으면 화면에서 messageCode 로 대체 표기 */ + private String messageCode; // MessageCode enum name (제목 마우스오버/대체용) + private String messageCodeName; // MessageCode.getDescription() 한글명 + private String subject; + private String messageType; // EMAIL/SMS 등 + + /* 본문 — 패턴 마스킹 + span 색상강조된 안전 HTML */ + private String messageHtml; + + /* 수신자 (마스킹) */ + private String username; + private String email; + private String phone; + private String messengerId; + + /* 발송 메타 */ + private String umsUid; + private String requestStatus; // PENDING/SENT/FAILED + private String eaiInterfaceId; + private String serviceId; + + /* 요청/발송 시간 — 표시용(short) / 툴팁용(full) */ + private String requestDateShort; // MM-dd(E) HH:mm + private String requestDateFull; // yyyy-MM-dd (EEE) HH:mm:ss + private String sentDateShort; + private String sentDateFull; +} diff --git a/src/test/java/com/eactive/eai/rms/onl/apim/masking/MessagePatternMaskingUtilsTest.java b/src/test/java/com/eactive/eai/rms/onl/apim/masking/MessagePatternMaskingUtilsTest.java new file mode 100644 index 0000000..81d5b3f --- /dev/null +++ b/src/test/java/com/eactive/eai/rms/onl/apim/masking/MessagePatternMaskingUtilsTest.java @@ -0,0 +1,135 @@ +package com.eactive.eai.rms.onl.apim.masking; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +/** + * 메세지 본문/메신저ID 패턴 마스킹 + 색상강조 + XSS escape 검증. + */ +class MessagePatternMaskingUtilsTest { + + // --- 이메일 --- + + @Test + @DisplayName("본문 이메일 — mask-email span + 표준 이메일 마스킹") + void maskAndHighlight_email() { + assertEquals("**st1**@test.com", + MessagePatternMaskingUtils.maskAndHighlight("test123@test.com")); + } + + // --- 휴대폰(하이픈) --- + + @Test + @DisplayName("본문 휴대폰(하이픈) — mask-phone span + 세그먼트별 뒤2자리 마스킹") + void maskAndHighlight_phoneHyphen() { + assertEquals("010-12**-56**", + MessagePatternMaskingUtils.maskAndHighlight("010-1234-5678")); + } + + // --- 6자리 이상 숫자 (앞 3자리 제외 전체 마스킹) --- + + @Test + @DisplayName("본문 6자리 숫자 — 앞 3자리 제외 전체 마스킹(mask-digits)") + void maskAndHighlight_digits6() { + assertEquals("123***", + MessagePatternMaskingUtils.maskAndHighlight("123456")); + } + + @Test + @DisplayName("본문 하이픈 없는 휴대폰(11자리) — 6자리+ 숫자 규칙 적용") + void maskAndHighlight_phoneNoHyphen() { + assertEquals("010********", + MessagePatternMaskingUtils.maskAndHighlight("01012345678")); + } + + @Test + @DisplayName("5자리 이하 숫자는 마스킹하지 않음") + void maskAndHighlight_digitsUnder6() { + assertEquals("12345", MessagePatternMaskingUtils.maskAndHighlight("12345")); + } + + // --- 우선순위 / 혼합 --- + + @Test + @DisplayName("하이픈 휴대폰이 숫자 규칙에 이중 적용되지 않음 (phone 우선)") + void maskAndHighlight_priority() { + String result = MessagePatternMaskingUtils.maskAndHighlight("010-1234-5678"); + assertTrue(result.contains("mask-phone")); + assertFalse(result.contains("mask-digits")); + } + + @Test + @DisplayName("텍스트 + 이메일/휴대폰/숫자 혼합 — 각 패턴별 span 생성, 일반 텍스트는 보존") + void maskAndHighlight_mixed() { + String result = MessagePatternMaskingUtils.maskAndHighlight( + "인증요청 test123@test.com 전화 010-1234-5678 코드 123456 끝"); + assertTrue(result.contains("**st1**@test.com")); + assertTrue(result.contains("010-12**-56**")); + assertTrue(result.contains("123***")); + assertTrue(result.contains("인증요청")); + assertTrue(result.contains("끝")); + // 원문 일부가 그대로 노출되지 않아야 함 + assertFalse(result.contains("test123@")); + assertFalse(result.contains("010-1234-5678")); + assertFalse(result.contains("123456")); + } + + // --- XSS / HTML escape --- + + @Test + @DisplayName("매칭 외 영역의 HTML 태그는 escape 되어 무력화") + void maskAndHighlight_escapesHtml() { + assertEquals("<b>hi</b>", + MessagePatternMaskingUtils.maskAndHighlight("hi")); + } + + @Test + @DisplayName("script 태그 escape") + void maskAndHighlight_escapesScript() { + String result = MessagePatternMaskingUtils.maskAndHighlight(""); + assertFalse(result.contains("