Bramble

비밀번호를 자신의 기기에만 보관하는 비밀번호 관리자입니다. 계정도, 볼트를 보관하는 서버도, 해킹당해 모든 것을 유출할 회사도 없습니다. 볼트는 당신이, 비밀번호는 당신이 쥐고 있습니다. 그게 전부입니다.

Bramble은 당신이 사용하는 환경 어디서든 실행됩니다:

• 브라우저 확장 프로그램 — Chromium 계열 브라우저(Brave, Vivaldi, Chrome, Arc 등)용. 설치하면 1분 안에 바로 사용할 수 있습니다.
• 데스크톱 앱 — macOS 및 Linux용. 전역 빠른 접근 패널, 상시 동기화 허브, 예약 백업을 제공합니다.
• iOS 앱 — 시스템 AutoFill, Face ID / Touch ID 잠금 해제, 패스키 지원.
• Android 앱 — 네이티브 자동 완성 서비스, 생체 인식 잠금 해제, 패스키 지원.

동일한 암호화 볼트와 동일한 Rust 암호화 코어가 네 플랫폼 모두의 기반이 되며, 기기 간에 클라우드를 거치지 않고 직접 P2P로 동기화할 수 있습니다.

Bramble 받기:

• Chromium: Chrome 웹 스토어
• Firefox: Firefox 부가 기능 스토어
• 데스크톱(macOS, Linux): bramble.sh
• Android: 릴리스
• iOS: App Store

스크린샷

하는 일

비밀번호는 자신의 기기에서 암호화된 상태로 그 자리에 남아 있습니다. 브라우저의 비공개 확장 프로그램 저장소, 데스크톱 앱의 일반 파일, 모바일의 앱 전용 암호화 저장소에 보관됩니다. 볼트를 보관하는 서버도, 가입할 계정도 없습니다. 여러 기기에서 동일한 볼트를 사용하려면 Bramble이 볼트를 기기 간에 직접, P2P로, 종단 간 암호화하여 클라우드를 거치지 않고 동기화합니다. 직접 손에 쥐고 싶은 사본이 필요하신가요? 언제든 암호화된 백업 파일을 내보낼 수 있습니다.

모든 암호화 작업은 단일 Rust 코어 내부에서 이루어집니다. 브라우저에서는 WebAssembly로, iOS와 Android에서는 네이티브 라이브러리로 컴파일됩니다. 키 유도, 암호화, 복호화가 모두 이 코어에서 실행되며, 파생된 키는 사용 후 메모리에서 삭제됩니다.

백업

다른 누구도 볼트의 사본을 보관하지 않으므로 백업을 유지하는 것은 당신의 몫입니다. Bramble은 두 가지 방법을 제공합니다:

• 명시적: 백업 파일 내보내기. 브라우저 확장 프로그램이나 데스크톱 앱의 설정에서 전체 볼트를 암호화된 .bramble 파일로 내보내 다른 드라이브, USB 등 안전한 곳에 보관하세요. 암호문 상태로 유지되므로 열려면 여전히 마스터 비밀번호가 필요하며, 도난당한 백업은 그 자체로 쓸모가 없습니다. 특히 큰 변경 전에 수시로 수행하세요.
• 암시적: P2P 동기화. 동기화를 켜면 동기화 그룹의 모든 기기가 사실상 볼트의 실시간 사본이 됩니다. 두 번째 기기를 페어링하면 각 기기가 모든 데이터를 보유하므로, 하나를 잃어버리거나 초기화해도 다른 기기에 데이터가 남아 있습니다. 내보낼 파일을 기억할 필요 없는 가장 간단한 안전망입니다.
• 자동: 예약 클라우드 백업(브라우저 확장 프로그램 및 데스크톱 앱). 이미 사용 중인 저장소를 Bramble에 지정하면 선택한 일정에 따라 암호화된 백업을 그곳에 저장합니다. Dropbox에 한 번의 클릭으로 로그인하거나(현재 확장 프로그램 전용), S3 호환 버킷(Backblaze B2, Cloudflare R2, Storj, Wasabi, MinIO 등)을 사용하거나, 자체 셀프 호스팅 WebDAV 서버(Nextcloud, ownCloud, Fastmail 등)를 지정할 수 있습니다. 각각 고유한 주기(매일, 매주, 매월)로 원하는 만큼 대상을 추가하거나, 언제든 지금 백업 버튼을 누르세요. 암호문만 기기를 떠나므로 제공업체는 읽을 수 없는 데이터를 보관하며, 도난당한 백업도 열려면 여전히 마스터 비밀번호가 필요합니다. Bramble은 가장 최근 스냅샷을 유지하고 나머지는 정리합니다. 데스크톱 앱은 볼트가 잠긴 상태에서도 일정을 유지할 수 있는데, 이미 트레이에 상주해 있기 때문입니다. 새 기기나 초기화된 기기에 백업을 복원하는 것은 확장 프로그램, 데스크톱 앱, 모바일 앱 모두에서 가능합니다.

