매뉴얼

처음 시작하기

Bossanova는 텍스트와 이미지를 내 컴퓨터에 암호화해 보관하는 금고입니다. 무료 계정을 포함해 앱에 로그인해야 사용할 수 있습니다. 계정 로그인과 금고를 여는 마스터 비밀번호는 서로 다릅니다.

Google 화면에서 ‘이미 기기에 있는 계정’ 안내로 막히면 여기로 돌아와 같은 Google 이메일 주소로 ‘이메일로 계속하기’를 이용하세요. 같은 이메일 주소로 이미 Bossanova에 가입했다면 기존 계정으로 로그인됩니다. 다른 브라우저에서도 시도할 수 있습니다.

현재 설치 파일은 Windows 10/11의 x64용입니다. Windows 32비트와 ARM64 전용 설치 파일은 제공하지 않습니다. WebView2 설치·갱신에는 인터넷 연결이 필요할 수 있습니다.

1. 다운로드 페이지에서 운영체제에 맞는 설치 파일을 받아 설치하세요.
2. 설치를 완료하고 시작 메뉴에서 Bossanova를 여세요. Windows 10/11 x64를 지원하며 WebView2가 없으면 설치 프로그램이 준비합니다. 회사 PC에서 설치가 막히면 관리자에게 문의하세요.
3. 앱의 로그인 화면에서 Google·Apple 또는 이메일로 가입·로그인하고 이 기기를 승인하세요. 무료 계정으로 정보 10개를 저장할 수 있습니다.
4. 첫 화면에서 새 금고를 만들고 충분히 긴 마스터 비밀번호를 정해 안전한 곳에 보관하세요. 기존 금고를 옮기려면 새 금고를 만들기 전에 ‘다른 기기에서 불러오기’를 선택합니다. 백업 파일 복구는 별도의 ‘백업에서 복구’를 사용합니다.
5. 금고가 열리면 먼저 실제 비밀이 아닌 예제 정보 하나를 저장하고, 검색·보기·복사를 해 보세요. 그다음 실제 정보를 추가하고 외부 백업을 만드세요.

마스터 비밀번호를 잃으면 개발사도 금고를 복구할 수 없습니다. Google·Apple 로그인이나 이메일 로그인으로 마스터 비밀번호를 재설정할 수는 없습니다.

데이터 저장과 정리

Bossanova의 금고는 폴더 → 그룹 → 데이터 순서로 정리합니다. 데이터는 이름과 값 하나(텍스트 또는 이미지)이고, 같은 성질의 데이터를 묶은 것이 그룹입니다. 폴더에는 그룹과 그룹에 속하지 않은 데이터가 함께 들어가며, 폴더가 모인 것이 금고입니다. 예를 들어 ‘API 키’ 폴더 안에 ‘bossanova’ 그룹을 만들고 그 안에 ‘OpenAI API 키’·‘갱신일’ 데이터를 넣을 수 있습니다. 텍스트·이미지 데이터는 각각 1개로 계산합니다.

폴더로 그룹과 데이터를 나눕니다. 손잡이를 끌어 순서를 바꾸세요. 폴더를 지울 때 안의 내용을 남길지 함께 지울지 고를 수 있습니다.

AI 접근은 별 모양 아이콘으로 켜거나 끕니다. 마우스를 올리면 이름이 나오고, 켜지면 배경이 옅은 녹색으로 바뀌며 선 모양은 유지됩니다. 목록·상세·데이터 편집·그룹 생성과 편집에서 같은 버튼을 씁니다. 전체 보기와 폴더의 정렬 메뉴에는 기본·최신순·과거순·자주 쓰는 순·덜 쓰는 순·이름순·역이름순이 있습니다. 마지막 선택은 이 금고에 저장되어 다음 실행에도 공통으로 적용됩니다. 이름은 화면 언어에 맞춰 정렬하며 숫자 2는 10보다 먼저 옵니다. 폴더에서 손잡이로 순서를 바꾸려면 기본을 고르세요. 다른 정렬을 골라도 직접 정한 기본 순서는 보존됩니다.

설정 → AI → AI 접근의 ‘새 데이터에 자동으로 AI 접근 허용’은 기본 꺼짐입니다. 켜면 이후 추가하는 텍스트·이미지, 그룹 생성·편집에서 추가한 데이터, 템플릿, .env 가져오기에 적용됩니다. 저장 전 개별 AI 아이콘은 바꿀 수 있습니다. 기존 데이터·비밀 아님·실행 승인은 바뀌지 않으며, 설정은 이 금고에 저장됩니다.

