NeoSQL 의 보안 기능은 지키는 대상과 차단하는 상대가 저마다 다릅니다. 이름만 보고 선택하면 "암호화했으니 팀원도 데이터를 못 본다" 같은 오해가 생깁니다. 아래에서는 기능마다 무엇을 무엇으로부터 지키는지와 경계를 정리하고, 마지막으로 로그인하지 않고 사용해도 기기 외부로 나가는 통신을 적습니다.
한눈에 보기
| 기능 | 지키는 것 | 차단하는 상대 | 사용하는 곳 | 차단하지 못하는 것 |
|---|---|---|---|---|
| 표준 암호화 | 커넥션의 접속 정보 | NeoSQL 서버의 데이터베이스가 유출되는 경우 | 계정 프로젝트. 늘 적용됩니다 | 서버 코드와 키 관리(AWS KMS) 권한을 함께 가진 운영자 |
| ZK 암호화(비밀 키 잠금) | 커넥션의 접속 정보 | 비밀 키가 없는 모든 사람. NeoSQL 운영자도 포함합니다 | 계정 프로젝트. 소유자가 활성화합니다 | 비밀 키를 잃으면 아무도 되살릴 수 없습니다 |
| OS 보안 저장소 | 커넥션의 비밀 값, 기기에 저장한 AI 키 | 기기의 설정 파일을 그대로 열어 읽는 경우 | 로컬 프로젝트(데스크톱) | OS 보안 저장소를 사용할 수 없는 환경에서는 평문으로 저장됩니다 |
| 민감정보 마스킹 | 민감 컬럼의 값이 화면에 보이는 것 | 마스킹 대상 역할의 팀원 | 계정 프로젝트. 역할마다 활성화합니다 | 저장된 데이터를 암호화하지 않습니다. 뷰나 함수를 통한 우회 조회를 차단하지 못합니다. |
여기서 접속 정보는 호스트, 포트, JDBC URL, 데이터베이스 이름, DB 사용자와 비밀번호, SSL 인증서, 키, 키 비밀번호, SSH 와 프록시의 계정입니다. 커넥션 이름, DBMS 종류, 스키마 목록은 암호화하지 않습니다. 어느 기능도 DB 안의 데이터 자체를 암호화하지는 않습니다.
계정 프로젝트의 표준 암호화
- 계정 프로젝트의 커넥션을 저장하면 접속 정보는 NeoSQL 서버에 암호화되어 저장됩니다. 프로젝트마다 데이터 키를 하나 만들어 접속 정보를 AES-256-GCM 으로 암호화하고, 데이터 키는 AWS KMS 의 마스터 키로 한 번 더 감쌉니다(봉투 암호화). 서버의 데이터베이스가 통째로 유출돼도 KMS 키 없이는 복호화할 수 없습니다.
- 따로 활성화할 것이 없습니다. 데이터 키는 프로젝트에서 커넥션을 처음 저장할 때 만들어집니다.
- 커넥션을 사용할 때는 쿼리를 실행하는 서버가 NeoSQL 서버에서 해제된 접속 정보를 받아 DB 에 접속합니다. 데스크톱에서는 기기의 로컬 서버가, 웹에서는 NeoSQL 서버가 쿼리를 실행합니다.
- 경계: DB 에 접속하려면 누군가는 접속 정보를 해제해야 하므로, 서버 코드와 KMS 권한을 함께 가진 운영자는 이론상 복호화할 수 있습니다. 그것까지 차단하려면 ZK 암호화를 활성화합니다.
ZK 암호화
- 계정 프로젝트의 소유자가 프로젝트 화면 왼쪽 탐색기 도구 모음의 비밀 키 잠금 버튼으로 활성화합니다. 소유자가 아니면 버튼이 비활성이고, 로컬 프로젝트에는 버튼이 없습니다.
- 활성화하면 데이터 키를 KMS 대신, 사용자만 아는 비밀 키에서 만든 키(Argon2id)로 감쌉니다. 비밀 키는 NeoSQL 서버로 보내지 않고 서버에 저장하지 않습니다.
- 프로젝트에 들어갈 때 비밀 키를 넣어 잠금을 해제합니다. 해제된 데이터 키는 기기(브라우저 탭이나 데스크톱 앱)의 메모리에만 있고, 요청마다 서버로 전달되어 요청을 처리하는 동안만 사용됩니다. 서버는 데이터 키를 보관하지 않습니다.
- 그래서 기기마다 따로 잠금을 해제합니다. 데스크톱은 이 컴퓨터에 안전하게 저장 항목으로 비밀 키를 OS 키체인에 저장해 다음부터 자동으로 해제할 수 있고, 브라우저에서는 할 수 없습니다. 사용하지 않을 때 저절로 잠그는 시간은 화면에서 정합니다.
- 경계: 보장은 잠긴 동안에 대한 것입니다. 잠금을 해제하고 작업하는 동안에는 요청을 처리하는 순간 서버가 접속 정보를 복호화합니다. 또 활성화하기 전에 저장한 접속 정보는 그때까지 표준 암호화로만 보호되었으므로, 앱은 매우 민감한 자격증명이라면 활성화한 뒤 DB 쪽에서 비밀번호를 변경하도록 권합니다.
- 팀원에게는 NeoSQL 이 비밀 키를 전달하지 않으므로 따로 알려 줍니다. 비밀 키를 변경하면 팀원이 키체인에 저장해 둔 옛 키로는 해제할 수 없게 되므로 새 키를 다시 알려 줍니다.
로컬 프로젝트의 OS 보안 저장소
- 로컬 프로젝트는 데스크톱 전용이고 기기에만 저장됩니다. 커넥션의 접속 정보도 NeoSQL 서버로 보내지 않으므로 표준 암호화와 ZK 암호화가 없습니다.
- 비밀인 값(DB 사용자와 비밀번호, JDBC URL, SSL 인증서와 키, SSH, 프록시의 계정)은 프로젝트 데이터와 떼어, OS 의 보안 저장소(macOS 키체인, Windows DPAPI 등)가 관리하는 키로 암호화해 둡니다. 프로젝트 데이터에는 비밀인 값이 저장된 자리를 가리키는 표시만 남습니다. 호스트와 포트처럼 비밀이 아닌 설정은 프로젝트 데이터에 보존됩니다.
- OS 보안 저장소를 사용할 수 없는 환경에서는 비밀인 값이 기기에 평문으로 저장됩니다. 비밀번호 같은 비밀 값을 넣고 커넥션을 저장하려 하면 자격증명이 암호화되지 않습니다 확인 창이 먼저 표시됩니다.
- 기기에 저장한 AI 키도 같은 저장소에 같은 방식으로 저장됩니다.
마스킹은 암호화가 아닙니다
- 계정 프로젝트에서 탭의 역할마다 민감정보 마스킹 처리 항목을 활성화하면, 역할의 팀원에게 민감정보로 지정한 컬럼의 값이 마스킹되어 보입니다. 소유자와 전체 권한 역할은 늘 원래 값을 봅니다.
- 값은 쿼리를 실행하는 서버가 결과를 화면으로 보내기 전에 마스킹합니다. 데스크톱은 팀원의 기기에서, 웹은 NeoSQL 서버에서 마스킹합니다.
- 마스킹은 화면에 보이는 값을 통제할 뿐이고, 앱은 마스킹 설정 아래에 다음 경고를 보여 줍니다.
- AI Assistant 와 외부 MCP 로 보내는 값은 커넥션의 AI 설정에서 민감정보 항상 마스킹 항목을 활성화하면 역할과 상관없이 마스킹합니다. 자세한 것은 AI 와 MCP 에서 설명합니다.
AI 키가 저장되는 곳
| 키 | 저장되는 곳 | 보호 | 사용할 수 있는 곳 |
|---|---|---|---|
| 계정 키 | NeoSQL 서버(내 계정) | 표준 암호화와 같은 KMS 봉투 암호화. ZK 암호화의 대상이 아닙니다 | 웹, 로그인한 데스크톱 |
| 기기 키 | 기기 | OS 보안 저장소. 화면 쪽 코드는 키 값을 읽지 못하고, AI 를 호출하는 로컬 서버만 꺼내 사용합니다 | 데스크톱. 로그인하지 않아도 됩니다 |
어느 키가 언제 사용되는지는 AI 와 MCP 에서 설명합니다.
로그인하지 않아도 기기 외부로 나가는 통신
로그인하지 않은 데스크톱은 NeoSQL 서버에 계정이 필요한 요청을 보내지 않습니다. 아래 요청만 보내고, 실패해도 작업을 차단하지 않습니다 (실패를 알리는 것은 직접 클릭하는 버그 신고뿐입니다). NeoSQL 서버로 가는 요청에는 기기의 식별자(기기 ID), 데스크톱인지 웹인지, 앱 버전이 함께 실립니다.
| 통신 | 언제 | 보내는 것 |
|---|---|---|
| 사용 통계 | 화면을 옮길 때 | 화면 이름과 주소(프로젝트 화면이면 프로젝트 ID 포함), 처음 들어온 경로 |
| 앱 버전 확인 | 운영 빌드의 데스크톱 앱을 실행할 때와 업데이트를 확인할 때 | 설치된 버전, 앱을 실행했다는 표시, 프로젝트 개수 |
| 릴리즈 노트 | 업데이트한 뒤 | 앱 버전과 화면 언어 |
| 공지 | 앱이 실행되어 있는 동안 | 공지 채널 연결과 공지 목록 요청. 모두에게 보내는 공지만 받습니다 |
| 공개 자산 | 공식 팩이나 공개된 템플릿 팩, 데이터 사전을 보거나 받을 때 | 보려는 자산 |
| AI 모델 목록 | AI 키를 등록하거나 수정할 때 | 선택한 AI 제공자 |
| 버그 신고 | 버그 신고 창에서 직접 보낼 때 | 적은 제목과 내용, 첨부한 화면 캡처, 보내기 전에 확인할 수 있는 오류 기록과 환경정보 |
- 사용 통계는 화면의 사용 통계 보내기 항목으로 비활성화합니다. 비활성화하면 화면 이동 기록을 보내지 않고, 다른 요청에는 기록하지 말라는 표시를 포함해 서버가 통계를 기록하지 않습니다. 기기 ID 는 기능에 사용되므로 계속 실립니다.
- 서버는 사용 통계와 함께 요청의 IP 주소와 앱 정보(User-Agent)를 기록합니다. 로그인한 상태에서는 사용 통계가 계정과 함께 기록됩니다.
- NeoSQL 서버 외부로 나가는 통신도 있습니다. 데스크톱은 커넥션에 적은 DB 에 기기에서 바로 접속하고, 업데이트 파일은 GitHub 에서 다운로드합니다. AI 를 사용하면 질문과 선택한 DB 정보가 선택한 AI 제공자로 갑니다(AI 와 MCP).
- 웹 앱은 늘 로그인한 상태이고, DB 접속과 AI 요청도 NeoSQL 서버가 합니다. 차이는 웹과 데스크톱 에서 설명합니다.
주의할 점
- 암호화는 NeoSQL 이 저장한 접속 정보를 지키는 것이고, DB 안의 데이터를 지키는 것이 아닙니다. 팀원에게 보여서는 안 되는 값을 원천 차단하려면 DB 쪽에서 컬럼을 암호화하거나 DB 계정의 권한을 나누세요.
- ZK 암호화의 비밀 키는 NeoSQL 이 보관하지 않습니다. 활성화하기 전에 비밀 키를 안전한 곳에 보관할 방법을 정해 두세요.
- OS 보안 저장소를 사용할 수 없다는 확인 창이 표시되는 기기에서는 비밀 값이 평문으로 남습니다. 공용 기기라면 로컬 프로젝트에 비밀번호를 저장하지 마세요.
관련 페이지
- ZK 암호화: 비밀 키 잠금을 활성화하고, 해제하고, 변경하는 화면입니다.
- 컬럼 마스킹: 역할과 민감 컬럼, 패턴으로 마스킹을 정하는 방법입니다.
- 로그인과 프로젝트 종류: 로컬 프로젝트와 계정 프로젝트의 차이입니다.
- 웹과 데스크톱: 웹 앱과 데스크톱 앱에서 DB 에 접속하는 곳의 차이입니다.
- AI 와 MCP: AI 에게 넘어가는 데이터와 커넥션 정책입니다.