동기화된 두 번째 기기와 가끔씩의 내보내기가 합쳐지면 기기를 잃어버리거나 고장 나더라도 볼트를 잃을 일이 없습니다.

휴대폰에서

모바일 앱은 Bramble의 Rust 암호화 코어와 볼트 형식을 재사용하며, 그 위에 네이티브 OS 자동 완성을 얹었습니다:

• 시스템 AutoFill. Bramble은 네이티브 OS 자격 증명 제공자로 등록되므로 로그인 정보와 일회용 코드가 앱과 브라우저 전반의 키보드 및 자동 완성 바에 표시됩니다.
• 패스키. 패스키를 생성하고 로그인할 수 있으며, 일반 볼트 항목으로 저장되어 다른 모든 데이터와 함께 기기 간에 동기화됩니다.
• 생체 인식 잠금 해제. OS 키스토어로 보호되는 Face ID, Touch ID 또는 Android 생체 인식으로 잠금을 해제하거나, 마스터 비밀번호 또는 복구 코드로 대체할 수 있습니다.
• 기기 내 저장. 볼트는 OS가 삭제할 수 있는 웹뷰 데이터베이스가 아닌, 네이티브 파일시스템에 저장 시 암호화된 상태로 보관됩니다.
• P2P 동기화. 휴대폰을 다른 기기와 페어링하면 볼트가 데이터를 보관하는 중계 서버 없이 기기 간에 직접 동기화됩니다.

iOS 및 Android 앱은 확장 프로그램과 별개로 버전 관리되고 릴리스됩니다.

데스크톱에서

macOS 및 Linux용 네이티브 앱으로, 겉치레 브라우저 탭이 아닙니다. Tauri로 구축되어 UI는 다른 곳과 동일한 React를 사용하지만 볼트와 모든 암호화 작업은 Rust 프로세스에 있습니다. Vault Key는 웹뷰에 전혀 들어가지 않습니다.

• 다른 모든 것 위의 빠른 접근. Cmd+Shift+Space(macOS 외에서는 Ctrl+Shift+Space)를 누르면 하던 일 위에 검색 바가 나타납니다. 로그인을 찾아 비밀번호를 복사하고, 브라우저에 채우거나, 앱에서 연 다음 다시 방해하지 않습니다.
• 브라우저를 채워 줍니다. 앱을 Bramble 확장 프로그램과 한 번 페어링하면 패널이 기기를 떠나지 않는 암호화 채널을 통해 앞에 있는 페이지를 채워 줍니다. 페어링은 확장 프로그램에 추가 기능만 더할 뿐이며, 확장 프로그램은 앱 설치가 필요 없는 독립형으로 유지됩니다.
• 상시 동기화 허브. P2P 동기화는 두 기기가 동시에 깨어 있어야 하는데, 휴대폰 두 대가 동시에 깨어 있는 경우는 드뭅니다. 컴퓨터는 보통 그렇습니다. 앱을 트레이에 남겨 두면 다른 기기가 깨어날 때마다 동기화할 대상을 갖게 됩니다.
• 볼트가 잠긴 상태에서도 실행되는 백업. S3 호환 버킷이나 자체 WebDAV 서버를 지정하면 그날 잠금을 해제했는지와 무관하게 예약에 따라 암호화된 백업을 업로드합니다. 해당 자격 증명은 볼트가 아닌 OS 자격 증명 저장소에 있으므로 잠긴 볼트도 백업할 수 있습니다.
• 디스크의 볼트 파일. 조용히 삭제될 수 있는 브라우저 데이터베이스가 아닌, 이전 사본의 스냅샷을 옆에 유지하며 원자적으로 기록되는 일반 파일입니다.

