[Developer] #424 implement VPD ORDS backoffice

Refs #424

docs/design/424-spring-boot-vpd-backoffice/README.md

@@ -144,6 +144,7 @@ src/test/java/com/cloudhandson/vpdbackoffice/
 - `owner`, `object_name`, `column_name`은 Oracle identifier 허용 문자로 검증하되, 검증 후에도 SQL 문자열 직접 조합에 사용하지 않는다.
 - ORDS 검증 대상은 `CB_PROTECTED_OBJECT.enabled_yn = 'Y'`인 행만 허용한다.
 - Token 원문은 발급 응답 화면에서만 사용하고 DB, log, audit에는 저장하지 않는다.
+- 기존 ORDS 패키지가 `STANDARD_HASH(p_bearer_key, 'SHA256')`로 Bearer Key를 검증하므로 `key_hash`는 SHA-256으로 저장한다. HMAC 또는 pepper 적용은 DB 패키지 검증 방식까지 함께 바꾸는 후속 작업으로 둔다.
 - `rule_type`은 `ALL`, `MY_DEPT`, `SELF`, `REGION`, `CUSTOM_PREDICATE` 중 허용 값만 저장한다.
 - `CUSTOM_PREDICATE`는 초기 구현에서 비활성화한다.
 
@@ -182,7 +183,7 @@ src/test/java/com/cloudhandson/vpdbackoffice/
 1. 관리자가 사용자와 만료일을 선택한다.
 2. Service가 사용자 활성 상태와 만료일을 검증한다.
 3. `vpd_live_` prefix와 충분한 난수 token body를 생성한다.
-4. server-side pepper를 사용해 hash를 만든다.
+4. 기존 ORDS 패키지와 호환되는 SHA-256 hash를 만든다.
 5. prefix, hash, 만료일만 저장한다.
 6. 원문 token은 발급 완료 화면에 한 번만 표시한다.
 

docs/design/424-spring-boot-vpd-backoffice/fn-issueToken.md

@@ -37,7 +37,7 @@ IssuedToken issueToken(TokenIssueCommand command)
 3. 정책상 최대 유효 기간을 넘으면 실패한다.
 4. `vpd_live_` prefix와 256bit 이상 난수 body를 생성한다.
 5. 원문 token을 조합한다.
-6. server-side pepper를 읽어 HMAC-SHA256 hash를 만든다.
+6. 기존 ORDS 패키지의 `STANDARD_HASH(..., 'SHA256')` 검증과 호환되는 SHA-256 hash를 만든다.
 7. `key_prefix`, `key_hash`, `expires_at`, `created_by`를 저장한다.
 8. audit log를 저장한다.
 9. 원문 token을 포함한 `IssuedToken`을 반환한다.
@@ -49,7 +49,6 @@ IssuedToken issueToken(TokenIssueCommand command)
 | 사용자가 없음 | 발급 중단 | `UserNotFoundException` |
 | 비활성 사용자 | 발급 중단 | `InactiveUserException` |
 | 만료일이 과거 | 발급 중단 | `InvalidTokenExpiryException` |
-| pepper 설정 없음 | 발급 중단 | `TokenConfigurationException` |
 | DB 저장 실패 | transaction rollback | `DataAccessException` |
 
 ## 7. 엣지케이스
@@ -78,7 +77,7 @@ IssuedToken issueToken(TokenIssueCommand command)
 - [ ] 정상: 저장된 값에 원문 token이 포함되지 않음
 - [ ] 실패: 비활성 사용자 입력 시 예외
 - [ ] 실패: 과거 만료일 입력 시 예외
-- [ ] 실패: pepper 설정 없음
+- [ ] 정상: `cb_hr_key` hash가 Oracle `STANDARD_HASH('cb_hr_key', 'SHA256')`와 같은 값
 
 ## 11. 추적성