이 가이드에는 Credential Manager와 관련된 일반적인 오류 코드와 설명이 나열되어 있으며, 그 원인에 관한 정보도 제공됩니다.
| 오류 코드 및 설명 | 원인 |
|---|---|
|
android.os.TransactionTooLargeException |
이는 Android 14 이상의 |
|
CreateCredentialCancellationException 사용자가 패스키 등록 또는 검색을 취소했습니다. |
사용자가 사용자 인증 정보를 만들거나 사용하지 않기로 선택했습니다. 이제 UI를 조정하여 대체 로그인 방법을 제공하거나 프로세스의 다음 단계로 이동할 수 있습니다. |
|
GetCredentialCancellationException |
필요한 사용자 승인을 얻지 못해 사용자 인증 정보 가져오기 프로세스가 종료되었습니다. 이 오류는 사용자가 로그인 흐름을 수동으로 취소할 때 가장 흔하게 발생하지만 기술적 제약으로 인해 요청이 승인되지 않았음을 나타낼 수도 있습니다. 이 오류는 동의가 부족함을 나타내므로 요청을 자동으로 다시 시도하지 마세요. 사용자 환경에 지장을 줄 수 있습니다. 하지만 개발자는 이 예외의 빈도를 모니터링해야 합니다. '취소'가 많이 발생하면 승인 UI가 성공적으로 완료되지 않도록 하는 잘못된 구성(예: 누락되거나 잘못된 범위)이 있을 수 있습니다. 예상치 못한 추세가 발견되면 요청 매개변수와 [신뢰 당사자][2] 구성을 검토하세요. 참고: 오류 메시지는 사용자 인증 정보 유형에 따라 다를 수 있습니다.
|
|
CreateCredentialCustomException 또는 GetCredentialCustomException |
서브클래스 |
|
CreateCredentialInterruptedException 또는 GetCredentialInterruptedException |
사용자가 비밀번호 관리자를 재구성하기 위해 설정으로 이동하여 작업이 중단되었을 수 있습니다. 다른 이유도 서비스 중단에 영향을 미쳤을 수 있습니다. 다시 전화를 걸어 보세요. |
|
CreateCredentialUnknownException 비밀번호 저장 중 원탭 16으로부터 비밀번호 발견 실패 응답 16: [28431] 사용자에게 Android 자동 완성에서 메시지가 표시될 가능성이 크므로 비밀번호 저장 건너뛰기 |
이 오류는 Google이 지정된 자동 완성 제공업체인 경우 Android 13 및 이전 버전에만 영향을 미칩니다. 이 경우 사용자에게 Google 자동 완성의 저장 메시지가 표시되고 비밀번호가 Google 비밀번호 관리자에 저장됩니다. 중요한 점은 Google 자동 완성을 사용하여 저장된 사용자 인증 정보는 Credential Manager API와 양방향으로 동기화된다는 것입니다. 따라서 이 오류는 무시해도 됩니다. |
|
CreatePublicKeyCredentialDomException 및 GetPublicKeyCredentialDomException |
DOM 예외에 더 구체적인 |
|
CreatePublicKeyCredentialDomException 및 GetPublicKeyCredentialDomException 수신 요청을 검증할 수 없습니다. |
비밀번호 관리자의 서버에서 앱의 패키지 ID를 인식하지 못합니다. 이는 서버 측 통합, 특히 디지털 애셋 링크 설정에 문제가 있을 수 있음을 나타냅니다. 애셋 링크 파일 내 패키지 ID와 SHA가 정확한지 다시 한번 확인하세요. |
|
CreatePublicKeyCredentialDomException: 등록 중에 키를 만들 수 없음 |
이 문제는 사용자가 등록 중에 화면 잠금 대화상자를 닫을 때 발생할 수 있습니다. |
|
CreateCredentialNoCreateOptionException |
이 예외는 사용자에게 유효한 비밀번호 관리자가 구성되어 있지 않음을 나타냅니다. 이 오류는 사용자가 시작한 수동 취소 흐름이 아니라 별도의 실패입니다. |
|
CreatePublicKeyDomException 및 GetPublicKeyCredentialDomException 사용자가 패스키 등록을 취소했습니다. 사용자가 패스키 가져오기를 취소했습니다. |
이 문제는 사용자가 패스키 등록 / 검색 중에 지문 대화상자를 닫을 때 발생할 수 있습니다. |
|
GetCredentialProviderConfigurationException 및 CreateCredentialProviderConfigurationException getCredentialAsync 제공업체 종속 항목을 찾을 수 없음 createCredentialAsync 제공업체 종속 항목을 찾을 수 없음 |
|
|
GetCredentialUnsupportedException 또는 CreateCredentialUnsupportedException 기기에서 사용자 인증 정보 관리자를 지원하지 않음 |
인증 정보 라이브러리가 버전 1.2.1 이상으로 업데이트되었는지 확인합니다. |
|
GetPublicKeyCredentialException 사용자 인증 정보를 복호화할 수 없음 |
이 문제는 로그아웃했다가 다시 Google 계정에 로그인한 후 패스키를 사용하려고 할 때 발생합니다. 사용자에게 기기에서 Google 계정에 다시 로그인하도록 안내합니다. |
|
NoCreateOptionException |
이 예외는 사용자가 기기에 설정된 패스키 사용자 인증 정보가 없거나 비밀번호 관리자가 구성되어 있지 않은 경우 예상되는 동작입니다. |
|
NoCredentialException 일치하는 사용자 인증 정보가 없습니다. |
이 예외는 다음과 같은 상황에서 발생합니다.
|
|
암호화된 데이터가 잠겨 있어 패스키를 만들 수 없음 |
사용자가 Chrome 서버 측 데이터를 재설정해야 합니다. 이 데이터에는 저장된 비밀번호 및 패스키 외에도 북마크 및 Chrome 설정이 포함됩니다. Chrome에서 저장하는 데이터에 관한 자세한 내용은 계정의 Chrome 데이터를 참고하세요.
|
|
On Begin Sign In Failure: 8: 알 수 없는 내부 오류입니다. |
기기가 Google 계정으로 올바르게 설정되지 않았을 수 있습니다. 패스키 JSON 생성 방식에 문제가 있을 수 있습니다. 구현이 정확한지 다시 한번 확인하세요. |
|
동기화 계정을 가져올 수 없음 |
Google Play 서비스 버전 24.40.XX 이상에서는 더 많은 정보를 제공하는 오류 코드가 제공됩니다. 예를 들어 '동기화 계정을 가져올 수 없음' 대신 호출자에게 취소 오류 메시지가 표시됩니다. |