1. 왼쪽 메뉴의 ‘폴더 추가 및 관리’에서 폴더를 만들고 손잡이를 끌어 순서를 정합니다.
2. ‘데이터 추가’로 이름·종류(텍스트·이미지; 예전 데이터의 비밀번호·숫자·날짜 종류는 그대로 유지)·값을 넣습니다. 그룹을 고르지 않으면 폴더에 바로 놓입니다. 이미지는 PNG, JPEG, GIF, WebP, BMP, ICO, TIFF, TGA, PNM, QOI, HDR을 10MiB까지 끌어다 놓거나 붙여 넣습니다. 데이터를 누르면 상세가 열리고 ‘편집’을 누르면 저장된 값이 채워진 편집 창이 열립니다(‘값 보기’로 확인).
3. 데이터를 다른 데이터 위에 끌어다 놓으면 새 그룹이 되고, 그룹을 그룹 위에 놓으면 합칠 수 있습니다. 손잡이로 순서도 바꿉니다.
4. 데이터의 보기·복사 기능으로 필요할 때 사용합니다. 복사한 값은 붙여 넣은 앱이나 문서에서도 볼 수 있으므로 목적지를 확인하세요.
5. Plus·Pro에서는 템플릿으로 자주 쓰는 그룹을 만들 수 있습니다. 템플릿을 적용해도 값은 직접 입력해야 합니다.

비밀은 반드시 값 입력란에 넣으세요. 데이터 이름과 설명, 그룹·폴더 이름에는 비밀을 적지 마세요. AI 설정에 따라 이런 이름표도 AI에 공개될 수 있습니다.

‘.env’ 파일 가져오기

프로젝트의 ‘.env’ 파일에 있는 비밀을 한 번에 금고로 옮길 수 있습니다. ‘새 그룹’ 창 왼쪽 아래의 ‘.env 가져오기’ 버튼을 누르거나 파일을 금고 화면에 끌어다 놓으세요. 파일 하나가 그룹 하나가 되고 변수 하나가 변수 이름을 딴 데이터 하나가 됩니다. 모두 비밀로 저장하며 AI 접근은 ‘새 데이터에 자동으로 AI 접근 허용’ 설정을 따릅니다.

1. 미리보기에는 변수 이름만 나오고 값은 화면에 보이지 않습니다. 그룹 이름을 정하고(예: web .env) 목록을 확인하세요.
2. 포트·공개 URL처럼 비밀이 아닌 값은 ‘비밀 아님 후보’로 표시됩니다. 기본은 모두 비밀이며, 사람이 직접 고른 항목만 경고를 확인한 뒤 ‘비밀 아님’으로 표시됩니다.
3. 파일 선택으로 가져온 경우 원본 ‘.env’ 파일을 삭제하는 선택지가 있습니다. 끌어다 놓은 파일은 삭제하지 않습니다.
4. 가져오기는 한 번에 저장됩니다. 요금제의 정보 한도를 넘으면 아무것도 저장하지 않고 업그레이드 안내를 표시하며, 기존 정보는 그대로입니다.

가져온 그룹은 AI가 ‘실행에 넣기’에서 그룹 단위로 쓸 수 있습니다. 그룹의 AI 접근이 켜진 데이터가 데이터 이름을 딴 환경 변수로 한꺼번에 들어갑니다. 프로젝트에 ‘.env’ 파일을 남겨 두면 AI가 그 파일을 읽을 수 있으므로 금고로 옮긴 뒤에는 파일을 정리하세요.

검색해서 바로 찾기

금고를 연 상태에서 검색창에 이름이나 키워드를 입력하세요. Enter를 누르기 전부터 결과가 바뀝니다. ‘사업자등록번호’를 찾으려면 ‘사’처럼 짧게 시작해도 됩니다. 정확한 일치를 우선하고 부분 일치와 유사한 입력을 함께 고려합니다.

검색은 이 컴퓨터의 알고리즘으로 처리하며 AI나 계정 서버에 검색어를 보내지 않습니다. 기본으로 이름·설명을 검색하고, 검색창의 ‘값 내용도 검색’을 켜면 텍스트 값도 함께 찾습니다. 값이 일치하더라도 검색 결과에 비밀 원문을 표시하지 않습니다. 이미지는 OCR로 검색하지 않습니다. 결과를 선택한 뒤 필요한 필드에서 보기·복사를 사용하세요.

원하는 결과가 없다면 검색어를 짧게 바꾸거나 띄어쓰기를 바꿔 보세요. 검색어를 지우면 전체 목록으로 돌아갑니다. 금고를 잠그면 검색도 사용할 수 없습니다.

언어

설정 → 일반 → 언어 — 화면에 쓰는 언어입니다. 고르면 바로 적용되고 이 금고에 저장됩니다. 잠금 화면은 컴퓨터 언어를 씁니다.

