기능
네이티브 메시징
확장 → 기본 호스트 → QubKey 앱 브리지 — macOS 및 Windows 설정.
네이티브 메시징은 브라우저 확장 프로그램과 QubKey 데스크톱 앱 사이의 로컬 채널입니다. 그렇지 않으면 확장 프로그램이 자격 증명을 채울 수 없습니다.
흐름: 확장 → 호스트 매니페스트 com.passmanager.native.json → 기본 프로세스 → QubKey IPC → 잠금 해제된 저장소.
호스트 매니페스트 설치
- /ko/browser-extensions에서 macOS 확장 패키지를 다운로드합니다.
- 다음 위치에
com.passmanager.native.json을 설치합니다.~/Library/Application Support/Google/Chrome/NativeMessagingHosts/(Firefox, Edge, Opera에 해당하는 폴더) - JSON에서
path은 내부QubKey.app의 기본 바이너리를 가리킵니다. - 확장 프로그램을 로드한 후프라우져에 확장 ID를 매니페스트
allowed_origins필드에 복사하세요.
- /ko/browser-extensions에서 Windows 패키지를 다운로드합니다.
com.passmanager.native.json을(를) 쏘오려면:%LOCALAPPDATA%\Google\Chrome\User Data\NativeMessagingHosts\Firefox의 경우:%APPDATA%\Mozilla\NativeMessagingHosts\- QubKey 설치에서
path→passmanager-native.exe - 확장 ID를 호스트 매니페스트에 복사합니다.
연결 확인
QubKey를 실행하고 금고잠금 휴가**
→ 확장 — 변경되는 경우 기본 대화 설정 활성화(설정 안내)
상태는 연결됨(IPC 서비스 활동 + 축소됨)으로 표시됩니다.
Vault에 저장된 사이트에 자동 로그인을 테스트해 보세요.
문제 해결
Host not found
매니페스트 경로를 확인하고 com.passmanager.native.json이 유효한 JSON인지 확인하세요.
Wrong extension ID
개발자 모드에서 확장 프로그램을 다시 로드하면 ID가 변경됩니다(allowed_origins를 업데이트하세요).
Wrong OS package
macOS 및 Windows 확장 빌드는 서로 바꿔 사용할 수 없습니다.
다음
전체 확장 설치(Chrome, Firefox): 브라우저 확장. 다운로드 페이지: /ko/browser-extensions.