UKey Wallet Getting Started
UKey 하드웨어 지갑에 오신 것을 환영합니다. 귀하의 디지털 자산 관리 환경이 보안 요구 사항을 충족하는지 확인하려면그리고 UKey 하드웨어 기기와 단말기 간의 안정적인 통신을 위해 클라이언트 배포 전 아래의 공식 환경 호환성 요구 사항을 확인해 주시기 바랍니다.
1. 데스크탑 운영 환경
UKey Wallet 데스크톱 클라이언트는 기본적으로 여러 플랫폼을 지원합니다. 운영 체제가 다음 최소 버전 요구 사항을 충족하는지 확인하세요.
운영 체제 | 최소 시스템 요구 사항 | 권장 시스템 요구사항 | 아키텍처 설명 |
macOS | 10.15 Catalina | 13 Ventura 이상 | Intel 및 Apple Silicon(M1/M2/M3) 칩과 기본적으로 호환됩니다. |
Windows | Windows 10(버전 1809) | Windows 11 | 표준 x86/x64 아키텍처 프로세서 사용을 권장합니다. |
Linux | Ubuntu 18.04 / Debian 10 / Fedora 32 / RHEL 8 | Ubuntu 22.04 LTS 이상 | 주요 배포판과 호환 가능 |
2. 이동단말기 운용환경
운영 체제 | 최소 시스템 요구 사항 | 권장 시스템 요구사항 |
iOS / iPadOS | iOS 15.5 | iOS 17 이상 |
Android | Android 7.0 | Android 13 이상 |
UKey 공식 보안 정책 성명:
기본 시스템 권한이 남용되어 중요한 데이터(예: 개인 키 캐시)가 유출되는 것을 방지하기 위해 UKey Wallet 에서는 엄격한 실행 환경 감지를 수행합니다.이 애플리케이션은 탈옥된 iOS 장치 또는 루팅된 Android 장치에서 실행이 금지됩니다. 강제 실행을 시도하면 보안 잠금 메커니즘이 트리거될 수 있습니다.또는 애플리케이션이 비정상적으로 종료될 수 있습니다.
3. 브라우저 확장 및 WebUSB 하드웨어 통신 지원
UKey 웹페이지나 브라우저 확장을 통해 DApp과 상호작용할 때,하드웨어는 안전한 HTTPS 직접 데이터 채널을 설정하기 위해 브라우저의 WebUSB API에 의존해야 합니다.주요 브라우저 제조업체는 기본 API에 대해 서로 다른 지원 전략을 가지고 있으므로 다음 호환성 매트릭스를 참조하십시오.
3.1 공식적으로 권장 및 지원되는 브라우저(Chromium 커널)
Google Chrome：완전히 지원됨(버전 61 이상)
Microsoft Edge：완전히 지원됨(버전 79 이상)
공식 조언:최신 보안 패치를 받으려면 항상 브라우저를 최신 버전으로 업데이트하세요.
3.2 지원되지 않는 브라우저(하드웨어 API 호출 불가)
커널 제한으로 인해 다음 브라우저에서는 UKey 하드웨어 장치를 인식하고 연결할 수 없습니다. 하드웨어 상호 작용에는 사용하지 마십시오.
Firefox
Safari
Opera
Samsung Internet
QQ Browser
Internet Explorer (IE)
UC Browser（⚠️ 알려진 위험:UC Browser 환경에서 하드웨어 인터페이스를 호출하면 브라우저 프로세스가 비정상적으로 중단될 수 있습니다. )
3.3 모바일 웹 상호작용의 한계
Android 환경:WebUSB 하드웨어 통신은 Android에서 Chromium 커널 브라우저(모바일 Chrome/Edge 등)를 이용하여 정상적으로 수행할 수 있습니다.
iOS 환경(제한됨):Apple 공식 기본 보안 정책에 의해 제한되며,Chrome 및 iOS용 Edge를 포함하여 iOS 플랫폼의 모든 웹 브라우저는 WebUSB 인터페이스를 지원하지 않습니다.자산 관리 및 거래 서명이 필요한 iOS 사용자는 공식 UKey 앱을 직접 사용해야 합니다.iOS 모바일 브라우저를 통해 하드웨어 연결을 시도하지 마세요.
4. 물리적 인터페이스 및 장치 통신 사양
하드웨어 장치가 클라이언트에게 암호화 서명 명령을 안정적이고 안전하게 전송할 수 있도록 하려면 다음과 같은 물리적 연결 조건을 확인하십시오.
유선 연결:장치와 함께 제공된 원래 USB-A 또는 USB-C 데이터 케이블을 사용하여 컴퓨터 마더보드 포트에 직접 연결하십시오.불안정한 전원 전압이나 신호 감쇠로 인한 데이터 패킷 손실을 방지하기 위해 타사의 저품질 USB 허브나 도크를 사용하지 않는 것이 좋습니다.
모바일 통신:
직접 유선 연결:시스템 설정에서 Android 휴대폰을 활성화해야 합니다. OTG 데이터 전송기능.
무선 연결:모바일 기기에서 블루투스가 활성화되어 있는지, UKey 앱에 필요한 블루투스 통신 권한이 부여되어 있는지 확인하세요.
5. 시스템 자원 예약
원활한 클라이언트 배포, 로컬 암호화 데이터의 안전한 저장 및 향후 UKey 하드웨어에 대한 원활한 OTA 펌웨어 업데이트를 보장하려면 터미널 장치에서 최소한 500MB 사용 가능한 디스크 공간.