Устранение распространенных ошибок диспетчера учетных данных

This guide lists common error codes and descriptions related to Credential Manager, and provides some information about their causes.

Код и описание ошибки Причина

android.os.TransactionTooLargeException

Это вызвано известной проблемой , из-за которой API credentialManager.getCredential() в Android 14 и выше не отображает диалоговое окно входа в систему, если на устройстве присутствует несколько учетных записей Google. Эта проблема наблюдается именно с GetGoogleIdOption , а не GetSignInWithGoogleOption . Эта проблема исправлена ​​в Google Play Services версии 24.40.XX и выше.

CreateCredentialCancellationException

Passkey registration or retrieval was canceled by the user.

The user has chosen not to create or use a credential. You can now adjust your UI to offer an alternative sign-in method or move on to the next steps in your process.

GetCredentialCancellationException

Процесс получения учетных данных был прерван, поскольку не было получено необходимое разрешение пользователя. Хотя чаще всего это происходит, когда пользователь вручную отменяет процесс входа в систему, это также может сигнализировать о том, что запрос не был авторизован из-за технических ограничений. Поскольку эта ошибка указывает на отсутствие согласия, не следует автоматически повторять запрос, так как это создает неудобства для пользователя. Однако разработчикам следует отслеживать частоту возникновения этого исключения. Большое количество «отмен» может фактически указывать на неправильную конфигурацию — например, отсутствие или некорректную область действия — которая препятствует успешному завершению работы пользовательского интерфейса авторизации. Если вы заметите неожиданные тенденции, проверьте параметры запроса и конфигурацию [зависимой стороны][2].

Note: The error message can differ based on the type of credential:

  • For passkeys, the error message can be "Passkey registration or retrieval was canceled by the user".
  • For Sign in with Google, the error message can be "Activity is cancelled by the user".

CreateCredentialCustomException or GetCredentialCustomException

При использовании стороннего SDK для выполнения вызовов API с объектом запроса, являющимся подклассом CreateCustomCredentialRequest или GetCustomCredentialOption , могут возникать ошибки. В этом случае проверьте SDK на наличие констант пользовательских типов исключений, соответствующих e.type. Если совпадение не найдено, можно либо отбросить, либо зарегистрировать исключение.

CreateCredentialInterruptedException or GetCredentialInterruptedException

Операция могла быть прервана из-за того, что пользователь перешел в настройки для переконфигурации менеджеров паролей. Другие причины также могли способствовать прерыванию. Пожалуйста, попробуйте позвонить еще раз.

CreateCredentialUnknownException

During save password, found password failure response from one tap 16: [28431] Skipping password saving since the user is likely prompted with Android Autofill.

Эта ошибка затрагивает только Android 13 и более ранние версии, когда Google является назначенным поставщиком автозаполнения. В таких случаях пользователи получат запрос на сохранение от системы автозаполнения, и пароль будет сохранен в Google Password Manager. Важно отметить, что учетные данные, сохраненные с помощью автозаполнения от Google, синхронизируются в обоих направлениях с API Credential Manager. Поэтому эту ошибку можно смело игнорировать.

CreatePublicKeyCredentialDomException & GetPublicKeyCredentialDomException

It's likely that the DOM exception contains a more specific domError . You can map it to a WebAuthn DomException for further details.

CreatePublicKeyCredentialDomException & GetPublicKeyCredentialDomException

Входящий запрос не может быть проверен.

Сервер менеджера паролей не распознает идентификатор пакета приложения. Это указывает на потенциальную проблему с интеграцией на стороне сервера, а именно с настройкой ссылки на цифровой актив . Дважды проверьте правильность идентификатора пакета и SHA в файле ссылки на актив.

CreatePublicKeyCredentialDomException :

Не удалось создать ключ во время регистрации.

This issue can arise when a user dismisses the screen lock dialog during registration.

CreateCredentialNoCreateOptionException

This specific exception indicates that the user does not have a valid password manager configured. This error is not user initiated manual cancellow flow but a separate failure.

CreatePublicKeyDomException & GetPublicKeyCredentialDomException

Регистрация пароля была отменена пользователем.

Пользователь отменил попытку получения пароля.

This issue can arise when a user dismisses the fingerprint dialog during registration / retrieval of a passkey.

GetCredentialProviderConfigurationException & CreateCredentialProviderConfigurationException

getCredentialAsync no provider dependencies found

createCredentialAsync no provider dependencies found

The androidx.credentials:credentials-play-services-auth:<latest-version> dependency is missing.

GetCredentialUnsupportedException or CreateCredentialUnsupportedException

Ваше устройство не поддерживает диспетчер учетных данных.

Ensure your credentials library is updated to version 1.2.1 or higher.

GetPublicKeyCredentialException

Не удалось расшифровать учетные данные.

This issue occurs when trying to use a passkey after logging out and back into Google Accounts. Instruct your user to sign back into their Google Account on their device.

NoCreateOptionException

This exception is expected behavior when a user does not have any passkey credentials set up on their device, or if they don't have a password manager configured.

NoCredentialException

Соответствующие учетные данные не найдены.

This exception is caused in the following situations:

  • setFilterByAuthorizedAccounts is set to true without authorized accounts on the device.
  • There are no signed-in accounts on the device (no accounts have been added or the accounts need reauthentication).
  • Всплывающая подсказка не отображается, если для какой-либо учетной записи на устройстве отключены запросы на вход. Для отображения всплывающей подсказки для любой учетной записи необходимо включить этот глобальный параметр, расположенный в разделе «Настройки учетной записи Google» > «Вход через Google» . Это не влияет на работу кнопок.

Not able to create passkey due to encrypted data being locked

Пользователю необходимо сбросить данные на стороне сервера Chrome. Эти данные включают закладки и настройки Chrome, а также сохраненные пароли и ключи доступа. Для получения дополнительной информации о том, какие данные хранит Chrome, перейдите в раздел «Данные Chrome» в вашей учетной записи .

  1. Перейдите по ссылке chrome.google.com/sync .
  2. Внизу выберите «Очистить данные» .
  3. На устройстве включите синхронизацию в Chrome .

On Begin Sign In Failure: 8 : Unknown internal error.

The device may not be set up properly with the Google Account. There might be an issue with how the passkey JSON is being created. Double-check the implementation for accuracy.

Не удалось получить учетную запись синхронизации.

В версиях Google Play Services 24.40.XX и более поздних будет отображаться более информативная информация об ошибках. Например, вместо сообщения "Не удалось получить учетную запись синхронизации" теперь будет отображаться сообщение об ошибке отмены.