macOS 또는 Windows용 Chrome/Firefox QubKey 확장 프로그램을 다운로드하여 설치하세요. 사용 전 해당 데스크톱 앱과 Native Messaging을 구성해야 합니다.
운영 체제 선택
QubKey 데스크톱 앱에 맞는 패키지를 선택하세요. macOS와 Windows 빌드는 약간 다르며 서로 호환되지 않습니다.
릴리스 1.0.0 — 위에서 macOS 또는 Windows를 선택한 뒤 해당 플랫폼용 Chrome (.zip) 또는 Firefox (.xpi) 패키지를 다운로드하세요.
Chrome .zip SHA-256(설치 전 다운로드 확인)
91e6df76ae5cefd3e925d88bb6f25f1cb761023d9edfd83eed9fe0d306bcdffeFirefox .xpi SHA-256(설치 전 다운로드 확인)
af7606d8543dbb6142ba9c395e3241908ddbc5c1ffcf56ee673416c0c87837afChrome: .zip은 압축 파일일 뿐입니다. 루트에 manifest.json이 있는 폴더로 풀고 chrome://extensions에서 개발자 모드를 켠 뒤 «압축해제된 확장 프로그램을 로드합니다»를 사용하세요. Chrome은 zip 더블 클릭으로 설치하지 않습니다.
Firefox: .xpi는 AMO 업로드나 특정 로컬 설치용입니다. Firefox Release는 보통 Mozilla 서명 빌드(addons.mozilla.org)가 필요합니다.
확장 프로그램은 Native Messaging으로 QubKey 데스크톱 앱과 통신합니다. 데스크톱 프로젝트의 Native Messaging 문서에 따라 네이티브 호스트(JSON 매니페스트, 바이너리, 경로)를 설정하세요.
macOS(Apple Silicon)용 QubKey 데스크톱 앱을 Download & installation guide에서 설치하고 실행하세요. 테스트 중에는 vault 잠금을 해제하세요.
macOS에서는 com.passmanager.native.json을 ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/에 설치합니다(Firefox, Edge, Opera도 동일). path는 QubKey.app 내 네이티브 헬퍼로 설정합니다.
수동 로드 후 브라우저에 표시된 확장 프로그램 ID를 문서에 설명된 대로 com.passmanager.native.json 호스트 매니페스트에 복사하세요.
macOS에서 Chrome, Brave 등 Chromium 브라우저는 동일한 절차입니다. Mac의 Microsoft Edge는 edge://extensions에서 같은 압축 해제 폴더를 사용합니다.
addons.mozilla.org(AMO) 게시 후 사용자는 about:debugging 없이 한 번의 클릭으로 설치합니다. API 액세스를 설정한 뒤 .xpi는 AMO용 패키지(또는 빌드 아티팩트)입니다.
macOS: about:addons → 톱니바퀴 → 파일에서 부가 기능 설치에서 passmanager-firefox-1.0.0.xpi 선택. Nightly/Developer Edition 또는 서명 검사 비활성화 시에만 가능.
macOS 베타: passmanager-firefox-1.0.0.xpi를 .zip으로 바꿔 풀고 about:debugging → 이 Firefox → 임시 부가 기능 로드에서 manifest.json 선택. Firefox 재시작마다 다시 로드.