잠금과 종료

자리를 비울 때는 금고를 잠그세요. 새 금고의 자동 잠금 기본값은 5분이며 기존 금고의 설정은 유지합니다. 설정에서 시간을 바꿀 수 있습니다. 잠금 중에는 비밀 값을 사용하는 AI 작업도 진행할 수 없습니다. AI가 요청 중이면 사람이 잠금을 푼 뒤 12시간 안에서 자동 잠금이 연장되고, 마지막 AI 요청 뒤 60분 동안은 자리를 비워도 잠기지 않습니다. 긴 빌드가 끝나기 전에 금고가 잠기지 않게 하기 위한 것입니다.

창의 닫기 버튼은 앱을 트레이에 남깁니다. 다시 열려면 트레이의 Bossanova 아이콘을 누르고, 완전히 끝내려면 트레이 메뉴의 ‘종료’를 선택하세요. PC가 꺼져 있거나 Bossanova가 종료된 동안에는 로컬 금고를 사용하는 AI 작업도 불가능합니다.

자동 잠금을 끈 경우에는 자리를 비우기 전에 잠그기 또는 Ctrl/Cmd+L을 누르세요.

자동 시작과 잠금 해제

설정 → 일반 → 자동 시작과 잠금 해제에서 ‘PC 시작 시 자동 실행’을 켜면 다음 로그인 때 Bossanova가 열립니다. 기본값은 꺼짐입니다.

‘앱 시작 시 금고 자동 열기’는 별도 설정입니다. 설명을 읽고 마스터 비밀번호로 확인하면 기기 보안 저장소에 해제 자격을 보관합니다. 두 설정을 모두 켜면 다음 컴퓨터 로그인 때 창 없이 트레이에서 시작합니다.

자동 열기는 OS 로그인마다 한 번만 작동합니다. 수동 잠금, 절전, 화면 잠금 뒤나 앱을 다시 실행할 때는 비밀번호가 필요합니다. 비밀번호 변경과 보안 초기화는 자동 열기를 끕니다. 기기 자동 열기 자격은 백업으로 옮겨지지 않습니다.

자동 열기를 켜면 이 OS 사용자 권한을 가진 프로그램이 금고에 접근할 위험이 커집니다. 공용 PC에서는 사용하지 마세요. 마스터 비밀번호와 외부 암호화 백업은 계속 필요합니다.

기기 간 전송과 암호화 백업

금고는 실행 파일 옆이 아니라 운영체제 사용자 전용 앱 데이터 폴더와 보안 저장소에 있습니다. EXE만 옮겨서는 금고가 따라가지 않습니다. 기기 간 자동 동기화는 제공하지 않습니다.

일반적인 기기 간 이동은 같은 Wi-Fi/LAN의 직접 전송으로 합니다. 금고와 이미지는 암호화되어 두 기기 사이로만 오가며 Bossanova 서버를 거치지 않습니다. 백업 파일을 USB에 담아 옮길 필요가 없습니다. Bossanova (Windows)의 전송 한도는 이미지를 포함한 암호화 금고 전체 2GiB입니다. 양쪽 기기 모두 이 백업 형식을 지원하는 버전이 필요합니다.

처음 받는 기기는 같은 금고에 참여합니다. 이후에는 폴더·그룹·데이터의 변경을 합치며, 양쪽에서 같은 항목을 다르게 바꾼 경우에만 어느 것을 남길지 고릅니다. 자동 동기화가 아니므로 변경을 주고받을 때마다 불러오기를 실행하세요. AI 연결과 승인은 다른 기기로 옮겨지지 않습니다.

암호화 백업은 기기 간 전송과 별개인 재해 복구용 사본입니다. 데스크톱의 설정 → 백업에서 만들거나 복구할 수 있습니다. 디스크 고장에도 남을 안전한 위치에 별도 사본을 보관하세요. 복구는 백업 당시로 돌아가므로 먼저 현재 상태를 백업하고, 복구를 확인할 때까지 원본을 보존하세요.

이미지 파일이 손상되거나 사라져 금고가 열리지 않으면 잠금 화면의 ‘백업에서 복구’를 선택하세요. 같은 금고의 정상 백업을 고르고 현재 마스터 비밀번호와 백업 당시의 비밀번호를 각각 입력합니다. 두 비밀번호는 다를 수 있습니다. 앱은 교체 전 손상된 원본과 남은 암호화 파일을 보존하지만, 이미 사라진 내용까지 되살리지는 못합니다. 백업 시점으로 돌아가며 현재 마스터 비밀번호는 유지됩니다. 복구 후 AI 연결·승인·값 공개 설정을 다시 확인하세요.

