컬럼 마스킹은 계정 프로젝트에서 정한 역할의 팀원에게 민감한 값을 마스킹해 보여 줍니다. 마스킹을 적용할 역할은 프로젝트 설정 창에서 정합니다. 마스킹할 값은 다음 두 가지 방법으로 지정합니다.
- 민감 컬럼으로 지정하면 컬럼의 값 전체를 마스킹합니다.
- 정규식 패턴을 등록하면 패턴에 맞는 글자만 마스킹합니다.
마스킹은 화면에 보이는 값을 통제할 뿐 데이터를 암호화하지 않습니다. 마스킹의 경계는 보안과 데이터가 나가는 곳 에서 설명합니다.
화면 구성
탭에서 역할마다 정합니다. 탭은 계정 프로젝트의 소유자와 모든 권한 항목을 활성화한 역할에게만 보이고, 값을 변경하는 것은 소유자만 합니다.| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 역할 탭 | 관리자, DBA, 멤버 역할을 하나씩 엽니다. 소유자는 목록에 없고 늘 원래 값을 봅니다. |
| 2 | 민감정보 마스킹 처리 상자 | 선택하면 역할의 팀원에게 민감 컬럼과 패턴에 맞는 값이 마스킹되어 보입니다. 모든 권한 항목을 활성화한 역할은 선택할 수 없습니다. |
| 3 | 컬럼별 마스킹 | 지정한 민감 컬럼이 있으면 불이 활성화되고 개수가 나옵니다. 개수를 클릭하면 커넥션과 컬럼 목록이 보입니다. |
| 4 | 패턴별 마스킹 | 활성화해 둔 패턴이 있으면 불이 활성화되고 개수와 패턴 이름이 나옵니다. |
| 5 | 패턴 관리… 버튼 | 패턴을 등록하고 수정하는 창을 엽니다(아래 '패턴 등록하기'). |
| 6 | 경고 | 마스킹의 한계를 알리는 문구입니다. 아래 상자와 같습니다. |
- 역할마다 따로 활성화하지만 위에서 아래로 이어집니다. 관리자 역할의 마스킹을 활성화하면 DBA 역할과 멤버 역할에도 마스킹이 적용됩니다. DBA 역할의 마스킹을 활성화하면 멤버 역할에도 마스킹이 적용됩니다. 위 역할 때문에 활성화된 상자는 변경할 수 없고 옆에 (상위 역할이 마스킹되어 자동 적용됨) 표시가 붙습니다.
- 마스킹이 적용된 역할에는 민감 컬럼과 패턴이 모두 걸립니다.
마스킹을 적용할 역할 정하기
- 계정 프로젝트를 소유자 계정으로 열고 탭을 엽니다.
- 마스킹을 적용할 역할의 탭을 열고 민감정보 마스킹 처리 상자를 선택합니다.
- 프로젝트 설정 창을 저장합니다. 선택한 역할의 팀원이 열어 둔 SQL 탭에는 다음 실행부터 적용됩니다.
민감 컬럼 지정하기
마스킹이 적용된 역할이 하나라도 있어야 컬럼을 지정할 수 있습니다. 컬럼을 우클릭해 민감정보로 지정 메뉴를 선택합니다.
다음 가운데 한 곳에서 컬럼을 우클릭합니다.
어디서 지정할 수 있는 컬럼 ERD 의 테이블 노드 DB 에 있는 테이블의 문자 타입 컬럼. 기본 키, 외래 키는 제외합니다 테이블 탭의 컬럼 표 위와 같습니다 뷰 탭의 컬럼 표 뷰의 모든 컬럼. 타입과 키를 따지지 않습니다 민감정보로 지정 메뉴(1)를 선택합니다. 지정은 바로 서버에 저장되고, 저장 버튼을 클릭할 필요가 없습니다.
지정한 컬럼은 테이블 탭과 뷰 탭의 컬럼 이름 앞에 주황색 자물쇠 아이콘이 붙습니다.
- 예: 데모 상점에서는
customer테이블의email,name컬럼과address테이블의line1컬럼이 지정할 만한 컬럼입니다.customer_id는 기본 키이고address.customer_id는 외래 키라서 메뉴가 나오지 않습니다. - 지정은 소유자와 마스킹하지 않는 역할의 팀원이 할 수 있습니다. 해제(민감정보 지정 해제 메뉴)는 소유자만 할 수 있습니다. 해제하면 값이 마스킹이 적용된 역할에게 다시 보이기 때문입니다.
- ERD 에서 새로 만들어 아직 DB 에 반영하지 않은 테이블과 컬럼은 지정할 수 없습니다.
- 지정한 컬럼이 나중에 기본 키나 외래 키가 되면, 소유자가 컬럼이 속한 테이블을 열 때 지정이 자동으로 해제됩니다. 마스킹한 키로는 행을 수정하거나 참조할 수 없기 때문입니다.
패턴 등록하기
패턴은 프로젝트 전체에 하나의 목록으로 걸립니다. 결과의 문자열 값에서 정규식에 맞는 부분만 마스킹하므로, 메모나 설명처럼 문장 속에 섞인 전화번호나 이메일을 마스킹할 때 사용합니다.
- 탭에서 마스킹이 적용된 역할을 열고 패턴 관리… 버튼을 클릭합니다. 마스킹 패턴 관리 창이 열립니다. 목록의 스위치로 패턴을 활성화하고 비활성화합니다.
+ 패턴 등록 버튼을 클릭합니다.
빠른 시작: 줄의 버튼(한국어 화면은 휴대전화번호, 주민등록번호, 이메일, 신용카드번호)을 클릭하면 이름, 정규식, 예시 문구가 기입됩니다. 직접 입력할 때는 패턴 이름 칸과 정규식 칸을 채웁니다.
마스킹 방식 항목을 선택합니다.
방식 마스킹하는 모양 부분 맞는 부분의 앞뒤 몇 글자를 남기고 나머지를 마스킹 문자 칸의 글자로 변경합니다. 구분자(- 공백) 유지 상자를 선택하면 -와 공백은 남깁니다전체 맞는 부분 전체를 마스킹합니다 템플릿 치환 템플릿 칸의 글로 변경합니다. $1,$2로 정규식의 묶음을 넣습니다미리보기 칸에 예시 문구를 넣어 결과를 확인하고 확인 버튼을 클릭합니다.
- 빠른 시작: 줄의 버튼(1)으로 기입한 값도 수정할 수 있습니다. 정규식(2)이 잘못되면 미리보기(4)에 정규식을 수정하면 미리보기가 표시됩니다. 문구가 나옵니다.
- 방식(3)에 따라 아래 옵션 칸이 변경됩니다.
- 패턴은 소유자와 모든 권한 항목을 활성화한 역할만 등록하고 수정할 수 있습니다. 패턴의 저장은 프로젝트 설정 창의 저장과 따로, 패턴 등록 창에서 바로 이루어집니다.
마스킹이 걸리는 곳
값은 쿼리를 실행하는 서버가 결과를 화면으로 보내기 전에 마스킹합니다. 데스크톱은 팀원의 기기에 있는 로컬 서버에서, 웹은 NeoSQL 서버에서 마스킹합니다. 아래는 마스킹이 적용된 역할의 팀원에게 일어나는 일입니다.
| 경로 | 마스킹 |
|---|---|
| SQL 편집기의 결과 그리드 | 민감 컬럼은 ****, 패턴에 맞는 부분은 정한 모양으로 보입니다. 복사해도 마스킹한 그대로이고, 마스킹한 셀은 편집할 수 없습니다(결과 그리드) |
| 결과 내보내기, 탐색기의 데이터 내보내기... 메뉴 | 마스킹한 값으로 파일에 저장됩니다(결과 내보내기) |
| Native Backup | 덤프 도구는 값을 마스킹할 수 없으므로 메뉴가 보이지 않고, 요청해도 서버(데스크톱은 로컬 서버, 웹은 NeoSQL 서버)가 거절합니다(데이터 내보내기, 가져오기와 Native Backup) |
| AI Assistant 가 조회하는 행 | 역할에 따라 마스킹합니다. 커넥션의 민감정보 항상 마스킹 항목을 활성화하면 역할과 상관없이 마스킹합니다 |
외부 MCP 의 execute-query 결과 | AI Assistant 와 같습니다. 실행할 때마다 서버에서 정책을 다시 읽고, 읽지 못하면 실행하지 않습니다 |
| RLS 시뮬레이터 | 마스킹하지 않습니다. 아래 '주의할 점' 을 보세요 |
주의할 점
- 마스킹은 DB 의 권한이 아닙니다. 뷰나 함수로 같은 값을 다시 꺼내는 조회, 값을 조건으로 거르는 조회(
WHERE email LIKE 'a%')처럼 우회하는 조회로 값이 드러날 수 있습니다. 반드시 숨겨야 하는 값은 DB 쪽에서 컬럼을 암호화하거나 DB 계정의 권한을 나누세요. - PostgreSQL 커넥션에서 여는 RLS 시뮬레이터는 결과를 마스킹하지 않습니다. 마스킹이 적용된 역할의 팀원도 시뮬레이터로 민감 컬럼의 원래 값을 볼 수 있습니다(RLS 권한 매트릭스와 시뮬레이터).
- 데스크톱 앱에서는 마스킹과 DB 접속이 모두 팀원의 기기에서 이뤄집니다. 기기를 마음대로 다룰 수 있는 사람에게서 값을 지키는 장치로 사용하지 마세요.
- 역할이나 민감 컬럼을 변경하면 팀원의 열린 SQL 탭에는 다음 실행부터 적용됩니다. 변경 알림을 받지 못한 탭은 프로젝트를 다시 열 때까지 예전 정책으로 실행될 수 있습니다.
- 경고 아래의 구조 정보를 읽지 못하면 일부 값이 더 가려지거나 편집이 제한될 수 있습니다. 문구처럼, 쿼리가 어느 테이블의 어느 컬럼을 읽는지 알아내지 못하면 안전한 쪽으로 더 마스킹하거나 편집을 차단합니다.
관련 화면
- 보안과 데이터가 나가는 곳: 마스킹과 암호화가 지키는 것의 차이입니다.
- 공유와 멤버: 팀원을 초대하고 역할을 주는 화면입니다.
- 결과 그리드: 마스킹한 값이 보이는 모양입니다.
- 프로젝트 AI 설정: AI, MCP 로 보내는 값을 늘 마스킹하는 설정입니다.
- ZK 암호화: 접속 정보를 비밀 키로 잠급니다.