브라우저 및 기기 호환성
k-ID의 브라우저 기반 검증 플로우는 사용자의 브라우저에서 실행되며, 백그라운드에서 여러 검증 방식을 제공합니다. 그중 하나가 AgeKey로, WebAuthn 패스키(passkey)를 기반으로 하며 사용이 간편하고 재사용 가능한 연령 신호입니다. AgeKey는 패스키 Related Origin Requests를 필요로 하므로 다른 검증 방식보다 브라우저 요건이 높습니다. 이 Chromium 기능은 Chrome 129에서 도입되었습니다. 위젯은 런타임에 브라우저를 확인하여 지원되는 경우에만 AgeKey를 제공합니다. 지원되지 않는 이전 브라우저에서도 위젯은 정상 작동하지만, AgeKey는 숨겨지고 사용자는 다른 방식으로 검증을 완료합니다.
이 문서를 읽는 방법: 각 표의 각 행에는 최소 버전이 2개씩 표시됩니다. "위젯" 최소 버전은 컴플라이언스 플로우 자체가 동작하는 최소 요건이며, "AgeKey" 최소 버전은 AgeKey가 검증 방식으로 제공되는 최소 요건입니다. 최종 사용자 기기 지원 여부는 기기가 지원되는 OS 버전과 브라우저를 실행하는지에 따라 결정됩니다. 해당 OS를 실행하는 데 필요한 것 외에 특정 하드웨어 모델은 필요하지 않습니다.
데스크톱 브라우저
| 브라우저 | 위젯 최소 버전 | AgeKey 최소 버전 | 비고 |
|---|---|---|---|
| Chrome | 108 | 129 | Chrome 129 미만에서는 AgeKey를 숨깁니다. |
| Edge | 108 | 129 | Chromium 기반. AgeKey 지원은 Chrome과 동일합니다. |
| Safari | 16 | 16 | macOS 12.4(Monterey) 이상이 필요합니다. |
| Firefox | 122 | 122 | macOS에서는 AgeKey에 macOS 13(Ventura) 이상이 추가로 필요합니다. |
| Opera | 97 | 115 | Chromium 기반. Opera 115 미만에서는 AgeKey를 숨깁니다. |
모바일 브라우저
| 브라우저 | 위젯 최소 버전 | AgeKey 최소 버전 | 비고 |
|---|---|---|---|
| Chrome (Android) | 108 | 129 | Android 9 이상이 필요합니다. Chrome 129 미만에서는 AgeKey를 숨깁니다. |
| Edge (Android) | 108 | 129 | Android 9 이상이 필요합니다. Edge 129 미만에서는 AgeKey를 숨깁니다. |
| Firefox (Android) | 128 | 128 | Android 9 이상이 필요합니다. Android Credential Manager를 통해 AgeKey를 지원합니다. |
| Opera Mobile (Android) | 80 | 89 | Android 9 이상이 필요합니다. Opera Mini는 지원되지 않습니다. |
| Safari (iOS) | 15.2 | 16 | AgeKey는 iOS 16 이상이 필요합니다. |
Apple은 iOS의 모든 브라우저가 WebKit을 사용하도록 요구하므로, iOS의 Chrome, Firefox, Edge 및 기타 브라우저는 Safari (iOS) 행의 요건을 따릅니다. Android 또는 데스크톱 버전 요건은 적용되지 않습니다.
모바일 임베드
기기의 기본 브라우저를 실행하는 대신 임베디드 브라우저 내에서 검증 플로우를 여는 경우 다음 최소 요건이 적용됩니다. iOS의 ASWebAuthenticationSession과 SFSafariViewController는 모두 AgeKey를 지원하며, Android에서는 Android Custom Tabs가 지원되는 임베드 방식입니다.
| 임베드 방식 | 위젯 최소 버전 | AgeKey 최소 버전 | 비고 |
|---|---|---|---|
| iOS ASWebAuthenticationSession | iOS 15.2 | iOS 16+ | 권장. OS가 관리하는 브라우저 뷰로 패스키 권한(entitlement)을 보유합니다. |
| iOS SFSafariViewController | iOS 15.2 | iOS 16+ | 지원됩니다. 패스키 권한은 ASWebAuthenticationSession과 동일합니다. |
| iOS WKWebView(네이티브 앱 임베드) | iOS 15.2 | ❌ (위젯이 AgeKey를 숨김) | 일반 WKWebView 인스턴스에는 패스키 권한이 없습니다. 위젯은 window.webkit.messageHandlers를 감지하여 AgeKey를 숨기며, 사용자는 다른 방식으로 검증을 완료합니다. 권한을 가진 WKWebView 기반 브라우저(iOS용 Chrome, Firefox, Edge)는 허용 목록에 포함됩니다. |
| Android Custom Tabs | Chrome 108 / Android 9+ | Chrome 129 / Android 9+ | 권장. Chrome 129부터 Custom Tabs와 Credential Manager를 통해 AgeKey를 지원합니다. |
| Android WebView | Android 9+ | ❌ (위젯이 AgeKey를 숨김) | Android WebView는 WebAuthn을 지원하지 않습니다. 위젯은 publickey-credentials-create 기능 정책(feature policy)을 확인하여 AgeKey를 숨기며, 사용자는 다른 방식으로 검증을 완료합니다. |
| Android Trusted Web Activity | ❌ | ❌ | k-ID 도메인에 digital-asset-link 설정이 필요하지만 사용할 수 없습니다. TWA는 Custom Tabs로 폴백되므로 Custom Tabs를 직접 사용하세요. |
데스크톱 임베드 및 게임 엔진
데스크톱 애플리케이션, 런처, 게임 엔진은 Chromium Embedded Framework(CEF)를 임베드하여 웹 콘텐츠를 호스팅하는 경우가 많습니다. 예를 들어 CefSharp나 게임 엔진에 번들된 CEF 기반 브라우저 등이 있습니다.
AgeKey의 요건은 데스크톱 Chrome과 동일합니다. 기반 Chromium 브랜치에 Related Origin Requests가 포함되어 있어야 합니다. 이 기능은 Chromium 129에서 도입되었습니다. CEF 129 미만에서는 기존 AgeKey를 사용한 검증이 조용히 실패하므로 위젯이 AgeKey를 숨기고 대신 다른 검증 방식을 제공합니다.
| CEF 브랜치 | AgeKey 상태 |
|---|---|
| CEF 129 미만 | 사용할 수 없습니다. 위젯이 AgeKey를 숨기고 대신 다른 검증 방식을 제공합니다. |
| CEF 129+ | 완전 지원. AgeKey의 생성 및 재사용 모두 OS 플랫폼 인증기(Windows Hello, Touch ID)를 통해 동작합니다. |
특정 기기 또는 브라우저 구성에 대한 문의가 있으시면 담당 k-ID 계정 담당자 또는 k-ID에 문의해 주세요.