자동 백업은 이 PC 안(앱 데이터 폴더)에 만드는 사본이라 실수로 지운 정보를 되돌릴 때 씁니다. 비밀번호를 바꾸거나 보안 재설정을 한 뒤에는 금고를 다시 내보내세요.

백업 시점의 정보로 되돌립니다. 이후 추가·변경한 정보는 교체됩니다. 복구 전 현재 금고의 암호화 사본을 이 PC에 자동 보관합니다. 기존 접근 기록은 유지하고 AI 연결과 값 공개는 초기화합니다.

1. 두 기기를 같은 일반 Wi-Fi/LAN에 연결하고 같은 Bossanova 계정으로 로그인합니다. 두 앱을 열고 기존 금고의 잠금을 푸세요. 아직 금고가 없는 받는 기기는 첫 화면의 ‘다른 기기에서 불러오기’로 시작합니다.
2. 보내는 기기에서 설정 → 백업 → ‘이 금고 내보내기’를 선택합니다. 표시된 코드는 한 번만 사용할 수 있고 3분 뒤 만료됩니다.
3. 받는 기기에서 ‘다른 기기에서 불러오기’를 선택하고 보내는 기기의 코드와 그 금고의 마스터 비밀번호를 입력합니다. 같은 LAN에서 상대를 자동으로 찾습니다.
4. 완료될 때까지 두 앱을 화면에 열어 두고 기존 금고의 잠금을 유지하세요. 앱을 백그라운드로 보내거나 금고를 잠그면 전송이 취소될 수 있습니다. 받은 내용을 확인하고, 충돌이 있으면 남길 항목을 골라 합치세요.

게스트 Wi-Fi의 기기 간 차단, VPN, 방화벽 때문에 상대를 찾지 못할 수 있습니다. 두 기기를 같은 일반 Wi-Fi로 옮기고 로컬 네트워크 접근을 허용한 뒤 다시 시도하세요. 인터넷 중계로 자동 전환하지 않습니다. 기기 간 복제는 삭제나 실수도 옮길 수 있으므로 별도 백업을 대신하지 않습니다.

보안

설정 → 보안 → 마스터 비밀번호 변경 — 일반 변경은 금고를 여는 비밀번호만 바꿉니다. 내부 암호화 키와 과거 백업은 바뀌지 않습니다. 유출이 의심되면 ‘유출 대응 · 보안 재설정’을 사용하세요.

설정 → 보안 → 유출 대응 · 보안 재설정 — 현재 정보를 새 암호화 키와 새 비밀번호로 보호합니다. 필드와 값은 보존하고 AI 연결·접근·값 공개는 모두 초기화합니다. 새 접근 기록을 시작하며 이전 기록은 변경 전 백업에 남습니다.

변경 전 암호화 백업을 이 PC에 보존합니다. 과거 백업은 옛 비밀번호로 계속 열리며 새 금고에 바로 덮어쓸 수 없습니다. 별도 빈 저장소에서 복구할 수 있습니다.

PC 감염이 의심되면 먼저 신뢰할 수 있는 기기에서 조치하세요. 감염된 PC에서 비밀번호만 바꿔서는 보호되지 않습니다.

이미 유출된 과거 내용은 회수되지 않습니다. 유출된 서비스 비밀번호와 API 키는 해당 서비스에서 변경·폐기하세요. 완료 후 새 외부 백업을 만드세요.

금고 영구 삭제는 마스터 비밀번호 확인 후 이 PC의 금고와 내부 백업을 지웁니다. 되돌릴 수 없습니다. 별도 위치의 외부 백업은 남습니다.

계정·요금제·기기 관리

Free를 포함한 모든 요금제는 앱 로그인이 필요합니다. Google·Apple 또는 이메일로 로그인하고 표시된 기기를 승인하세요. 이미 로그인했다면 설정의 계정·구독 항목에서 연결 상태를 확인할 수 있습니다.

Apple에서 ‘이메일 가리기’를 선택하면 기존 Google·이메일 계정과 다른 계정이 만들어질 수 있습니다. 기존 구독을 사용하려면 사용하던 로그인 수단으로 로그인하세요.

요금제의 데이터 개수 제한은 새 데이터 추가와 기존 내용 편집에 적용됩니다. 이미 저장한 데이터의 AI 조회·사용은 개수 제한을 받지 않습니다. 읽기 전용 데이터도 ‘AI 접근’과 ‘비밀 아님’을 각각 켜거나 끌 수 있습니다. ‘비밀 아님’을 켤 때의 공개 동의와 실제 실행에 필요한 금고 잠금 해제·연결 승인·활성 기기·작업 승인은 그대로 필요합니다.

