HMM MCP·VPD 운영 가이드

1. 적용 범위

이 문서는 HMM 백오피스와 AI Web Agent Console의 운영 특성만 다룬다. 공통 MCP, VPD, Data Redaction, DDS 설치·검증 원칙은 main의 공통 운영 문서를 따른다.

2. HMM 실행 흐름

업무 사용자 로그인
 → HttpOnly 인증 cookie 또는 Bearer 검증
 → MCP 요청의 업무 사용자 결정
 → 팀·담당 선사 권한을 DB context에 설정
 → 보호된 HMM View 조회 또는 Select AI 도구 호출
 → VPD 행 제한 · Redaction 적용 · FGA 증적 기록
 → 선사 KPI·배정·휴가/조직 정보 반환

서비스 계정 또는 OCI client-credentials token은 서비스 연결 승인용이다. 업무 사용자 권한은 로그인 사용자와 CB_* 권한 매핑, 팀·담당 선사 데이터로 결정한다.

3. 운영 데이터와 권한 기준

영역	권한 기준	확인 대상
선사 KPI	사용자의 팀·담당 선사	VPD predicate, 선사 배정
조직/휴가	사용자·팀 소속	leave/team VPD policy
MCP 도구	광고된 도구와 사용자 인증	`BACKOFFICE_MCP_TOOLS`, `tools/list`
민감 정보	Redaction 정책과 예외 권한	대상 컬럼, policy, 조회 결과

4. 일상 점검 순서

로그인 사용자와 MCP Bearer가 같은 업무 주체로 해석되는지 확인한다.
tools/list의 공개 도구와 실제 호출 가능 도구가 일치하는지 확인한다.
서로 다른 팀 또는 담당 선사 사용자가 같은 질문에서 다른 행 집합을 받는지 확인한다.
민감 컬럼의 마스킹 결과와 FGA의 CLIENT_IDENTIFIER, RLS_INFO를 확인한다.
권한 변경 뒤 다음 요청에 즉시 반영되는지 확인한다.

5. 장애 대응

증상	확인 순서
로그인했는데 MCP 401/403	cookie/Bearer, 사용자 매핑, 토큰 만료·회수
선사 데이터가 0건	팀·담당 선사 배정, session context, VPD predicate
다른 팀 데이터 노출	보호 View, VPD policy 적용 객체, 권한 매핑
MCP 도구 호출 실패	환경변수 도구 목록, 입력 스키마, endpoint 상태
감사 행 없음	요청 식별자, FGA policy, Unified Audit Trail

2.5 KiB Raw Blame History