화면: AI, MCP 와 보안

ZK 암호화

ZK 암호화는 계정 프로젝트의 커넥션 접속 정보를 소유자가 정한 비밀 키로 한 번 더 잠급니다. 활성화하면 비밀 키가 없는 사람은 NeoSQL 운영자를 포함해 누구도 접속 정보를 복호화할 수 없고, 비밀 키를 잃으면 아무도 되살릴 수 없습니다. 활성화하고, 해제하고, 변경하고, 비활성화하는 화면을 설명합니다. 무엇을 무엇으로부터 지키는지와 표준 암호화와의 차이는 보안과 데이터가 나가는 곳 에 있습니다.

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트

화면 구성

프로젝트 화면 왼쪽 탐색기 도구 모음의 오른쪽 끝에 있는 비밀 키 잠금 버튼을 클릭하면 창이 열립니다. 커넥션이 없는 프로젝트와 커넥션이 있는 프로젝트에서 창의 제목과 안내가 조금 다르고, 하는 일은 같습니다.

번호이름설명
1안내무엇을 잠그는지 알려 줍니다. 커넥션이 있는 프로젝트에서는 활성화하기 전까지 저장된 접속 정보가 표준 암호화로만 보호되었으므로, 매우 민감한 자격증명이면 활성화한 뒤 DB 쪽에서 비밀번호를 변경하도록 권합니다.
2안전한 키 자동 생성 (권장)32자 무작위 문자열을 만들어 비밀 키로 사용합니다. 처음에는 선택되어 있습니다.
3직접 입력기억하기 쉬운 문장을 직접 넣습니다. 선택하면 비밀 키 칸, 강도 표시, 힌트 칸이 나옵니다. 강도가 보통 단계 이상이어야 다음으로 넘어갑니다.
4다음 버튼비밀 키를 보여 주는 두 번째 단계로 갑니다. 아직 아무것도 저장하지 않습니다.
  • 버튼은 계정 프로젝트에만 있습니다. 로컬 프로젝트에는 ZK 암호화가 없습니다. 로컬 프로젝트의 접속 정보는 기기의 OS 보안 저장소로 보호됩니다(보안과 데이터가 나가는 곳).
  • 프로젝트 소유자만 활성화할 수 있습니다. 다른 팀원에게는 버튼이 비활성으로 보이고, 버튼 위에 마우스를 올리면 프로젝트 소유자만 설정할 수 있습니다 문구가 나옵니다.

활성화하기

  1. 계정 프로젝트를 소유자 계정으로 엽니다.
  2. 탐색기 도구 모음의 비밀 키 잠금 버튼을 클릭합니다.
  3. 비밀 키를 만드는 방법을 선택하고 다음 버튼을 클릭합니다. 직접 입력 항목을 선택하면 12자 이상을 권하고, 앞뒤의 공백은 경고합니다. 힌트는 선택이며, 비밀 키 자체를 적지 마세요.
  4. 두 번째 단계에서 보이는 비밀 키를 복사 버튼이나 .txt 다운로드 버튼으로 다운로드해 비밀번호 관리자나 사내 금고에 보관합니다. 창을 닫으면 비밀 키는 다시 볼 수 없습니다.
  5. 안전한 곳에 키를 보관했습니다 상자와 분실 시 복구가 불가능함을 이해했습니다 상자를 모두 선택해야 마지막 버튼이 클릭됩니다. 데스크톱 앱에서는 이 컴퓨터에 안전하게 저장 (다음 진입 시 자동 잠금해제) 상자가 처음부터 선택되어 있습니다. 기기에 저장하지 않으려면 비활성화하세요.
  6. 설정 완료 버튼을 클릭합니다. 기존 접속 정보가 새 키로 다시 암호화됩니다.
  • 경고(1)는 ⚠️ 이 키는 다시 표시되지 않습니다 문구입니다. 비밀 키(2)는 두 번째 단계에서 한 번만 보입니다.
  • .txt 다운로드 버튼(3)은 비밀 키와 경고 문구를 담은 텍스트 파일을 다운로드합니다. 다운로드한 파일도 비밀 키 자체이므로 안전한 곳에 두세요.
  • 확인 상자(4) 두 개를 선택하기 전에는 설정 완료 버튼(5)이 눌리지 않습니다.
  • 브라우저에서는 키체인 상자가 비활성이고 옆에 — Desktop 앱 전용 표시가 붙습니다.

비밀 키로 프로젝트 열기하기

활성화된 프로젝트에 들어가면 기기에서 잠금을 해제한 적이 없는 한 비밀 키 잠금해제 창이 먼저 표시됩니다. 소유자와 팀원 모두 같습니다.

  1. 비밀 키 칸(2)에 비밀 키를 넣습니다. 활성화할 때 힌트를 적었으면 위에 힌트(1)가 보입니다.
  2. 데스크톱 앱에서 다음부터 묻지 않게 하려면 이 컴퓨터에 안전하게 저장 상자(3)를 선택합니다.
  3. 잠금해제 버튼(4)을 클릭합니다.
  • 비밀 키가 틀리면 패스프레이즈가 올바르지 않습니다 문구가 나옵니다. 세 번째로 틀린 뒤부터는 잠시 기다려야 다시 넣을 수 있고, 기다리는 시간은 틀릴 때마다 5초씩 늘어 최대 60초입니다.
  • 취소 버튼을 클릭하면 프로젝트를 열지 않고 대시보드로 돌아갑니다. 창 밖을 클릭하거나 Esc 키로는 닫히지 않습니다.
  • 해제된 상태는 앱이 실행되어 있는 동안만 유지됩니다. 앱을 다시 실행하거나, 웹에서 페이지를 새로고침하거나, 로그인, 로그아웃하면 다시 잠깁니다. 키체인에 저장한 데스크톱 앱은 들어갈 때 자동으로 해제됩니다.
  • 키체인에 저장한 비밀 키가 변경된 뒤라 맞지 않으면 NeoSQL 이 키를 삭제하고 저장된 비밀 키로 잠금해제할 수 없습니다 알림을 띄웁니다. 새 비밀 키를 넣으세요.