다른 모든 것을 설치하는 방식 그대로 설치하세요. macOS에서는 서명되고 공증된 .dmg 또는 brew install --cask bramble, Linux에서는 APT 저장소, AppImage, .deb 및 .rpm 패키지, 또는 Nix flake를 사용합니다. 디스크 이미지와 AppImage는 스스로 업데이트되며, 패키지 관리자 경로는 시스템의 나머지와 함께 업데이트됩니다.

아직 할 수 없는 것도 있으며, 조용히 실패하는 대신 명확히 알려 줍니다: Touch ID 잠금 해제, 패스키, KeePass 가져오기 및 내보내기, 네이티브 앱 자동 입력, 볼트에 이미 저장된 SSH 키용 SSH 에이전트. Windows 빌드도 없으며, 현재로서는 브라우저 확장 프로그램이 그 해답입니다.

기능

• 항상 로컬 우선. 볼트는 자신의 기기에 암호화되어 저장됩니다(확장 프로그램의 브라우저 비공개 저장소, 데스크톱 앱의 디스크 파일, 모바일의 앱 전용 저장소). 서버에는 절대 저장되지 않습니다.
• 암호화에 타협 없음. 키에는 Argon2id, 데이터에는 AES-256-GCM, 모든 항목이 고유한 키를 갖는 봉투 암호화를 사용합니다. 비밀은 사용 후 메모리에서 삭제됩니다.
• 모든 것이 암호화됩니다. 사이트 이름, 사용자 이름, 메모 등 전부. 저장된 볼트에서 읽을 수 있는 유일한 부분은 헤더뿐입니다.
• 어디서나 스마트 자동 완성. www.ikea.com, ca.accounts.ikea.com, ikea.com 모두 동일한 로그인과 매칭됩니다. 하나의 항목, 여러 URL. 브라우저에서는 iframe과 shadow DOM 내부의 양식에 도달하는 페이지 내 드롭다운이며, 모바일에서는 앱과 브라우저 전반의 OS 자동 완성 바, 데스크톱 앱에서는 페어링된 확장 프로그램을 통해 브라우저를 채우는 빠른 접근 패널입니다.
• 패스키. Bramble은 당신만의 WebAuthn 인증기입니다. 확장 프로그램과 두 모바일 앱에서 패스키를 생성하고 로그인할 수 있습니다. 패스키는 볼트 항목으로 저장되므로 공급업체 클라우드 없이 기기 간에 동기화됩니다.
• 로그인 그 이상. 로그인, 결제 카드, 보안 메모, SSH 키를 각각 고유한 필드와 함께 지원합니다.
• 암호화된 백업. 직접 손에 쥐고 싶은 사본이 필요할 때마다 전체 볼트를 암호화된 .bramble 파일로 내보낼 수 있습니다. 열려면 여전히 마스터 비밀번호가 필요합니다.
• KeePass로 내보내기(브라우저 확장 프로그램). 볼트를 파일용으로 선택한 비밀번호 아래 표준 .kdbx(KDBX4)로 저장하고 KeePassXC 또는 다른 KeePass 앱에서 열 수 있습니다. 잠금 없음: 나가는 문도 들어가는 문만큼 쉽습니다.
• 예약 클라우드 백업. 설정 후 잊어버려도 되는 암호화 백업을 Dropbox(원클릭, 확장 프로그램 전용), S3 호환 버킷, 또는 셀프 호스팅 WebDAV에 선택한 주기로 저장합니다. 암호문만 전송되므로 제공업체는 아무것도 읽을 수 없습니다. 브라우저 확장 프로그램과 데스크톱 앱 모두 지원하며, 데스크톱 앱은 볼트가 잠긴 상태에서도 일정을 유지합니다.
• 내장 비밀번호 생성기. 강력한 비밀번호를 한 번에 생성합니다.
• 원하는 방식으로 잠금 해제. 마스터 비밀번호, 하드웨어 키(YubiKey, Touch ID, WebAuthn PRF를 통한 Windows Hello, 브라우저 확장 프로그램), 모바일 생체 인식, 또는 복구 코드. 비밀번호와 함께 사용하거나, 비밀번호를 끄고 하나만 유일한 방법으로 만들 수도 있습니다.
• 복구 코드. 모든 볼트는 설정 시 고엔트로피 복구 코드를 받습니다. 마스터 비밀번호와 독립적으로 볼트를 잠금 해제하는 인쇄 가능한 백업입니다. 한 번만 표시되고, 오프라인으로 보관되며, 평문으로 절대 저장되지 않습니다. 언제든 재설정할 수 있습니다.
• TOTP / 2FA 코드. otpauth:// URI 또는 원시 시크릿을 붙여넣으면 Bramble이 여섯 자리 코드를 생성합니다.

