vpd-permission-poc/docs/design/462-predicate-injection-defense/README.md

설계서: Predicate injection 및 권한 우회 방어 테스트 (#462)

상태: Approved 작성: [AI] Architect · 최종수정: 2026-06-25 추적성 — Redmine: #462 · 관련 ADR: 없음 · 구현 파일: sql/adb/27_agent_ords_security_dynamic_vpd_filter_test.sql · 테스트: SQLcl 27, ./run.sh backoffice-vpd-ords-test, mvn test

1. 목적 (Why)

VPD predicate function이 DB에 저장된 rule_column/rule_value를 SQL 문자열로 변환하므로, quote/OR/주석/함수형 컬럼명 입력이 권한 우회로 이어지지 않는지 테스트로 고정한다.

2. 범위 (Scope)

• 포함: rule_value injection 문자열 escape 검증, rule_column injection fail-closed 검증, target mismatch 기본 거부 검증.
• 제외: UI 입력 fuzzing, ORDS response SQL 노출 정책 변경.

3. 인수조건 (Acceptance Criteria)

• rule_value에 single quote가 있어도 literal escape가 적용된다.
• rule_value에 OR 1=1 또는 --가 있어도 predicate 구조를 탈출하지 않는다.
• rule_column에 함수 호출/표현식이 들어가면 해당 rule은 무시되고 1 = 0이 된다.
• p_object가 권한의 target_name과 다르면 1 = 0이 된다.
• 기존 정상/경계 테스트와 ORDS 회귀 테스트가 유지된다.

4. 컨텍스트 & 제약

• safe_column은 DBMS_ASSERT.SIMPLE_SQL_NAME과 all_tab_columns 존재 확인을 사용한다.
• quote_literal은 single quote를 두 번으로 escape한다.
• 테스트 데이터는 456000~456999 범위를 재사용한다.

5. 아키텍처 개요

malicious cb_permission_rule rows
  -> cb_agent_doc_vpd_filter('ADMIN', 'CB_V_SEARCH_DOCUMENTS')
  -> assert predicate contains escaped literal or equals 1 = 0

6. 데이터 모델

• injection users:
  • 456107: quote 포함 값
  • 456108: OR 1=1 -- 포함 값
  • 456109: 함수형 컬럼명
  • 456110: target mismatch 확인

7. 함수 명세 (Function Specs)

함수	책임(1줄)	시그니처(잠정)	입력	출력	에러/실패	복잡?
assert_contains_for_object	특정 object에 대한 predicate 포함 검증	PL/SQL local procedure	label, user, object, expected	없음	raise_application_error	단순
assert_equals_for_object	특정 object에 대한 predicate 일치 검증	PL/SQL local procedure	label, user, object, expected	없음	raise_application_error	단순

8. 흐름 / 알고리즘

1. 악성 문자열이 들어간 test user/role/permission/rule을 생성한다.
2. predicate function을 직접 호출한다.
3. 값 기반 injection은 quote escaped literal로 남는지 확인한다.
4. 컬럼 기반 injection은 1 = 0이 되는지 확인한다.
5. target mismatch는 1 = 0인지 확인한다.

9. 엣지케이스 & 에러 처리

• TITLE = 'HR' OR '1'='1' 형태 문자열은 전체가 literal 값이어야 한다.
• DOC_ID) OR 1=1 -- 같은 컬럼명은 컬럼 검증 실패로 무시되어야 한다.
• 모든 rule이 무시되면 whitelist 기본값 1 = 0이어야 한다.

10. 테스트 계획

• @sql/adb/26_agent_ords_security_dynamic_vpd_filter.sql
• @sql/adb/27_agent_ords_security_dynamic_vpd_filter_test.sql
• ./run.sh backoffice-vpd-ords-test
• mvn test

11. 리스크 & 대안 검토

• 선택: DB 함수 직접 테스트. 공격 문자열이 실제 predicate 문자열로 어떻게 변환되는지 가장 직접적으로 확인할 수 있다.
• 대안: ORDS만 테스트. 결과 행 수는 확인 가능하지만 predicate escaping 자체를 확인하기 어렵다.

12. 미해결 질문 (Open Questions)

• 더 넓은 fuzzing은 별도 보안 테스트 체계가 필요할 때 확장한다.