feat: enforce DDS token access through common grants
This commit is contained in:
devmrko
@@ -1,7 +1,7 @@
|
||||
# 설계서: 기술 태그 기반 벡터 지식자료 검색과 VPD 연결
|
||||
|
||||
> **상태**: 제품형 운영 흐름 구현 · DDS 병행 검증 완료 · 운영 확장 항목 별도
|
||||
> **추적성**: Redmine #565, #566 · 기준 구현: `28_agent_ords_vector_tag_vpd_setup.sql`, `29_agent_ords_vector_search_ords.sql`, `32_dds_vector_tag_setup.sql`
|
||||
> **상태**: 제품형 운영 흐름 구현 · DDS 병행 검증 완료 · 객체별 Data Grant predicate 적용 · 운영 확장 항목 별도
|
||||
> **추적성**: Redmine #565, #566 · 기준 구현: `28_agent_ords_vector_tag_vpd_setup.sql`, `29_agent_ords_vector_search_ords.sql`, `32_dds_vector_tag_setup.sql`, `34_dds_token_data_grant_common_auth.sql`
|
||||
|
||||
## 1. 한 문장으로 이해하기
|
||||
|
||||
@@ -185,17 +185,18 @@ backoffice의 `/objects` 화면은 이 객체에 일반 Handler를 생성하지
|
||||
|
||||
## 10. DDS 병행 시나리오: 같은 TAG 권한, 단일 기술 사용자
|
||||
|
||||
VPD에서 검증한 기술 태그 권한을 DDS에서도 고객별 DDS 계정으로 복제하지 않고 적용할 수 있는지 별도로 확인했다. 업무 권한의 원천은 동일한 `CB_PERMISSION`·`CB_PERMISSION_RULE`이다. DDS 설치 스크립트는 이 규칙을 벡터 검색 뷰와 연결하고, 애플리케이션 함수가 토큰을 받아 같은 규칙을 `WHERE`로 집행한다.
|
||||
VPD에서 검증한 기술 태그 권한을 DDS에서도 고객별 DDS 계정으로 복제하지 않고 적용할 수 있는지 별도로 확인했다. 업무 권한의 원천은 동일한 `CB_PERMISSION`·`CB_PERMISSION_RULE`이다. DDS 설치 스크립트는 이 규칙을 벡터 검색 뷰의 객체별 Data Grant predicate와 연결한다. 토큰 함수는 먼저 `CB_AGENT_CTX`에 업무 사용자를 설정하고, Data Grant predicate가 그 Context와 공통 권한 테이블을 사용해 각 행을 평가한다.
|
||||
|
||||
```text
|
||||
Bearer token
|
||||
→ CB_AGENT_BEARER_KEY에서 사용자 식별
|
||||
→ CB_APP_USER의 직접 역할/활성 그룹 역할 계산
|
||||
→ ALLOW TAG는 OR, DENY TAG는 NOT EXISTS
|
||||
→ CB_DDS_VECTOR_SEARCH_DOCUMENTS 조회
|
||||
→ CB_DDS_VECTOR_SEARCH_DOCUMENTS의 DATA GRANT predicate 평가
|
||||
→ 허용된 청크 반환
|
||||
```
|
||||
|
||||
하나의 `dds_demo_both` DDS 기술 사용자 세션에서 임시 `CB_SIMPLE_DDS_TOKEN_SELECT(token)` 함수를 실행한 결과는 다음과 같다.
|
||||
하나의 `dds_demo_token` DDS 기술 사용자 세션에서 `CB_AGENT_CTX_PKG.SET_USER_BY_BEARER(token)`을 호출한 뒤 객체별 `ADMIN.DDS_DEMO_TOKEN_VECTOR_GRANT`가 공통 권한을 평가한 결과는 다음과 같다.
|
||||
|
||||
| 토큰 사용자 | 반환 청크 |
|
||||
|---|---|
|
||||
@@ -203,6 +204,6 @@ Bearer token
|
||||
| `agent_fin_self` | `28002` (1건) |
|
||||
| `agent_all` | `28001`, `28002`, `28003` (3건) |
|
||||
|
||||
이 방식의 의미는 “DDS가 토큰을 자동으로 이해한다”가 아니다. `DATA GRANT`에 호출 시점 토큰 인자를 직접 넘기는 것이 아니라, 토큰을 받는 함수/API가 공통 권한 테이블을 조회해 보호 뷰의 `WHERE`를 결정한다. 따라서 현재 제품형 기본 시나리오는 **단일 DDS 기술 사용자 + 토큰 WHERE 어댑터 + 공통 업무 권한**이다. 드라이버가 SQL 실행 전에 `EndUserSecurityContext`를 전달하는 순수 DDS Context 방식은 별도 확장 경계이며, 그 경우에만 `ORA_END_USER_CONTEXT`를 참조하는 일반 `DATA GRANT`를 설계한다.
|
||||
이 방식의 의미는 “DDS가 토큰 문자열을 Data Grant 문법의 인자로 받는다”가 아니다. `DATA GRANT`는 `ON` 대상 뷰와 저장된 SQL predicate를 선언하고, 토큰 함수가 그 predicate가 참조할 Context를 만든다. 따라서 현재 제품형 기본 시나리오는 **단일 DDS 기술 사용자 + 객체별 DATA GRANT predicate + 공통 업무 권한**이다. 여러 보호 뷰/테이블에는 각각 Data Grant를 만들고, 각 predicate에서 논리 권한 대상과 행 규칙을 매핑한다. 드라이버가 SQL 실행 전에 `EndUserSecurityContext`를 전달하는 순수 DDS Context 방식은 별도 확장 경계이며, 그 경우에는 `ORA_END_USER_CONTEXT`를 참조하는 일반 `DATA GRANT`를 설계한다.
|
||||
|
||||
토큰, 임시 함수, 임시 권한은 검증 뒤 삭제했다. 새 태그나 역할을 추가할 때도 VPD와 DDS가 각각 고객 사용자를 복제하는 대신, 공통 `CB_*` 권한을 먼저 수정하고 두 집행 경계의 회귀 테스트를 함께 실행한다.
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
# 독립 VPD·DDS 데모 구성
|
||||
|
||||
> **상태**: VPD·DDS 병행 검증 완료, 운영 전환 항목 별도
|
||||
> **상태**: VPD·DDS 병행 검증 완료, 토큰 기반 객체별 Data Grant 적용 완료
|
||||
> **추적성**: Redmine #565, #566 · DDS 구현 커밋 `1e48864`
|
||||
> **기준 구현**: `sql/adb/32_dds_vector_tag_setup.sql`, `dds-backoffice/src/main/java/com/cloudhandson/ddsbackoffice/service/DdsGrantPublisher.java`
|
||||
> **기준 구현**: `sql/adb/32_dds_vector_tag_setup.sql`, `sql/adb/34_dds_token_data_grant_common_auth.sql`, `dds-backoffice/src/main/java/com/cloudhandson/ddsbackoffice/service/DdsGrantPublisher.java`, `dds-backoffice/src/main/java/com/cloudhandson/ddsbackoffice/service/DdsVectorKnowledgeService.java`
|
||||
|
||||
## 목적
|
||||
|
||||
VPD와 Oracle Deep Data Security(DDS)를 별도 인스턴스로 운영하면서도, 고객의 업무 권한을 정의하는 공통 테이블을 기준으로 같은 검색 시나리오를 비교한다. 고객마다 DDS 계정을 만드는 것이 목표가 아니다. 현재 기본 데모는 하나의 DDS 기술 사용자 세션에 Bearer 토큰을 함수 파라미터로 전달하고, 함수가 공통 권한 테이블을 읽어 `WHERE` 조건으로 결과를 제한한다.
|
||||
VPD와 Oracle Deep Data Security(DDS)를 별도 인스턴스로 운영하면서도, 고객의 업무 권한을 정의하는 공통 테이블을 기준으로 같은 검색 시나리오를 비교한다. 고객마다 DDS 계정을 만드는 것이 목표가 아니다. 현재 기본 데모는 하나의 DDS 기술 사용자 세션에서 Bearer 토큰으로 Context를 만들고, 객체별 Data Grant predicate가 공통 권한 테이블을 읽어 결과를 제한한다.
|
||||
|
||||
## 인스턴스 경계
|
||||
|
||||
@@ -14,8 +14,8 @@ VPD와 Oracle Deep Data Security(DDS)를 별도 인스턴스로 운영하면서
|
||||
|---|---|---|
|
||||
| 실행 디렉터리 | `/home/opc/apps/vpd-backoffice` | `/home/opc/apps/dds-backoffice` |
|
||||
| 기본 포트 | `8082` | `8083` |
|
||||
| 사용자 식별 | 공통 DB 계정 + Bearer/세션 컨텍스트 | 단일 DDS 기술 사용자 + 토큰 파라미터 함수(기본 경로) |
|
||||
| 권한 기준 | 업무 권한 테이블 + VPD 함수 | 같은 업무 권한 테이블 + 토큰 기반 `WHERE`; DDS `DATA ROLE/GRANT`는 별도 경계 |
|
||||
| 사용자 식별 | 공통 DB 계정 + Bearer/세션 컨텍스트 | 단일 DDS 기술 사용자 + 토큰 Context(기본 경로) |
|
||||
| 권한 기준 | 업무 권한 테이블 + VPD 함수 | 같은 업무 권한 테이블 + 객체별 DDS `DATA GRANT` predicate |
|
||||
| 보호 객체 | `V_CUSTOMERS_*` / VPD 전용 객체 | `V_DDS_CUSTOMERS_*` / DDS 전용 객체 |
|
||||
| 운영 프로세스 | VPD start/stop/status | DDS start/stop/status |
|
||||
|
||||
@@ -28,7 +28,7 @@ VPD와 Oracle Deep Data Security(DDS)를 별도 인스턴스로 운영하면서
|
||||
- 권한 없는 사용자의 default deny
|
||||
- 보호 VIEW 우회 시도 차단
|
||||
|
||||
## DDS 기본 시나리오: 한 사용자, 토큰 파라미터, 공통 `WHERE`
|
||||
## DDS 기본 시나리오: 한 기술 사용자, 토큰 Context, 객체별 `DATA GRANT`
|
||||
|
||||
### 일반 사용자가 이해하는 흐름
|
||||
|
||||
@@ -38,27 +38,33 @@ Bearer 토큰
|
||||
→ CB_APP_USER와 연결
|
||||
→ 직접 역할 + 활성 그룹 역할 계산
|
||||
→ CB_PERMISSION_RULE의 TAG 허용/거부 규칙 계산
|
||||
→ CB_DDS_VECTOR_SEARCH_DOCUMENTS에 함수가 WHERE 적용
|
||||
→ CB_DDS_VECTOR_SEARCH_DOCUMENTS의 DATA GRANT predicate가 행을 평가
|
||||
→ 허용된 청크만 반환
|
||||
```
|
||||
|
||||
`dds_demo_both` 하나의 DDS 기술 사용자 세션에서 임시 함수 `ADMIN.CB_SIMPLE_DDS_TOKEN_SELECT(token)`로 위 흐름을 검증했다. 함수는 고객용 DDS 계정을 새로 만들지 않고 토큰으로 업무 사용자를 식별한다. 같은 ALLOW 권한의 태그는 OR로 합치고, DENY 태그는 `NOT EXISTS`로 제외한다.
|
||||
`dds_demo_token` 하나의 DDS 기술 사용자 세션에서 토큰 함수가 `CB_AGENT_CTX`를 설정하고, 객체별 Data Grant `ADMIN.DDS_DEMO_TOKEN_VECTOR_GRANT`의 predicate 함수가 공통 권한을 다시 평가하는 흐름을 검증했다. 고객마다 DDS 계정을 만들지 않고 토큰으로 업무 사용자를 식별한다. 같은 ALLOW 권한의 태그는 OR로 합치고, DENY 태그는 `NOT EXISTS` 의미로 제외한다.
|
||||
|
||||
호출 계약은 의도적으로 단순하다.
|
||||
|
||||
```sql
|
||||
SELECT ADMIN.CB_SIMPLE_DDS_TOKEN_SELECT(:bearer_token)
|
||||
FROM dual;
|
||||
BEGIN
|
||||
ADMIN.CB_AGENT_CTX_PKG.SET_USER_BY_BEARER(:bearer_token);
|
||||
END;
|
||||
/
|
||||
|
||||
SELECT chunk_id, tech_tag
|
||||
FROM ADMIN.CB_DDS_VECTOR_SEARCH_DOCUMENTS
|
||||
ORDER BY chunk_id;
|
||||
```
|
||||
|
||||
실제 함수 내부의 조회 조건은 다음 의미를 가진다.
|
||||
실제 Data Grant predicate 내부의 조회 조건은 다음 의미를 가진다.
|
||||
|
||||
```sql
|
||||
WHERE EXISTS (허용된 TAG 중 하나가 청크 TAG와 일치)
|
||||
AND NOT EXISTS (거부된 TAG 중 하나가 청크 TAG와 일치)
|
||||
```
|
||||
|
||||
즉, 토큰은 사용자 식별 입력이고 권한 결정은 기존 `CB_*` 테이블이 담당한다. 토큰별로 DDS 계정을 바꾸거나 고객 사용자마다 DDS `END USER`를 만드는 단계는 없다.
|
||||
즉, 토큰은 Context 초기화 입력이고 권한 결정은 객체별 DDS Data Grant가 기존 `CB_*` 테이블을 조회해 담당한다. 토큰별로 DDS 계정을 바꾸거나 고객 사용자마다 DDS DB 계정을 만드는 단계는 없다. DDS End User Security Context를 드라이버가 직접 전달하는 순수 DDS 경로는 이 데모와 별도다.
|
||||
|
||||
### 검증 결과
|
||||
|
||||
@@ -70,16 +76,30 @@ WHERE EXISTS (허용된 TAG 중 하나가 청크 TAG와 일치)
|
||||
|
||||
토큰 행, 임시 함수, 임시 권한은 검증 직후 삭제했다. 이 결과는 “DDS 사용자 수 = 고객 사용자 수”가 아니라 “DDS 기술 사용자 1개 + 고객 권한 테이블” 모델이 동작함을 보여 준다.
|
||||
|
||||
## 두 가지 DDS 집행 경계
|
||||
## DDS 집행 경계
|
||||
|
||||
| 구분 | 현재 기본 데모 | 순수 DDS Context 확장 |
|
||||
| 구분 | 토큰 기반 기본 데모 | 순수 DDS Context 확장 |
|
||||
|---|---|---|
|
||||
| 토큰 전달 | 함수의 `token` 파라미터 | 지원 드라이버/ORDS가 `EndUserSecurityContext`로 전달 |
|
||||
| 권한 계산 | 함수가 공통 `CB_*` 테이블을 읽어 `WHERE` 생성 | `DATA GRANT` predicate가 DDS 런타임 컨텍스트를 참조 |
|
||||
| 사용자 객체 | DDS 기술 사용자 1개 | DDS END USER 또는 데이터 역할 매핑 필요 |
|
||||
| 현재 상태 | 검증 완료 | 드라이버·ORDS 전달 경로를 별도 검증해야 함 |
|
||||
| 토큰 전달 | 토큰 함수가 신뢰된 `CB_AGENT_CTX` 설정 | 지원 드라이버/ORDS가 `EndUserSecurityContext`로 전달 |
|
||||
| 권한 계산 | 객체별 `DATA GRANT` predicate가 공통 `CB_*` 테이블 조회 | `DATA GRANT` predicate가 DDS 런타임 컨텍스트 참조 |
|
||||
| 사용자 객체 | DDS 기술 사용자 1개 + DDS Data Role 1개 | DDS End User identity와 Data Role 매핑 |
|
||||
| 현재 상태 | 벡터 VIEW에서 검증 완료 | 드라이버·ORDS 전달 경로를 별도 검증해야 함 |
|
||||
|
||||
중요한 경계는 `DATA GRANT` 자체가 호출 시점의 임의 함수 인자를 받는 구조가 아니라는 점이다. 따라서 현재 시나리오에서는 토큰을 받는 함수/API가 조회 경계가 되고, DDS는 그 함수가 조회하는 보호 뷰와 기술 사용자 세션을 보호한다. 향후 순수 DDS Context를 사용하려면 토큰을 SQL 실행 전에 드라이버가 붙이고, 그때만 `ORA_END_USER_CONTEXT` 기반 `DATA GRANT`를 적용한다. ORDS Handler가 Bearer 값을 DDS 사용자명으로 바꾸는 것만으로는 DDS Context가 자동 생성되지 않는다.
|
||||
중요한 경계는 `DATA GRANT` 자체가 호출 시점의 임의 함수 인자를 받는 구조가 아니라는 점이다. 그렇다고 Data Grant를 생략하는 것은 아니다. `ON` 절로 보호 VIEW/TABLE을 지정하고, `WHERE` predicate가 Context와 공통 권한 테이블을 사용해 행을 결정한다. 토큰 함수는 그 predicate가 참조할 Context를 만든다. 향후 순수 DDS Context를 사용하려면 토큰을 SQL 실행 전에 드라이버가 붙이고, 그때 `ORA_END_USER_CONTEXT` 기반 Data Grant를 적용한다. ORDS Handler가 Bearer 값을 DDS 사용자명 문자열로 바꾸는 것만으로는 DDS Context가 자동 생성되지 않는다.
|
||||
|
||||
## 객체별 Grant와 공통 권한체계 매핑
|
||||
|
||||
보호 대상이 늘어나면 대상별로 Data Grant를 추가한다. 하나의 Data Grant는 하나의 `ON` 테이블·뷰·Materialized View를 대상으로 하며, 해당 객체의 `SELECT`/DML·컬럼 범위와 행 predicate를 선언한다.
|
||||
|
||||
| 공통 권한체계 | DDS 집행 위치 |
|
||||
|---|---|
|
||||
| `CB_PERMISSION.target_name` | 보호 객체와 논리 대상 매핑 |
|
||||
| `CB_PERMISSION.action_name` | Data Grant의 `SELECT`/`UPDATE` 등 |
|
||||
| `CB_PERMISSION_RULE` | Data Grant predicate의 `WHERE` 조건 |
|
||||
| 직접 역할·활성 그룹 역할 | predicate 함수의 effective role 집합 |
|
||||
| Bearer 키 | `CB_AGENT_CTX`의 업무 사용자 식별 |
|
||||
|
||||
같은 대상의 여러 Data Grant는 기본적으로 합집합으로 적용된다. 따라서 ALLOW TAG를 여러 개 허용하는 것은 OR로 표현할 수 있지만, DENY는 별도 Grant로 만들면 전체를 차단하지 못할 수 있다. 이 데모는 하나의 객체별 predicate 안에서 `(ALLOW A OR ALLOW B) AND NOT (DENY C)` 의미를 만든다.
|
||||
|
||||
## 실행 확인
|
||||
|
||||
|
||||
Reference in New Issue
Block a user