ZK 암호화는 계정 프로젝트의 커넥션 접속 정보를 소유자가 정한 비밀 키로 한 번 더 잠급니다. 활성화하면 비밀 키가 없는 사람은 NeoSQL 운영자를 포함해 누구도 접속 정보를 복호화할 수 없고, 비밀 키를 잃으면 아무도 되살릴 수 없습니다. 활성화하고, 해제하고, 변경하고, 비활성화하는 화면을 설명합니다. 무엇을 무엇으로부터 지키는지와 표준 암호화와의 차이는 보안과 데이터가 나가는 곳 에 있습니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
프로젝트 화면 왼쪽 탐색기 도구 모음의 오른쪽 끝에 있는 비밀 키 잠금 버튼을 클릭하면 창이 열립니다. 커넥션이 없는 프로젝트와 커넥션이 있는 프로젝트에서 창의 제목과 안내가 조금 다르고, 하는 일은 같습니다.
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 안내 | 무엇을 잠그는지 알려 줍니다. 커넥션이 있는 프로젝트에서는 활성화하기 전까지 저장된 접속 정보가 표준 암호화로만 보호되었으므로, 매우 민감한 자격증명이면 활성화한 뒤 DB 쪽에서 비밀번호를 변경하도록 권합니다. |
| 2 | 안전한 키 자동 생성 (권장) | 32자 무작위 문자열을 만들어 비밀 키로 사용합니다. 처음에는 선택되어 있습니다. |
| 3 | 직접 입력 | 기억하기 쉬운 문장을 직접 넣습니다. 선택하면 비밀 키 칸, 강도 표시, 힌트 칸이 나옵니다. 강도가 보통 단계 이상이어야 다음으로 넘어갑니다. |
| 4 | 다음 버튼 | 비밀 키를 보여 주는 두 번째 단계로 갑니다. 아직 아무것도 저장하지 않습니다. |
- 버튼은 계정 프로젝트에만 있습니다. 로컬 프로젝트에는 ZK 암호화가 없습니다. 로컬 프로젝트의 접속 정보는 기기의 OS 보안 저장소로 보호됩니다(보안과 데이터가 나가는 곳).
- 프로젝트 소유자만 활성화할 수 있습니다. 다른 팀원에게는 버튼이 비활성으로 보이고, 버튼 위에 마우스를 올리면 프로젝트 소유자만 설정할 수 있습니다 문구가 나옵니다.
활성화하기
- 계정 프로젝트를 소유자 계정으로 엽니다.
- 탐색기 도구 모음의 비밀 키 잠금 버튼을 클릭합니다.
- 비밀 키를 만드는 방법을 선택하고 다음 버튼을 클릭합니다. 직접 입력 항목을 선택하면 12자 이상을 권하고, 앞뒤의 공백은 경고합니다. 힌트는 선택이며, 비밀 키 자체를 적지 마세요.
- 두 번째 단계에서 보이는 비밀 키를 복사 버튼이나 .txt 다운로드 버튼으로 다운로드해 비밀번호 관리자나 사내 금고에 보관합니다. 창을 닫으면 비밀 키는 다시 볼 수 없습니다.
- 안전한 곳에 키를 보관했습니다 상자와 분실 시 복구가 불가능함을 이해했습니다 상자를 모두 선택해야 마지막 버튼이 클릭됩니다. 데스크톱 앱에서는 이 컴퓨터에 안전하게 저장 (다음 진입 시 자동 잠금해제) 상자가 처음부터 선택되어 있습니다. 기기에 저장하지 않으려면 비활성화하세요.
- 설정 완료 버튼을 클릭합니다. 기존 접속 정보가 새 키로 다시 암호화됩니다.
- 경고(1)는 ⚠️ 이 키는 다시 표시되지 않습니다 문구입니다. 비밀 키(2)는 두 번째 단계에서 한 번만 보입니다.
- .txt 다운로드 버튼(3)은 비밀 키와 경고 문구를 담은 텍스트 파일을 다운로드합니다. 다운로드한 파일도 비밀 키 자체이므로 안전한 곳에 두세요.
- 확인 상자(4) 두 개를 선택하기 전에는 설정 완료 버튼(5)이 눌리지 않습니다.
- 브라우저에서는 키체인 상자가 비활성이고 옆에 — Desktop 앱 전용 표시가 붙습니다.
비밀 키로 프로젝트 열기하기
활성화된 프로젝트에 들어가면 기기에서 잠금을 해제한 적이 없는 한 비밀 키 잠금해제 창이 먼저 표시됩니다. 소유자와 팀원 모두 같습니다.
- 비밀 키 칸(2)에 비밀 키를 넣습니다. 활성화할 때 힌트를 적었으면 위에 힌트(1)가 보입니다.
- 데스크톱 앱에서 다음부터 묻지 않게 하려면 이 컴퓨터에 안전하게 저장 상자(3)를 선택합니다.
- 잠금해제 버튼(4)을 클릭합니다.
- 비밀 키가 틀리면 패스프레이즈가 올바르지 않습니다 문구가 나옵니다. 세 번째로 틀린 뒤부터는 잠시 기다려야 다시 넣을 수 있고, 기다리는 시간은 틀릴 때마다 5초씩 늘어 최대 60초입니다.
- 취소 버튼을 클릭하면 프로젝트를 열지 않고 대시보드로 돌아갑니다. 창 밖을 클릭하거나
Esc키로는 닫히지 않습니다. - 해제된 상태는 앱이 실행되어 있는 동안만 유지됩니다. 앱을 다시 실행하거나, 웹에서 페이지를 새로고침하거나, 로그인, 로그아웃하면 다시 잠깁니다. 키체인에 저장한 데스크톱 앱은 들어갈 때 자동으로 해제됩니다.
- 키체인에 저장한 비밀 키가 변경된 뒤라 맞지 않으면 NeoSQL 이 키를 삭제하고 저장된 비밀 키로 잠금해제할 수 없습니다 알림을 띄웁니다. 새 비밀 키를 넣으세요.
활성화한 뒤의 메뉴
활성화하고 잠금을 해제하면 도구 모음의 버튼이 잠금 버튼으로 변경됩니다. 소유자에게는 메뉴가 붙고, 다른 팀원은 클릭하면 바로 잠급니다.
| 번호 | 메뉴 | 하는 일 |
|---|---|---|
| 1 | 지금 세션 잠그기 | 기기의 메모리에서 해제된 키를 삭제하고 비밀 키 잠금해제 창을 띄웁니다. 비밀 키를 키체인에 저장한 데스크톱 앱에서는 곧바로 다시 해제되므로 비활성입니다. |
| 2 | 이 컴퓨터에 안전하게 저장 | 데스크톱 앱에만 있습니다. 잠그고 비밀 키 잠금해제 창을 띄웁니다. 창의 이 컴퓨터에 안전하게 저장 상자는 선택된 채 열리므로 비밀 키를 넣고 해제하면 저장됩니다. 저장한 뒤에는 같은 자리에 이 컴퓨터에서 저장된 비밀 키 제거 항목이 나옵니다. |
| 3 | 비밀 키 변경... | 활성화할 때와 같은 창으로 새 비밀 키를 정합니다. 마지막 버튼은 변경 완료 버튼입니다. 접속 정보는 그대로이고, 팀원이 키체인에 저장해 둔 옛 키로는 더 이상 해제할 수 없습니다. |
| 4 | 비밀 키 잠금 해제(영구)... | 비밀 키 잠금 해제 확인 창에서 해제 버튼을 클릭하면 표준 암호화로 돌아갑니다. 돌아간 뒤로는 운영자가 서버 코드와 키 관리 권한으로 접속 정보를 복호화할 수 있게 됩니다. |
비밀 키 변경... 메뉴와 비밀 키 잠금 해제(영구)... 메뉴는 잠금을 해제한 상태에서만 사용할 수 있습니다. 비밀 키를 모르면 비활성화할 수도 없습니다. 메뉴 맨 아래의 도움말 항목은 아래 '도움말 화면' 을 엽니다.
활성화한 뒤 달라지는 것
| 무엇 | 달라지는 것 |
|---|---|
| 팀원 | 프로젝트에 들어갈 때마다(기기마다) 비밀 키를 넣어야 합니다. NeoSQL 은 비밀 키를 팀원에게 전하지 않으므로 소유자가 안전한 경로로 따로 알립니다 |
| 다른 기기 | 같은 계정이라도 기기마다 처음 한 번은 비밀 키를 넣습니다. 브라우저는 키체인에 저장할 수 없어 새로 열 때마다 넣습니다 |
| 외부 MCP | 잠긴 프로젝트를 대상으로 한 도구 호출은 실행하지 않고, 데스크톱 앱에서 잠금을 해제하라는 안내를 돌려줍니다 |
자동 잠금 시간 정하기
화면의 비밀 키 자동 잠금 칸에서 잠금을 해제한 프로젝트를 다시 잠그는 시간을 선택하고 저장 버튼을 클릭합니다.- 선택할 수 있는 값은 끄지 않음 (편의 우선), 1분, 5분, 30분, 8시간 항목입니다(1). 처음에는 끄지 않음 (편의 우선) 항목입니다.
- 자동 잠금 시간은 계정에 저장되고, ZK 암호화를 활성화한 모든 프로젝트에 적용됩니다. 시간이 되어 잠기면 비밀 키 잠금해제 창이 표시됩니다.
- 시간은 보고 있는 프로젝트에서 마지막으로 클릭하거나 키를 누른 때부터 계산합니다. 저장한 값은 이 기기에 바로 적용되고, 다른 기기에는 앱을 다시 시작하거나 다시 로그인할 때 적용됩니다.
도움말 화면
앱에는 비밀 키를 잃었을 때의 대안, 비밀 키를 보관하는 방법, 다른 기기에서 사용하는 방법을 정리한
화면이 있습니다. 내용은 같습니다. 소유자의 비밀 키 잠금 메뉴나, 활성화할 때 여는 창의 첫 단계 위쪽에 있는 도움말 링크로 엽니다.주의할 점
- 비밀 키를 잃으면 접속 정보를 되살릴 방법이 없습니다. NeoSQL 은 비밀 키의 백업을 갖고 있지 않습니다. DB 와 DB 안의 데이터는 영향을 받지 않으므로, 접속 정보를 DB 관리자에게 다시 받아 새 커넥션으로 등록하세요.
- 힌트는 비밀 키 잠금해제 창에서 프로젝트에 들어오는 모든 팀원에게 보입니다. 비밀 키를 짐작할 수 있는 말을 적지 마세요.
- ZK 암호화는 잠긴 동안의 접속 정보를 지킵니다. 잠금을 해제하고 작업하는 동안에는 요청을 처리하는 순간 서버가 접속 정보를 복호화합니다. 활성화하기 전에 저장한 접속 정보는 그때까지 표준 암호화로만 보호되었습니다.
- 공용 기기에서는 자동 잠금에 의존하지 말고, 다 사용하면 지금 세션 잠그기 메뉴로 잠그거나 로그아웃하세요.
- DB 안의 데이터는 암호화하지 않습니다. 팀원에게 값을 마스킹하려면 컬럼 마스킹 을 사용하세요.
관련 화면
- 보안과 데이터가 나가는 곳: 표준 암호화, ZK 암호화, OS 보안 저장소, 마스킹이 지키는 것과 경계입니다.
- 컬럼 마스킹: 팀원에게 민감한 컬럼의 값을 마스킹해 보이게 합니다.
- 마이페이지: 화면을 안내하는 페이지입니다.
- MCP 클라이언트 설정: 잠긴 프로젝트는 MCP 도구 호출 전에 데스크톱 앱에서 해제해야 합니다.