인증 관리자는 전체 Android 생태계에서 인증을 간소화합니다. 사용자에게 일관된 환경을 제공하고 개발자가 패스키, 비밀번호, 제휴 로그인 메커니즘(예: Google 계정으로 로그인)을 사용할 수 있는 통합 API 노출 영역을 제공합니다. 핵심 프로그래밍 인터페이스는 폼 팩터 전반에서 일관되게 유지되지만 각 폼 팩터에는 고유한 UI 및 UX 고려사항이 있습니다. 성공적인 구현을 위해서는 각 기기의 특정 입력 방법, 화면 크기, 사용자 컨텍스트에 맞게 앱의 인증 흐름을 조정해야 합니다.
이 가이드에서는 다양한 Android 폼 팩터에서 인증 관리자를 구현하는 방법을 간략하게 설명하고 주요 고려사항을 강조하며 자세한 문서로 연결합니다.
휴대기기
휴대전화, 태블릿, 폴더블을 비롯한 휴대기기는 Android 개발의 가장 일반적인 타겟입니다. 표준 인증 관리자 구현은 일반적으로 터치스크린과 기기 내 키보드를 갖춘 이러한 기기에 적합합니다. 이 폼 팩터의 사용자 환경은 다른 폼 팩터에 맞게 조정하는 기준이 됩니다. 인증 흐름은 폼 팩터에 적합해야 하며 기기의 화면 공간과 입력 방법을 최대한 활용해야 합니다.
Wear OS
Wear OS 기기는 작은 화면과 제한된 기기 내 입력이 특징입니다. 인증 관리자의 패스키 구현은 사용자가 연결된 페어링된 휴대전화가 필요하지 않고 비밀번호를 기억할 필요 없이 앱에 로그인할 수 있는 안전한 환경을 제공합니다.
Wear OS용 API는 모바일과 동일하므로 기존 모바일 통합을 재사용할 수 있습니다. 인증 관리자의 패스키, Google 계정으로 로그인, 비밀번호 외에도 데이터 레이어 토큰 공유, OAuth 또는 기존 솔루션을 비롯한 다른 인증 방법을 사용할 수 있습니다. 이러한 방법은 사용자를 인증 관리자로 전환하는 동안 백업으로 사용하거나 데이터 레이어 토큰 공유의 경우 장기적인 솔루션으로 사용할 수 있습니다.
Wear OS에 인증 관리자를 사용하려면 다음과 같은 요구사항이 있습니다.
- 최소 API 수준:
minSdkVersion33 이상- 비밀번호, 패스키, Google 계정으로 로그인 지원을 포함합니다.
- GMS 버전: 모바일 앱에 필요한 버전과 동일합니다.
Wear OS 기기의 사용자 인터페이스는 다음과 같습니다.
자세한 구현 가이드 및 코드 샘플은 다음 리소스를 참고하세요.
제한사항
Wear OS에서 인증 관리자를 사용하면 다음과 같은 제한사항이 있습니다.
- 패스키 생성을 지원하지 않습니다.
- 사용자 인증 정보 복원에 관해 지원하지 않습니다.
Android XR
가상 현실과 증강 현실을 포함하는 Android XR을 사용하면 앱이 3D 공간에서 렌더링됩니다. 사용자 입력은 다른 폼 팩터의 입력과 근본적으로 다르며 손동작과 같은 자연스러운 입력을 사용합니다.
XR용 인증 관리자를 조정하려면 3D 공간의 인증 UI (패스키, 비밀번호 또는 제휴 로그인 방법 사용)를 재고해야 합니다. 예를 들어 인증 프롬프트가 부동 패널에 표시되고 사용자는 손동작을 사용하여 선택합니다. 타겟 XR 기기의 특정 하드웨어 또는 소프트웨어 필수사항도 고려해야 합니다.
중요한 디자인 과제는 VR 또는 AR 환경 내에서 직관적이고 안전한 인증 환경을 만드는 것입니다. 또한 여러 사람이 동일한 기기를 사용할 수 있는 멀티 사용자 XR 시나리오에서 ID를 관리하는 방법도 고려해야 합니다.
Android XR에 인증 관리자를 사용하려면 다음과 같은 요구사항이 있습니다.
- 최소 API 수준:
minSdkVersion34 이상 - GMS 버전: 모바일 앱에 필요한 버전과 동일합니다.
- 에뮬레이터:
- 최소 에뮬레이터 시스템 이미지:
- macOS: Google Play XR ARM 64 v8a 시스템 이미지 버전 7
- Windows: Google Play XR Intel x86_64 Atom 시스템 이미지 버전 7
- 에뮬레이터 버전 35.6.11 안정화 이상
- 최소 에뮬레이터 시스템 이미지:
XR의 로그인 환경은 다음과 같을 수 있습니다.
XR에서 지원되지 않는 흐름
Android XR의 인증 관리자는 다른 기기에서 QR 코드를 스캔해야 하는 인증 흐름을 지원하지 않습니다. 이는 XR 헤드셋의 로그인 프로세스 중에 그리고 에뮬레이터로 테스트할 때 관찰할 수 있습니다.
XR에 관해 자세히 알아보려면 Android XR을 참고하세요.
Android TV
Android TV 기기는 일반적으로 공동으로 사용되며 멀리서 보고 D패드 리모컨을 사용하여 탐색합니다. 이 환경에서 사용자 이름과 비밀번호를 입력하는 것은 사용자에게 어려울 수 있습니다. 인증 관리자는 Google 계정으로 로그인, 저장된 비밀번호, 교차 기기 패스키를 지원하여 Android TV의 인증을 간소화합니다. 공유 TV에는 여러 Google 프로필이 있는 경우가 많으므로 인증 관리자는 현재 활성 계정으로 선택사항을 제한하는 대신 기기에서 사용 가능한 모든 사용자 인증 정보를 가져와 표시하여 이 공동 설정에 적응합니다.
이 공동 특성은 패스키가 처리되는 방식도 결정합니다. TV에는 개인 잠금 화면 지식 요소 (LSKF)가 없으므로 패스키는 TV에 직접 저장되거나 생성되지 않습니다. 대신 패스키 인증은 TV에 QR 코드가 표시되고 사용자가 휴대기기로 스캔하여 생체 인식 인증을 완료하는 교차 기기 하이브리드 흐름을 활용합니다.
isAutoSelectAllowed = true를 설정하면 Google TV에서 클릭이 필요 없는 흐름이 가능하지만 정확히 일치하는 사용자 인증 정보가 하나만 있는 경우에만 가능합니다. 기본 TV 하단 시트가 계속 표시되어 사용자 계정 확인을 보여줍니다. 사용자가 취소하지 않으면 리모컨 클릭이 필요 없이 사용자 인증 정보가 자동으로 반환됩니다. 일치하는 사용자 인증 정보가 여러 개 있는 경우 자동으로 선택되지 않으며 대신 사용자에게 선택하라는 메시지가 표시됩니다.
모바일 앱과 TV 앱이 정확히 동일한 Android 패키지 이름과 서명 키를 공유하는 경우 Google 비밀번호 관리자는 이를 동일한 앱 ID로 인식합니다.
이로 인해 모바일 기기에 저장된 비밀번호는 디지털 애셋 링크 (asset_statements) 구성을 요구하지 않고 TV에서 직접 제공될 수 있습니다. 디지털 애셋 링크는 앱과 웹사이트 간 또는 패키지 이름이 다른 앱 간과 같이 경계를 넘어 사용자 인증 정보를 공유할 때만 필요합니다.
Android TV에 인증 관리자를 사용하려면 다음과 같은 요구사항이 있습니다.
- 최소 API 수준: Android 14 (API 수준 34,
minSdkVersion34) 이상 - GMS 버전: 2026W30 이상
- 패스키용 하드웨어: QR 코드를 스캔하고 FIDO 하이브리드 흐름을 완료하려면 카메라와 블루투스가 있는 보조 휴대기기가 필요합니다.
제한사항
Android TV는 공동 기기이므로 이 플랫폼에서 인증 관리자를 사용하면 사용자 개인 정보 보호 및 보안을 위해 다음과 같은 의도적인 제한사항이 있습니다.
- 로컬 패스키 생성 또는 저장 없음: 패스키는 TV에서 직접 생성하거나 저장할 수 없습니다. 로컬 사용자 인증 정보는 지원되지 않으므로 요청에서
preferImmediatelyAvailableCredentials를true로 설정하지 마세요. 이렇게 하면 교차 기기 패스키가 필터링되고 사용자 인증 정보가 반환되지 않습니다. - 서드 파티 사용자 인증 정보 제공업체 없음: Android TV는 자동 완성을 지원하지 않으므로 서드 파티 비밀번호 관리자는 플랫폼에서 사용할 수 없습니다. 사용자는 Google 비밀번호 관리자를 사용해야 합니다.
- 사용자 인증 정보 복원 없음: 사용자 인증 정보 복원을 사용하여 새 기기에 자동 로그인이 Android TV에서 지원되지 않습니다.
TV 개발에 관해 자세히 알아보려면 Android TV 개요를 참고하세요.
Android Automotive OS
Android Automotive OS (AAOS) 기기는 차량에 통합된 공동 시스템입니다. AAOS용 인증 관리자를 조정하려면 안전한 인증 (일반적으로 차량이 주차된 동안)을 지원하고 공유 기기에서 여러 사용자 프로필을 수용해야 합니다.
대형 화면 또는 태블릿에 최적화된 앱을 자동차에 가져오고 앱이 이미 휴대기기 또는 태블릿에서 인증 관리자와 패스키를 지원하는 경우 인증 흐름을 변경하지 않고도 Android Automotive OS에서 작동합니다.
Android Automotive OS의 인증은 다음 방법을 지원합니다.
- 패스키 (교차 기기 하이브리드 흐름): 사용자는 교차 기기 흐름을 통해 기존 패스키로 인증할 수 있습니다. 시스템은 사용자가 휴대기기로 스캔하는 QR 코드를 자동차 화면에 표시합니다. 생체 인식 및 화면 잠금 확인은 사용자의 휴대전화에서 이루어지므로 사용자는 자동차 디스플레이에서 화면 잠금을 구성할 필요가 없습니다.
- Google 계정으로 로그인: 자동차 디스플레이에 기본 Google 계정으로 로그인 화면을 직접 표시합니다.
- 저장된 비밀번호: 사용자는 Google 비밀번호 관리자에서 저장된 비밀번호를 검색하여 차량 화면에 사용자 인증 정보를 수동으로 입력하지 않고 로그인할 수 있습니다.
Android Automotive OS는 프로필별로 세션과 사용자 인증 정보를 관리하여 프로필 간에 사용자별 세션 데이터 (예: 프로필 A, 프로필 B 또는 게스트 프로필)를 격리합니다.
Android Automotive OS에 인증 관리자를 사용하려면 다음과 같은 요구사항이 있습니다.
- 최소 API 수준: Android 9 (API 수준 28,
minSdkVersion28) 이상. 교차 기기 패스키 검색에는 Android 14 (API 수준 34) 이상이 필요합니다. - GMS 버전: 모바일 앱에 필요한 버전과 동일합니다.
테스트 제한사항
패스키를 테스트하려면 Android Automotive OS 빌드를 기본 노출 영역으로 실행하는 실제 기기가 필요합니다. 설정 안내는 Pixel Tablet에서 Android Automotive OS를 사용하여 테스트를 참고하세요. 에뮬레이터는 FIDO 하이브리드 흐름에 필요한 저전력 블루투스 (BLE)를 지원하지 않으므로 패스키 테스트에 사용할 수 없습니다.
제한사항 및 지원되지 않는 흐름
Android Automotive OS에서 인증 관리자를 사용하면 다음과 같은 제한사항이 있습니다.
- 로컬 패스키 저장 또는 검색 없음: 차량은 공동 기기이므로 직접 로컬 패스키 검색은 지원되지 않습니다. 패스키를 차량에 직접 동기화하면 보안 위험이 있으므로 패스키는 교차 기기 하이브리드 흐름을 통해 사용해야 합니다.
- 즉시 사용 가능한 사용자 인증 정보 지원되지 않음: 앱이 패스키를 요청하고
preferImmediatelyAvailableCredentials를true로 설정하면 자동차 UI가 즉시 종료되고NoCredentialException이 발생합니다. 이 시나리오에 적절한 대체 UX를 제공하세요. - 서드 파티 사용자 인증 정보 제공업체 없음: Android Automotive OS에서는 서드 파티 비밀번호 관리자가 지원되지 않습니다. 사용자는 Google 비밀번호 관리자 또는 교차 기기 하이브리드 흐름을 사용하여 인증해야 합니다.
- 저장된 비밀번호 생성 없음: API는 자동차 인터페이스에서 직접 새 저장된 비밀번호를 생성하고 저장하는 것을 지원하지 않습니다. 사용자 인증 정보 생성은 FIDO 하이브리드 흐름을 사용하는 새 패스키로 제한됩니다.
Automotive OS 개발에 관해 자세히 알아보려면 Android Automotive OS 개요를 참고하세요.