클라우드 관리자보다 나은 이유

클라우드 업체들은 모든 사용자의 볼트를 자체 서버에 보관하며, 이는 하나의 거대한 표적이 됩니다. 해킹당하면 당신의 볼트만 유출되는 것이 아니라 수백만 개가 한꺼번에 유출되며, 몇 달 후 블로그 게시물로야 알게 됩니다. LastPass와 Dashlane, 바로 당신들입니다 👀

Bramble은 이를 뒤집습니다:

• 해킹당할 서버가 없습니다. 볼트는 결코 당신의 통제를 벗어나지 않습니다. 누군가 노릴 중앙 데이터 더미가 없습니다.
• 계정도, 구독도, 텔레메트리도 없습니다. 가입할 것도, 정보를 빼가는 것도 없습니다.
• 데이터는 당신의 것입니다. 기기에 저장되고, 기기 간에 직접 동기화되며, 오프라인 사본이 필요할 때마다 암호화된 파일로 내보낼 수 있습니다. 원한다면 인터넷에서 완전히 분리해 두세요. 당신의 선택입니다.
• 클라우드 없는 클라우드 같은 편의성. 동기화는 클라우드 관리자처럼 모든 기기를 자동으로 최신 상태로 유지하지만, 볼트는 종단 간 암호화 링크를 통해 기기 간에 직접 이동합니다. 중앙 허니팟도, 중간에 끼어드는 회사도 없습니다.
• 코드만 신뢰하면 됩니다. 암호화는 공개되어 있으며 전적으로 당신의 기기에서 실행됩니다. 서버가 "데이터를 읽을 수 없다"는 누군가의 말을 믿을 필요가 없습니다.

절충점은 실재하며 솔직히 인정할 가치가 있습니다. 어딘가 서버에 "비밀번호를 잊었습니다" 버튼이 없습니다. 하지만 안전망이 없는 것은 아닙니다. 모든 볼트는 복구 코드를 받으며, 하드웨어 키를 또 다른 방법으로 등록할 수 있습니다. 복구 코드를 저장하고, 두 번째 기기를 동기화 상태로 유지하며, 가끔 백업을 내보내세요. 모든 방법(비밀번호, 키, 복구 코드)을 전부 잃으면 볼트도 사라집니다. 다른 누구도 사본을 보관하지 않기 때문입니다.

암호화 작동 방식