활성화한 뒤의 메뉴

활성화하고 잠금을 해제하면 도구 모음의 버튼이 잠금 버튼으로 변경됩니다. 소유자에게는 메뉴가 붙고, 다른 팀원은 클릭하면 바로 잠급니다.

번호메뉴하는 일
1지금 세션 잠그기기기의 메모리에서 해제된 키를 삭제하고 비밀 키 잠금해제 창을 띄웁니다. 비밀 키를 키체인에 저장한 데스크톱 앱에서는 곧바로 다시 해제되므로 비활성입니다.
2이 컴퓨터에 안전하게 저장데스크톱 앱에만 있습니다. 잠그고 비밀 키 잠금해제 창을 띄웁니다. 창의 이 컴퓨터에 안전하게 저장 상자는 선택된 채 열리므로 비밀 키를 넣고 해제하면 저장됩니다. 저장한 뒤에는 같은 자리에 이 컴퓨터에서 저장된 비밀 키 제거 항목이 나옵니다.
3비밀 키 변경...활성화할 때와 같은 창으로 새 비밀 키를 정합니다. 마지막 버튼은 변경 완료 버튼입니다. 접속 정보는 그대로이고, 팀원이 키체인에 저장해 둔 옛 키로는 더 이상 해제할 수 없습니다.
4비밀 키 잠금 해제(영구)...비밀 키 잠금 해제 확인 창에서 해제 버튼을 클릭하면 표준 암호화로 돌아갑니다. 돌아간 뒤로는 운영자가 서버 코드와 키 관리 권한으로 접속 정보를 복호화할 수 있게 됩니다.

비밀 키 변경... 메뉴와 비밀 키 잠금 해제(영구)... 메뉴는 잠금을 해제한 상태에서만 사용할 수 있습니다. 비밀 키를 모르면 비활성화할 수도 없습니다. 메뉴 맨 아래의 도움말 항목은 아래 '도움말 화면' 을 엽니다.

활성화한 뒤 달라지는 것

무엇달라지는 것
팀원프로젝트에 들어갈 때마다(기기마다) 비밀 키를 넣어야 합니다. NeoSQL 은 비밀 키를 팀원에게 전하지 않으므로 소유자가 안전한 경로로 따로 알립니다
다른 기기같은 계정이라도 기기마다 처음 한 번은 비밀 키를 넣습니다. 브라우저는 키체인에 저장할 수 없어 새로 열 때마다 넣습니다
외부 MCP잠긴 프로젝트를 대상으로 한 도구 호출은 실행하지 않고, 데스크톱 앱에서 잠금을 해제하라는 안내를 돌려줍니다

자동 잠금 시간 정하기

마이페이지보안 화면의 비밀 키 자동 잠금 칸에서 잠금을 해제한 프로젝트를 다시 잠그는 시간을 선택하고 저장 버튼을 클릭합니다.
  • 선택할 수 있는 값은 끄지 않음 (편의 우선), 1분, 5분, 30분, 8시간 항목입니다(1). 처음에는 끄지 않음 (편의 우선) 항목입니다.
  • 자동 잠금 시간은 계정에 저장되고, ZK 암호화를 활성화한 모든 프로젝트에 적용됩니다. 시간이 되어 잠기면 비밀 키 잠금해제 창이 표시됩니다.
  • 시간은 보고 있는 프로젝트에서 마지막으로 클릭하거나 키를 누른 때부터 계산합니다. 저장한 값은 이 기기에 바로 적용되고, 다른 기기에는 앱을 다시 시작하거나 다시 로그인할 때 적용됩니다.

도움말 화면

앱에는 비밀 키를 잃었을 때의 대안, 비밀 키를 보관하는 방법, 다른 기기에서 사용하는 방법을 정리한

화면제로지식 도움말 화면이 있습니다. 내용은 같습니다. 소유자의 비밀 키 잠금 메뉴나, 활성화할 때 여는 창의 첫 단계 위쪽에 있는 도움말 링크로 엽니다.

주의할 점

  • 비밀 키를 잃으면 접속 정보를 되살릴 방법이 없습니다. NeoSQL 은 비밀 키의 백업을 갖고 있지 않습니다. DB 와 DB 안의 데이터는 영향을 받지 않으므로, 접속 정보를 DB 관리자에게 다시 받아 새 커넥션으로 등록하세요.
  • 힌트는 비밀 키 잠금해제 창에서 프로젝트에 들어오는 모든 팀원에게 보입니다. 비밀 키를 짐작할 수 있는 말을 적지 마세요.
  • ZK 암호화는 잠긴 동안의 접속 정보를 지킵니다. 잠금을 해제하고 작업하는 동안에는 요청을 처리하는 순간 서버가 접속 정보를 복호화합니다. 활성화하기 전에 저장한 접속 정보는 그때까지 표준 암호화로만 보호되었습니다.
  • 공용 기기에서는 자동 잠금에 의존하지 말고, 다 사용하면 지금 세션 잠그기 메뉴로 잠그거나 로그아웃하세요.
  • DB 안의 데이터는 암호화하지 않습니다. 팀원에게 값을 마스킹하려면 컬럼 마스킹 을 사용하세요.

관련 화면