구독이 끝나도 기존 정보의 열람·검색·복사·백업·복구는 계속 가능합니다. 고정된 무료 기본 10개는 수정할 수 있고 추가 필드는 읽기 전용입니다. 이름이나 순서를 바꿔도 기본·추가 구분은 바뀌지 않습니다. 템플릿은 Plus·Pro 전용입니다.

앱 설정 → 계정·구독의 ‘프로모션 코드’에서 무료 이용권을 등록하세요. 웹에서는 내 계정의 코드 입력란을 사용합니다. 할인 코드는 요금제를 선택한 뒤 Paddle 결제창에서 입력할 수 있습니다.

무료 이용권은 카드 없이 적용하며 표시된 종료일에 끝납니다. 자동으로 결제되지 않습니다. 같은 등급의 이용권은 남은 기간 뒤에 이어 붙습니다. 유료 이용 중이거나 다른 등급의 이용권이 남아 있으면 종료 후 등록하세요. 미완료 결제가 있으면 내 계정에서 미결제 건을 취소한 뒤 등록할 수 있습니다.

할인 코드는 적용 후 할인 대상 요금제를 선택해 Paddle 결제를 완료해야 합니다. 카드 등 결제 수단이 필요하며 구독은 해지할 때까지 갱신됩니다. 할인율과 적용 횟수, 연간 총액을 확인하세요. 정해진 할인 횟수가 끝나면 정상 요금으로 갱신됩니다. 결제 관리에서 결제 수단·영수증·해지를 관리합니다.

로그인한 가격 페이지에서 요금제와 결제 주기를 변경할 수 있습니다. 결제액을 확인해 확정하면 즉시 적용됩니다. 구독 해지는 ‘구독 관리·해지’를 이용하세요. 이용권 사용 중에도 Plus 또는 Pro를 선택해 구독을 예약할 수 있습니다. 지금은 청구하지 않으며 결제 수단을 등록하고 첫 결제일과 갱신 금액을 확인합니다. 이용권 종료 이후 첫 결제가 성공하면 선택한 요금제가 적용됩니다. 예약을 취소해도 기존 이용권의 남은 기간은 유지됩니다. 이용권을 추가하려면 먼저 예약을 취소하세요. 일부 가격 한정 할인 코드는 예약에 사용할 수 없습니다. 한국 등 추가 동의가 필요한 지역에서는 Paddle이 첫 유료 결제 전에 동의를 요청합니다. 동의하지 않으면 예약이 취소되고 청구되지 않습니다.

로그인한 기기는 이 계정에 연결된 앱의 목록입니다. ‘금고 편집 가능’ 숫자만 요금제의 기기 한도에 포함됩니다. ‘편집 중지’는 다음 계정 확인 때 읽기 전용으로 바꾸고, 기기 옆 ‘로그아웃’은 다시 로그인하도록 합니다. 두 동작 모두 금고 파일과 백업을 삭제하지 않습니다.

로그아웃하면 금고가 잠기며 다시 로그인해야 사용할 수 있습니다. 원본과 백업은 삭제되지 않습니다. 로그인할 수 없을 때는 로그인 화면의 긴급 백업 내보내기에서 마스터 비밀번호로 암호화 백업을 한 번 내보낼 수 있습니다. 로그인 상태에서 유료 기간이 끝나면 기본 10개는 수정할 수 있고 추가 필드는 읽기 전용으로 보존됩니다. 유료 기능의 오프라인 유효기간은 최대 7일입니다.

AI 연결

AI 없이도 Bossanova를 쓸 수 있습니다. 연결하면 AI는 금고의 값을 받지 않은 채, 값이 필요한 일을 Bossanova에 맡깁니다. 데이터에 ‘AI 접근’을 켜면 AI에게는 그 데이터의 이름·설명·그룹만 보이고 값은 보이지 않습니다. 값을 어디에 쓸지는 AI가 처음 쓰려 할 때 앱의 승인 카드에서 사람이 허용합니다.

승인 항목 오른쪽 위 휴지통은 해당 승인만 회수합니다. ‘연결 문제 해결·직접 등록’은 연결 복구와 목록에 없는 AI 추가에 사용하며 평소에는 변경할 필요가 없습니다.