Bramble은 LUKS 스타일 키 슬롯과 봉투 암호화를 사용합니다. 데이터를 실제로 보호하는 무작위 Vault Key(VEK) 가 하나 있습니다. 각 잠금 해제 방법(마스터 비밀번호, 보안 키, 생체 인식 또는 복구 코드)은 고유한 Key-Encryption Key(KEK) 를 파생하여 동일한 Vault Key의 사본을 풀므로, 잠금 해제 방법을 추가하거나 폐기해도 단일 항목을 다시 암호화할 필요가 없습니다. 그런 다음 Vault Key는 모든 항목에 대해 새로운 항목별 키를 풀고, 그 키가 항목 자체를 복호화합니다. 모든 것은 AES-256-GCM이며, 전부 동일한 Rust 코어(브라우저에서는 WebAssembly로, 모바일에서는 네이티브 라이브러리로 컴파일) 내부에서 실행됩니다.```mermaid flowchart TD subgraph unlock["Unlock (any one of these)"] PW["Master password"] SK["Security key
(WebAuthn PRF)"] RC["Recovery code"] end

PW -->|"Argon2id"| KEK["Key-Encryption Key (KEK)<br/>32 bytes, never stored"]
SK -->|"HKDF-SHA256"| KEK
RC -->|"Argon2id"| KEK

subgraph slots["Key slots (in the vault)"]
    S["wrapped Vault Key<br/>per slot"]
end

KEK -->|"AES-256-GCM unwrap"| VEK["Vault Key (VEK)<br/>random, protects everything"]
S -.->|"one slot per unlock method"| VEK

VEK -->|"decrypt entries blob"| ENTRIES["Encrypted entries"]
VEK -->|"AES-256-GCM unwrap"| DEK["Per-entry key (DEK)<br/>fresh & random per save"]
DEK -->|"AES-256-GCM decrypt"| DATA["Entry data<br/>(passwords, notes, cards, keys)"]

마스터 비밀번호는 암호화 코어 내부에서 키를 파생하는 데에만 사용되며, KEK와 복호화된 키는 사용 후 메모리에서 삭제됩니다. 저장 시에는 볼트 헤더만 읽을 수 있고, 그 외의 모든 것은 암호문입니다.

## KeePass와의 비교

KeePass를 좋아한다면 바로 익숙해질 것입니다. 암호화된 데이터베이스, 완전한 통제권, 클라우드 중개자 없음. Bramble은 KDBX4 파일도 가져올 수 있습니다. 차이점은 다음과 같습니다.

- **🌐 사용자가 있는 곳에서 만납니다.** 브라우저 확장 프로그램, 데스크톱 앱, 네이티브 iOS 및 Android 앱이 모두 하나의 볼트에서 동작합니다. 데스크톱 프로그램과 브라우저를 연결할 플러그인 브리지가 필요 없고, 휴대폰에서 자동 완성을 작동시키기 위해 애쓸 필요도 없습니다.
- **자동 완성이 그냥 작동합니다.** 브라우저에서는 도메인 매칭과 페이지 내 드롭다운이 제공되고, 모바일에서는 시스템 자동 완성과 패스키가 기본 내장되어 있어 별도로 덧붙인 것이 아닙니다.
- **플러그인과 포크의 난립 대신 하나의 확고한 현대적 빌드.** Argon2id와 AES-256-GCM이 기본 제공됩니다.
- **현대적인 UI.** KeePass는 2003년에서 도망쳐 나온 것처럼 보입니다(나쁜 뜻은 아닙니다). Bramble은 깔끔하고 빠르며, 다크 모드와 눈이 아프지 않은 레이아웃을 갖추고 있습니다.

KeePass의 철학에 브라우저 네이티브 및 모바일 네이티브의 겉옷을 입히고, 매끄럽게 작동하는 자동 완성을 더한 것입니다.

## AI 사용 고지

Bramble의 일부는 AI 지원(Claude Opus)으로 작성되었지만, 모든 줄은 10년 이상의 경력을 가진 소프트웨어 엔지니어가 지시하고 검토하고 다듬었으며, 특히 보안에 중요한 부분이 그렇습니다. AI는 빠른 타이피스트였지 설계자가 아니었습니다. 코드베이스는 자동 및 수동으로 철저히 테스트되었습니다. 보안 소프트웨어에서 "작동하는 것 같다"는 충분하지 않기 때문입니다.

## 향후 계획

- **모바일 클라우드 백업.** 브라우저 확장 프로그램과 데스크톱 앱은 현재 일정에 따라 클라우드 저장소에 백업합니다. 이러한 예약 업로드를 iOS 및 Android 앱에도 도입하는 것이 다음 단계입니다(모바일은 이미 백업 파일에서 복원할 수 있습니다).
- **Windows.** 데스크톱 앱은 macOS와 Linux용으로 출시됩니다. Windows는 아직 빌드되지 않은 플랫폼입니다.
- **데스크톱 앱에서 더 많은 곳에 입력.** 네이티브 앱에 자동 입력(auto-type)을 지원하여 빠른 접근 패널이 브라우저가 아닌 창에도 도달할 수 있게 하고, 볼트가 이미 보유한 SSH 키를 제공하는 SSH 에이전트도 추가합니다.

## 기여

오픈 소스이며 기여를 환영합니다. [CONTRIBUTING.md](https://github.com/flythenimbus/bramble/blob/main/CONTRIBUTING.md)에 설정 단계, 코딩 표준, CI 요구 사항이 있습니다. 미리 알아두면 좋은 몇 가지 사항:

- **큰 변경은 먼저 이슈를 여세요.** 버그 보고와 작은 수정은 바로 PR로 보내도 됩니다. 트래커는 [github.com/flythenimbus/bramble/issues](https://github.com/flythenimbus/bramble/issues)에 있습니다.
- **보안 소프트웨어에는 더 높은 기준이 적용됩니다.** 변경 사항에는 테스트가 포함될 것으로 예상하며, 암호화 및 볼트 형식 경로는 특히 더 면밀한 검토를 받습니다.
- **보안 문제를 발견했나요?** 공개 트래커에 올리지 마세요. [GitHub Security Advisories](https://github.com/flythenimbus/bramble/security/advisories) 또는 이메일을 통해 비공개로 신고하여 공개되기 전에 수정될 수 있게 해주세요. 자세한 내용은 [SECURITY.md](https://github.com/flythenimbus/bramble/blob/main/SECURITY.md)를 참조하세요.

실제 사이트 자동 완성 픽스처나 가져오기 형식 커버리지를 추가하는 PR은 특히 유용합니다.

## 지원

Bramble은 무료이며 오픈 소스입니다. 유용하게 사용하셨다면 팁은 큰 도움이 됩니다. 💜 지갑으로 코드를 스캔하거나 아래 주소를 복사하세요.

| Monero (XMR) | Bitcoin · Lightning | Bitcoin · on-chain |
|:---:|:---:|:---:|
| <img src="https://assets.kitploit.com/production/public/readmes/9122/98a87da3dd96c4dfff684cf1f00c302af2ad52847c7e83a7211df45331f0585b.png" alt="Monero donation QR code" width="200" /> | <img src="https://assets.kitploit.com/production/public/readmes/9122/863a4b5ebc384842e2b7c667e8a3ef56a5260b36d293fa8ee0c99078a21fa665.png" alt="Bitcoin Lightning donation QR code" width="200" /> | <img src="https://assets.kitploit.com/production/public/readmes/9122/d51c08ee321db0ce69f7498087bff37fdc3027aabcac757dc8fc9e368a361cdc.png" alt="Bitcoin on-chain donation QR code" width="200" /> |

**Monero (XMR)**```
4AC3txuTwFm4fkamoYeK47c9EpnPwbreHNxJeKDYHiDNN6weD5vVA4BCH1azQhSxa6JjereuVpt21Pu2MyRDFDNNH6KGnWq

비트코인 · 라이트닝``` [email protected]

**Bitcoin · 온체인**```
bc1q78sd5rnuufqdtv9plp0p56hrq72c9unj8tec8t

License

Bramble은 자유 소프트웨어로, GNU General Public License v3.0에 따라 배포됩니다. 전체 전문은 LICENSE 파일을 참조하세요. 간단히 말하면: 사용하고, 연구하고, 포크하고, 공유할 수 있습니다. 수정된 버전을 배포하는 경우, 동일한 자유를 함께 전달하고 소스 코드도 GPLv3에 따라 공개해야 합니다.