자주 묻는 질문

QubKey란 무엇이며 어떻게 작동하나요?

QubKey는 local-first 오픈소스 비밀번호 관리자입니다. 비밀은 기기의 암호화된 .rkvey 금고 파일에 저장됩니다. 데스크톱 앱(Rust + Tauri + React)이 마스터 비밀번호로 데이터를 암호화·복호화합니다. QubKey는 마스터 비밀번호를 저장하지 않으며 없이는 금고에 접근할 수 없습니다. 20가지 항목 유형을 검색·정리·관리하고, 비밀번호를 생성하며, TOTP를 사용하고, 선택적으로 자신의 기기 간 동기화할 수 있습니다.

어떤 플랫폼이 지원되나요?

QubKey 2.0.0 데스크톱 앱은 macOS(Apple Silicon, DMG 설치 프로그램)와 Windows 10/11 (1.0.2)(NSIS 및 MSI 설치 프로그램, x64 및 x86)에서 사용할 수 있습니다. Linux는 활발히 개발 중입니다. Tauri 기반이며 macOS에서는 Keychain, Windows에서는 Credential Manager 등 OS별 통합을 제공합니다. 브라우저 확장이 제공됩니다. 각 플랫폼마다 전용 확장 패키지가 있으며 macOS와 Windows 빌드는 호환되지 않습니다.

데이터가 클라우드에 저장되나요?

기본적으로 아니요. QubKey는 local-first로 모든 데이터가 암호화된 .rkvey 파일로 기기에 남습니다. 완전한 제어를 유지하며 클라우드 서비스 없이 금고 파일을 백업·이동·복사할 수 있습니다. 원하면 자신의 기기 간 선택적 클라우드 동기화를 활성화할 수 있으며, 사용자 제어하에 유지되고 앱의 local-first 설계는 변하지 않습니다.

암호화는 어떻게 작동하나요?

QubKey는 인증 암호화(AEAD)를 사용합니다. AES-256-GCM이 기본 알고리즘이며 XChaCha20-Poly1305가 대안으로 제공됩니다. 마스터 비밀번호는 brute-force 공격에 강한 memory-hard 키 유도 함수 Argon2id로 처리됩니다. 각 항목은 고유 nonce로 암호화됩니다. 금고 잠금 시 또는 사용 후 민감 데이터는 메모리에서 삭제됩니다(zeroization). Auto-lock은 비활성 기간 후 추가로 보호합니다.

.rkvey 형식은 안전한가요?

예. .rkvey v4는 QubKey의 암호화 금고 파일 형식입니다. 식별용 암호학적 RKVE 서명, 항목 내용 복호화 없이 빠른 검색을 위한 암호화 인덱스, 충돌 복구용 Write-Ahead Log(WAL), 기록·공유 메타데이터·통계의 암호화 저장을 포함합니다. 전체 파일은 마스터 비밀번호로 암호화된 상태를 유지합니다.

QubKey 브라우저 확장은 어떻게 작동하나요?

Chrome과 Firefox 확장은 Native Messaging을 통해 QubKey 데스크톱 앱에 연결됩니다. 이는 컴퓨터의 안전한 로컬 채널입니다. 확장은 금고를 저장하지 않으며 자격 증명을 클라우드로 보내지 않습니다. 데스크톱 앱에서 금고가 잠금 해제되면 확장이 로그인 양식을 자동 완성하고 실시간으로 동기화됩니다. 각 OS마다 전용 확장 패키지가 있으며 macOS와 Windows 빌드는 호환되지 않습니다.

브라우저 확장은 어떻게 설정하나요?

확장 사용: (1) OS용 QubKey 데스크톱 앱 설치, (2) 금고 잠금 해제, (3) 해당 브라우저 확장(Chrome 또는 Firefox) 설치, (4) Native Messaging을 구성해 확장과 데스크톱 앱이 통신하도록 합니다. 패키지는 플랫폼별입니다. Mac에서는 macOS 빌드, Windows에서는 Windows 빌드를 사용하세요. 전체 단계별 안내는 /browser-extensions의 브라우저 확장 페이지에서 확인할 수 있습니다.

QubKey는 오픈소스인가요?

예. QubKey는 MIT 라이선스로 공개됩니다. 소스 코드(Rust 백엔드, Tauri 브리지, React + TypeScript 인터페이스)는 공개되어 누구나 감사할 수 있습니다. 표준 암호 알고리즘이 사용되며 .rkvey 형식도 투명성을 위해 문서화되어 있습니다.

QubKey는 무료인가요?