1. Bossanova 잠금을 풀고 설정 → AI에서 “내 컴퓨터에서 AI 찾기”를 누르세요. 설치된 Claude 앱과 로컬 CLI를 찾습니다. 일반 ChatGPT Chat은 별도의 “ChatGPT” 카드에서 연결합니다.
2. 각 AI의 스위치로 연결합니다. Claude 앱은 로컬 Code 탭용 bsnv 스킬도 설치합니다. Code에서는 /mcp로 연결, /bsnv로 사용 안내를 확인하고, Chat에서는 + → 커넥터를 사용합니다. Chat에는 MCP로 사용 안내를 전달합니다. 기존 연결의 스킬은 업데이트 후 금고를 열 때 갱신됩니다. 모두 연결은 중복을 막기 위해 네이티브 Claude Code를 제외하며 WSL 행은 포함합니다.
3. Claude 앱을 연결한 뒤 완전히 종료하고 다시 여세요. “Codex” 행은 Codex 호스트 설정입니다. ChatGPT 앱의 일반 Chat과 웹은 OpenAI 공식 터널 연결을 사용하며, Codex 설정만으로 연결되지 않습니다.
4. CLI는 새 대화를 열어 Bossanova 도구가 보이는지 확인합니다. 사용할 데이터의 ‘AI 접근’을 켠 뒤 AI에게 평소처럼 일을 시키세요(예: “Bossanova에 있는 배포 토큰으로 배포해 줘”). AI는 이름과 설명으로 데이터를 고릅니다.
5. AI가 데이터를 처음 쓰려 하면 Bossanova에 승인 카드가 뜹니다. 데이터와 대상(서비스, 또는 실행 파일·폴더·변수 이름·운반체)을 확인하고 거부·이번만·24시간·7일·30일·항상 중에서 고릅니다. 허용한 뒤에는 같은 대상에 다시 묻지 않습니다.

프로젝트 제어는 ChatGPT 앱·웹의 일반 Chat과 Claude 앱에서 지원합니다. 같은 AI라도 WSL과 Windows 연결은 별개입니다. 이전 대화가 옛 MCP 연결을 보관하면 도구 새로고침 또는 새 대화가 필요합니다.

AI가 값을 쓰는 방법

AI는 값을 받지 않습니다. 값이 필요한 일은 두 가지 방법으로 Bossanova가 대신 합니다.

‘대신 보내기’: AI가 HTTPS 요청(메서드·URL·헤더·본문)을 값 자리표시자와 함께 주면 Bossanova가 그 요청을 직접 보내고 값을 그 자리에만 끼웁니다. 값은 AI의 코드·요청·응답 어디에도 없습니다. 어떤 서비스를 처음 쓸 때 승인 카드에 데이터와 그 서비스의 host 묶음(GitHub처럼 잘 알려진 서비스는 관련 host를 한 번에)이 표시되고, 같은 서비스의 다른 경로·메서드는 다시 묻지 않습니다. https와 443 포트, 공개 주소만 허용하고 리다이렉트는 따르지 않으며, 응답은 값이 되돌아온 부분을 가린 뒤 AI에게 돌려줍니다. 배포 토큰, 결제·메일·클라우드 API 키처럼 서버에 보내는 비밀은 이 방식이 맞습니다.

‘실행에 넣기’: AI가 실행 파일(절대 경로, 스크립트는 파일 자체)·작업 폴더·이번 실행의 인자·환경 변수 이름을 지정하면 첫 사용 때 승인 카드가 뜨고, 허용하면 Bossanova가 그 프로그램을 직접 띄우고 값을 카드에 적힌 운반체로만 넣습니다. 인자는 승인과 무관하게 실행마다 AI가 바꿀 수 있고, 실행 파일·폴더·변수 이름·운반체가 바뀌거나 스크립트 내용이 바뀌면 다시 묻습니다. 운반체는 네 가지입니다. 환경 변수(값 그대로), 임시 파일(경로를 환경 변수로 주고 실행 뒤 삭제), 프록시(프로세스에는 가짜 토큰만 주고 Bossanova의 실행별 HTTPS 프록시가 카드에 적힌 host로 가는 요청에서만 진짜 값으로 바꿈), SSH agent(키는 Bossanova 안에서만 서명). 프록시·agent 운반체에서는 프로세스가 값 원문을 받지 않습니다(응답에 값이 되돌아와도 가짜 토큰으로 되돌립니다). 다만 ‘대신 보내기’와 달리 응답은 프로세스가 먼저 보고, SSH agent는 그 프로그램이 어느 서버에든 그 키로 서명받게 할 수 있어 승인 카드가 이를 알립니다.

