데이터 접근 정책

데이터 접근 화면은 연결한 데이터베이스에 대한 쿼리를 쿼리 단위로 통제합니다. DB 연결의 권한이 "누가 어느 테이블을 쓸 수 있나"를 정한다면, 여기서는 "어떤 쿼리를 그대로 실행할지, 막을지, 사람이 먼저 볼지"와 "결과에서 무엇을 가릴지"를 정합니다.

DB 연결 화면 위쪽의 데이터 접근 정책, PII 마스킹 규칙, 쿼리 감사 로그 탭으로 엽니다. 관리 → 감사의 쿼리 감사 로그 링크로도 열 수 있습니다. 소유자와 관리자만 씁니다.

정책 규칙

규칙마다 효과를 하나 정합니다.

• 허용 — 그대로 실행합니다.
• 거부 — 실행하지 않습니다.
• 승인 필요 — 실행하기 전에 소유자·관리자의 결정을 받습니다. 요청은 승인에 올라갑니다.

새 규칙에서 이름, 효과, 우선순위 (낮을수록 먼저 평가), 역할 매칭, 테이블 허용 목록 (쉼표 구분)·테이블 거부 목록 (쉼표 구분) 항목을 정하고 활성화한 뒤 저장합니다. 새 규칙은 모든 데이터베이스에 시간 제한 없이 적용됩니다.

규칙은 우선순위가 낮은 숫자부터 차례로 평가되고, 처음 맞는 규칙이 적용됩니다. 어떤 규칙에도 맞지 않는 쿼리는 거부됩니다. 처음에는 기본 규칙 두 개가 들어 있습니다 — 소유자·관리자의 조회 허용, 그리고 에이전트의 조회 허용.

서로 부딪칠 수 있는 규칙이 있으면 "잠재적 규칙 충돌 N건이 감지되었습니다."로 알려 주고, 어느 규칙이 먼저 평가되는지 보여 줍니다.

정책 테스터

정책 테스터 (Dry Run) 화면에 SQL 쿼리, 데이터베이스 ID, 테스트 역할을 넣고 테스트 실행을 누르면, 실제로 실행하지 않고 어느 규칙이 적용되는지, 쿼리에서 어떤 테이블을 읽는지, 거부된 테이블이 무엇인지 알려 줍니다. 규칙을 바꾼 뒤에는 꼭 시험해 보세요.

PII 마스킹 규칙

개인정보가 담긴 컬럼은 결과에서 가려서 돌려줍니다. 빠른 추가: 옆의 버튼으로 이메일·전화번호·주민번호·주소·카드번호 같은 흔한 패턴을 바로 넣거나, 새 규칙에서 컬럼 패턴과 테이블 패턴(* 와일드카드 가능)을 직접 정합니다.

마스킹 전략은 다섯 가지입니다.

• 완전 마스킹 — 값 전체를 ****처럼 가립니다.
• 부분 마스킹 — 앞뒤 몇 글자만 남깁니다(예: al*****.com).
• 해시 — 같은 값은 같은 해시로 바꿔, 가린 채로도 같은 값끼리 묶을 수 있습니다.
• NULL 처리 — 값을 비웁니다.
• 잘라내기 — 정한 길이까지만 보여 줍니다(예: hel...).

마스킹 미리보기에 샘플 JSON을 넣고 미리보기를 누르면 원본과 마스킹 후를 나란히 비교할 수 있습니다.

가린 컬럼은 별칭이나 계산식으로 바꿔 꺼내려 해도 막힙니다.

기록 확인

정책을 거친 쿼리의 허용·거부·승인 대기·오류와 가린 컬럼은 쿼리 감사 로그에 남습니다. DB 연결 권한에서 막힌 요청은 관리 → 감사에 기록됩니다. 자세한 사용법은 감사 → 쿼리 감사 로그를 보세요.