예. QubKey는 MIT 라이선스 하에 무료 오픈소스입니다. 제한 없이 사용·수정·배포할 수 있습니다. 소스 코드는 감사 및 커뮤니티 기여를 위해 접근 가능합니다.

다른 관리자에서 비밀번호를 가져올 수 있나요?

예. QubKey는 CSV, JSON, XML, HTML 표준 형식 가져오기를 지원합니다. KeePass, Bitwarden, 1Password보내기와 호환됩니다. 가져오기 전 데이터를 미리 보고 새 항목 추가 또는 전체 금고 교체를 선택할 수 있습니다. 마이그레이션을 돕는 템플릿이 제공됩니다.

지원되는 항목 유형은?

QubKey는 6개 카테고리에 20가지 항목 유형을 지원합니다: 비밀번호 및 키(Password, SSHKey, PGPKey, TokenLogin, Passkey, RecoveryCodes), 금융(CreditCard, BankAccount, CryptoWallet), 신원(NationalID, Passport, DriverLicense, HealthID, Profile, ContactAddress), 메모(Note, RecoveryPhrase, ConfigSnippet), 문서(Document), 기기 접근(WiFi). 각 유형에는 전용 필드가 있습니다.

이중 인증(2FA/TOTP)은 어떻게 작동하나요?

QubKey에는 RFC 6238 준수 TOTP 코드 생성기가 포함됩니다. QR 스캔 또는 수동 입력으로 Password 항목에 TOTP 비밀을 추가합니다. 생성기는 SHA1, SHA256, SHA512, 6자리 또는 8자리 코드, 설정 가능한 주기(기본 30초)를 지원합니다. 코드는 시각적 타이머와 함께 표시되며 자동 클립보드 삭제와 함께 복사할 수 있습니다. TOTP 비밀은 금고에 암호화되어 저장됩니다.

보안 대시보드란 무엇이며 어떻게 사용하나요?

보안 대시보드는 금고 상태 개요를 제공합니다. 비밀번호 강도, 재사용, 경과 시간, 2FA 적용률을 기반으로 전체 보안 점수(0–100)를 표시합니다. 실시간 지표에는 재사용률, 평균 강도, 실행 가능한 권장 사항이 포함됩니다. 권장 사항을 클릭하면 관련 항목으로 이동합니다.

기록과 버전 관리는 어떻게 작동하나요?

QubKey는 항목의 모든 변경을 기록합니다. 생성, 업데이트, 삭제, 복원마다 암호화된 스냅샷이 생성됩니다. 대화형 타임라인에서 버전을 탐색하고 두 버전을 나란히 비교하며 필요 시 이전 상태를 복원할 수 있습니다. 복원 자체도 새 버전으로 기록됩니다.

항목을 안전하게 공유할 수 있나요?

네. 볼트 항목에서 임시 암호화 링크(기간, 최대 조회, 선택 비밀번호)를 만들거나 다른 QubKey 계정으로 보낼 수 있습니다. 피어 공유는 X25519와 AES-256-GCM을 사용하며 수신자는 받은편지함에서 수락/거절합니다. 권한(읽기, 수정, 복제, 임시 링크, 전달)을 선택하고 철회할 수 있습니다. 선택 첨부파일도 종단간 암호화 상태를 유지합니다.

비밀번호 생성기는 어떻게 작동하나요?

비밀번호 길이와 문자 집합(소문자, 대문자, 숫자, 기호)을 구성합니다. 강도 표시기가 점수, 엔트로피 추정, 개선 팁을 보여줍니다. 안전한 wordlist에서 기억하기 쉬운 암호문구나 PIN도 생성할 수 있습니다. 생성된 값은 설정 가능한 시간 후 자동 클립보드 삭제와 함께 복사할 수 있습니다.

마스터 비밀번호를 잊으면 어떻게 되나요?

마스터 비밀번호는 금고 복호화 키를 유도합니다. 잊으면 데이터를 복구할 수 없습니다. 설계상 QubKey에는 backdoor가 없습니다. 강력하고 기억하기 쉬운 비밀번호를 선택하고, 안전한 곳에 백업을 보관하며, .rkvey 파일의 정기 복사본을 유지해 보호하세요. 백업이 올바르게 열리는지 주기적으로 확인하세요.

Auto-lock과 보안 클립보드는 어떻게 작동하나요?

Auto-lock은 설정 가능한 비활성 기간(기본 5분) 후 금고를 보호합니다. 잠금 시 모든 민감 데이터가 메모리에서 삭제됩니다(zeroization). 언제든 수동 잠금도 가능합니다. 보안 클립보드는 복사한 비밀번호나 TOTP 코드를 설정 가능한 시간 후 자동 삭제하며, 앱이 닫혀 있어도 동작합니다.