빌드 도구나 클라이언트 SDK 키처럼 앱에 들어가야 하는 값은 환경 변수 운반체가 맞습니다. 이때 값은 그 프로세스 안에 있으므로 그 프로그램과 자식 프로세스, 산출물에 남을 수 있습니다. ‘대신 보내기’로 어떤 서비스에 묶인 데이터는 환경 변수·임시 파일 운반체로는 실행에 넣을 수 없습니다(서버 비밀이 AI가 쓴 코드에 닿지 않게). ‘.env’에서 가져온 그룹은 그룹 단위로 넣을 수 있고, 개발 서버처럼 끝나지 않는 명령은 세션으로 띄워 AI가 실행 중 로그를 보고 중지를 요청할 수 있습니다. WSL의 Linux 경로는 그 배포판 안에서 실행합니다. 실행 상한은 24시간입니다.

AI에게는 종료 코드·소요 시간과 값을 가린 실행 로그가 돌아갑니다(값의 원문·base64·URL 인코딩을 가리고 비밀처럼 보이는 문자열을 지움). 명령이 값을 출력했다면 그 로그는 AI에게 가지 않고 이유만 전달되며, 사람은 AI 탭의 ‘최근 실행’에서 가린 로그를 봅니다.

승인은 데이터 × 대상마다 하나이고 어느 AI가 요청했는지와 무관합니다(요청한 AI는 접근 기록에만 남습니다). 기간은 이번만·24시간·7일·30일·항상이며 AI 탭의 승인 목록에서 회수할 수 있습니다. 이미 목적지에 도착한 요청이나 실행 중인 프로그램에 넘어간 값은 회수로 되돌릴 수 없습니다.

이미지(도장·서명)는 금고에 보관해 사람이 보고 복사하는 용도이며 AI가 자동으로 쓰는 기능은 없습니다. 브라우저 화면에 대신 입력하거나 문서를 완성하는 기능도 없습니다.

env·file은 승인한 프로세스가 실제 값을 받습니다. send·proxy·agent도 승인된 서비스에 비밀을 저장하면 다른 경로로 다시 읽힐 수 있습니다. AI가 읽을 수 있는 문서·로그·메시지에 비밀을 저장하지 마세요. OS·앱·승인한 대상은 신뢰 전제입니다.

AI 접근을 끄면 비밀값 사용이 중지되고 기간 승인(항상 포함)은 유지됩니다. 다시 켜면 값과 사용처가 그대로인 새 요청에 남은 승인을 적용하며, 원래 만료 시각은 바뀌지 않습니다. 이전 대기 요청과 ‘이번만’ 승인은 이어지지 않습니다. 승인을 완전히 취소하려면 ‘승인 회수’를 누르세요. ‘비밀 아님’ 설정은 별개입니다.

‘비밀 아님’ 표시

포트 번호·공개 URL·프로젝트 ID처럼 AI가 값을 그대로 읽어야 하는 설정값은 데이터 상세에서 ‘비밀 아님’으로 표시합니다. ‘AI 접근’과는 별개의 설정이며 기본은 꺼짐입니다. ‘비밀 아님’ 데이터는 연결된 AI가 전용 읽기 도구로 값을 그대로 읽으며, 나중에 연결한 AI도 읽을 수 있습니다. ‘AI 접근’이 꺼져 있어도 ‘비밀 아님’이 켜져 있으면 읽기 도구로는 값이 읽히며, 실행에 넣기·대신 보내기 목록에는 나오지 않습니다. 화면에서는 ‘비밀 아님’ 값을 가리지 않습니다. 텍스트는 목록과 상세에 원문이 보이고, 이미지는 목록에 작은 미리보기·상세에 큰 그림이 보입니다.

추가·편집 창에서 비밀 아님을 켜면 값이 바로 보이므로 눈 아이콘은 흐리게 표시되며 누를 수 없습니다.

1. 데이터 상세 또는 편집 대화상자를 열고 ‘비밀 아님’을 켭니다. 이미 AI에 전송된 값은 회수할 수 없다는 경고를 읽은 뒤 ‘이해했으며 비밀 아님으로 표시’를 선택하세요. 이 설정은 목록 행에서는 바꿀 수 없습니다. 목록과 상세에서는 눈 아이콘이 경고 색으로 표시됩니다.
2. .env 가져오기 미리보기에서도 후보 항목을 같은 방식으로 표시할 수 있습니다.
3. 표시를 끄면 이후 읽기는 막히지만 이미 AI에 전달된 값은 회수되지 않습니다. 데이터와 그룹의 추가·편집 창에서는 켜 둔 상태가 입력 중에도 유지되고 텍스트를 가리지 않습니다. 켠 채 저장하면 바뀐 값도 공개됩니다. 백업을 복구하면 표시는 꺼집니다.

‘비밀 아님’으로 표시한 값은 선택한 AI 서비스에 전달될 수 있으며, 한 번 전송되면 회수할 수 없습니다. 비밀번호나 API 키는 이렇게 표시하지 말고 ‘대신 보내기’ 또는 ‘실행에 넣기’를 사용하세요.

