일반적인 인증 관리자 오류 문제 해결

이 가이드에서는 인증 관리자와 관련된 일반적인 오류 코드 및 설명을 나열하고 그 원인에 관한 정보를 제공합니다.

오류 코드 및 설명 원인

android.os.TransactionTooLargeException

이는 기기에 여러 Google 계정이 있는 경우 Android 14 이상에서 credentialManager.getCredential() API가 로그인 대화상자를 표시하지 못하는 알려진 문제로 인해 발생합니다. 이 문제는 특히 GetSignInWithGoogleOption가 아닌 GetGoogleIdOption에서 나타납니다. 이 문제는 Google Play 서비스 버전 24.40.XX 이상에서 해결되었습니다.

CreateCredentialCancellationException 또는 GetCredentialCancellationException)

사용자가 패스키 등록 또는 검색을 취소했습니다.

사용자가 사용자 인증 정보를 만들거나 사용하지 않도록 선택했습니다. 이제 UI를 조정하여 대체 로그인 방법을 제공하거나 절차의 다음 단계로 이동할 수 있습니다.

CreateCredentialCustomException 또는 GetCredentialCustomException

서드 파티 SDK를 사용하여 CreateCustomCredentialRequest 또는 GetCustomCredentialOption의 서브클래스인 요청 객체로 API를 호출하면 오류가 발생할 수 있습니다. 이 경우 SDK에서 e.type과 일치하는 맞춤 예외 유형 상수를 확인합니다. 일치하는 항목이 없으면 예외를 삭제하거나 로깅해도 됩니다.

CreateCredentialInterruptedException 또는 GetCredentialInterruptedException

사용자가 비밀번호 관리자를 재구성하기 위해 설정으로 이동했기 때문에 작업이 중단되었을 수 있습니다. 다른 이유로 인해 서비스가 중단되었을 수도 있습니다. 다시 전화해 주세요.

CreateCredentialUnknownException

비밀번호 저장 중 원탭 16으로부터 비밀번호 발견 실패 응답 16: [28431] 사용자에게 Android 자동 완성에서 메시지가 표시될 가능성이 크므로 비밀번호 저장 건너뛰기

이 오류는 Google이 지정된 자동 완성 제공업체인 경우 Android 13 이하 버전에만 영향을 미칩니다. 이 경우 사용자에게 자동 완성의 저장 메시지가 표시되고 비밀번호가 Google 비밀번호 관리자에 저장됩니다. 중요한 점은 Google 자동 완성을 사용하여 저장된 사용자 인증 정보는 Credential Manager API와 양방향으로 동기화된다는 것입니다. 따라서 이 오류는 무시해도 됩니다.

CreatePublicKeyCredentialDomException 및 GetPublicKeyCredentialDomException

DOM 예외에 더 구체적인 domError가 포함되어 있을 가능성이 높습니다. 자세한 내용은 WebAuthn DomException에 매핑하세요.

CreatePublicKeyCredentialDomException 및 GetPublicKeyCredentialDomException

수신 요청을 검증할 수 없습니다.

비밀번호 관리자의 서버가 앱의 패키지 ID를 인식하지 못합니다. 이는 서버 측 통합, 특히 디지털 저작물 링크 설정에 잠재적인 문제가 있음을 나타냅니다. 애셋 링크 파일 내의 패키지 ID 및 SHA의 정확성을 다시 확인합니다.

CreatePublicKeyCredentialDomException에 대한 응답 메시지입니다.

등록 중에 키를 만들 수 없음

이 문제는 사용자가 등록 중에 화면 잠금 대화상자를 닫을 때 발생할 수 있습니다.

CreatePublicKeyDomException 및 GetPublicKeyCredentialDomException

사용자가 패스키 등록을 취소했습니다.

사용자가 패스키 검색을 취소했습니다.

이 문제는 사용자가 패스키 등록 / 검색 중에 지문 대화상자를 닫을 때 발생할 수 있습니다.

GetCredentialProviderConfigurationException 및 CreateCredentialProviderConfigurationException

getCredentialAsync 제공업체 종속 항목을 찾을 수 없음

createCredentialAsync 제공업체 종속 항목을 찾을 수 없음

androidx.credentials:credentials-play-services-auth:<latest-version> 종속 항목이 누락되었습니다.

GetCredentialUnsupportedException 또는 CreateCredentialUnsupportedException

기기에서 인증 관리자를 지원하지 않음

사용자 인증 정보 라이브러리가 버전 1.2.1 이상으로 업데이트되었는지 확인합니다.

GetPublicKeyCredentialException입니다.

사용자 인증 정보 복호화 실패

이 문제는 Google 계정에서 로그아웃한 후 다시 패스키를 사용하려고 할 때 발생합니다. 사용자에게 기기에서 Google 계정에 다시 로그인하도록 안내합니다.

NoCredentialException

일치하는 사용자 인증 정보 없음

기기에서 일치하는 사용자 인증 정보를 찾을 수 없습니다. 이는 사용자가 이전에 사용자 인증 정보를 저장하지 않은 경우 예상되는 동작입니다.

암호화된 데이터가 잠겨 패스키를 만들 수 없음

사용자가 Chrome 서버 측 데이터를 재설정해야 합니다. 이 데이터에는 저장된 비밀번호 및 패스키 외에도 북마크 및 Chrome 설정이 포함됩니다. Chrome에서 저장하는 데이터에 관한 자세한 내용은 계정의 Chrome 데이터를 참고하세요.

  1. chrome.google.com/sync로 이동합니다.
  2. 하단에서 데이터 지우기를 선택합니다.
  3. 기기에서 Chrome에서 동기화를 사용 설정합니다.

On Begin Sign In Failure: 8: 알 수 없는 내부 오류입니다.

기기가 Google 계정으로 올바르게 설정되지 않았을 수 있습니다. 패스키 JSON이 생성되는 방식에 문제가 있을 수 있습니다. 구현이 정확한지 다시 확인합니다.

동기화 계정을 가져올 수 없음

Google Play 서비스 버전 24.40.XX 이상에서는 더 많은 정보를 제공하는 오류 코드를 제공합니다. 예를 들어 이제 호출자에게 '동기화 계정을 가져올 수 없습니다' 대신 취소 오류 메시지가 표시됩니다.