업데이트와 파일 확인

설정 → 일반 → 앱 업데이트에서 자동 확인·다운로드를 켜거나 수동으로 확인하세요. 확인과 다운로드는 금고 사용 중에도 진행합니다. 준비된 업데이트는 다음 실행 때 적용하며, 편집을 마친 뒤 ‘업데이트하고 다시 시작’으로 바로 적용할 수도 있습니다. 서명 준비 중이면 공식 다운로드의 배포 상태를 확인하세요.

업데이트는 금고를 잠그고 앱 파일을 교체하며 저장한 정보는 유지합니다. 수동 업데이트는 새 공식 설치 파일을 실행하세요. 기존 설치 위치를 그대로 사용합니다. 서명된 공개 배포본은 Windows 파일 속성의 디지털 서명에서 게시자를 확인하세요. 서명이 없는 내부 시험본은 정식 서명 배포본이 아닙니다. SHA-256은 보조 무결성 확인입니다.

Bossanova 0.1.41부터 Windows에서 앱을 제거하면 로그아웃됩니다. 금고를 보존했다면 재설치 후 같은 계정으로 로그인하고 마스터 비밀번호로 여세요. 프로그램 제거는 기본적으로 금고 데이터를 보존합니다. Windows 제거 화면의 데이터 삭제를 직접 선택하면 금고도 삭제될 수 있습니다. 외부 백업은 별도입니다. 새 PC로 옮길 때는 같은 Wi-Fi의 내보내기·불러오기를 사용하세요. 외부 백업 복구도 가능합니다.

업데이트는 백그라운드에서 준비하며 금고와 계정 정보는 전송하지 않습니다.

Get-FileHash .\Bossanova-Setup.exe -Algorithm SHA256

금고 데이터 폴더는 삭제하지 마세요. 서명이나 체크섬이 다르면 실행하지 말고 공식 배포 상태를 확인하세요.

문제가 생겼을 때

1. 앱이 열리지 않으면 Windows 버전·x64 환경·WebView2 안내를 확인합니다. 보안 프로그램의 경고를 무조건 우회하지 말고 공식 다운로드 페이지의 배포 상태와 파일을 확인하세요.
2. 검색 결과가 없으면 금고 잠금 상태와 검색어를 확인합니다. 정보 추가나 .env 가져오기가 막히면 요금제의 정보 한도(Free 10개)와 구독 상태를 확인합니다.
3. AI 도구가 없으면 설정 → AI 탭에서 그 AI의 연결 토글이 켜져 있는지 확인하고 새 대화를 엽니다. WSL과 Windows의 AI는 따로 표시되므로 실제로 쓰는 쪽을 연결합니다. Claude 앱과 ChatGPT 앱은 연결 뒤 다시 시작해야 도구가 보입니다.
4. 설정 → AI에서 연결을 켜면 연결 승인이 완료됩니다. 별도 연결 승인 카드는 없으며, 데이터 사용 승인은 별도로 유지됩니다. 예전 승인 대기·거부 연결은 직접 켜야 합니다. DENIED가 나오면 reason·detail·connection을 확인하세요. 재연결만으로 권한이 생기지는 않습니다.
5. AI가 실행 로그를 받지 못했다고 하면 명령이 값을 출력한 것입니다. AI 탭의 ‘최근 실행’에서 가린 로그를 확인하고 값을 출력하지 않게 명령을 고치세요.
6. Windows curl의 Schannel은 SSL_CERT_FILE을 자동으로 읽지 않습니다. 승인된 프로세스 안에서 그 경로를 --cacert로 전달하세요. 폐기 목록의 오프라인·누락 오류에만 --ssl-revoke-best-effort를 사용하고 --insecure는 쓰지 마세요. Windows gh는 WSL 실행을 고려하세요. AWS 요청 서명에는 env·file 등 도구에 맞는 운반체가 필요합니다. docker login은 file 운반체의 파일을 승인된 프로세스가 --password-stdin으로 읽게 할 수 있습니다. 임시 DOCKER_CONFIG를 쓰고 종료 후 정리하세요.
7. 해결되지 않으면 화면의 오류 문구, 운영체제, 앱 버전과 재현 순서를 문의로 보냅니다. 비밀번호·금고 파일·비밀 값·연결 토큰은 보내지 마세요.

Bossanova는 OS나 다른 프로그램까지 통제하지 않습니다. AI에 관리자·파일·화면·메모리 등 광범위한 권한을 주거나 컴퓨터가 침해되면 별도 경로로 정보가 노출될 수 있습니다. 자세한 범위는 비밀 보호 안내를 확인하세요.