Cómo solucionar errores comunes del Administrador de credenciales

En esta guía, se enumeran los códigos de error y las descripciones comunes relacionados con el Administrador de credenciales, y se proporciona información sobre sus causas.

Código de error y descripción Causa

android.os.TransactionTooLargeException

Esto se debe a un problema conocido en el que la API de credentialManager.getCredential() en Android 14 y versiones posteriores no muestra el diálogo de acceso cuando hay varias Cuentas de Google en el dispositivo. Este problema se observa específicamente con GetGoogleIdOption y no con GetSignInWithGoogleOption. Este problema se solucionó en la versión 24.40.XX y posteriores de los Servicios de Google Play.

CreateCredentialCancellationException o GetCredentialCancellationException

El usuario canceló el registro o la recuperación de la llave de acceso.

El usuario decidió no crear ni usar una credencial. Ahora puedes ajustar la IU para ofrecer un método de acceso alternativo o continuar con los siguientes pasos del proceso.

CreateCredentialCustomException o GetCredentialCustomException

Cuando uses un SDK de terceros para realizar llamadas a la API con un objeto de solicitud que sea una subclase de CreateCustomCredentialRequest o GetCustomCredentialOption, es posible que encuentres errores. Si esto ocurre, verifica el SDK en busca de constantes de tipo de excepción personalizadas que coincidan con e.type. Si no se encuentra ninguna coincidencia, es seguro descartar o registrar la excepción.

CreateCredentialInterruptedException o GetCredentialInterruptedException

Es posible que la operación se haya interrumpido porque el usuario navegó a la configuración para reconfigurar los administradores de contraseñas. Es posible que otros motivos también hayan contribuido a la interrupción. Vuelve a intentarlo.

CreateCredentialUnknownException

Al guardar la contraseña, se encontró una respuesta de error de contraseña de One Tap 16: [28431] Se omite el guardado de contraseña, ya que es probable que se solicite al usuario Autocompletar de Android.

Este error solo afecta a Android 13 y versiones anteriores cuando Google es el proveedor de Autocompletar designado. En esos casos, los usuarios recibirán una solicitud de guardado de Autocompletar, y la contraseña se almacenará en el Administrador de contraseñas de Google. Es importante destacar que las credenciales guardadas con Autocompletar con Google se sincronizan de forma bidireccional con la API de Credential Manager. Por lo tanto, este error se puede ignorar con seguridad.

CreatePublicKeyCredentialDomException y GetPublicKeyCredentialDomException

Es probable que la excepción de DOM contenga un domError más específico. Puedes asignarlo a un DomException de WebAuthn para obtener más detalles.

CreatePublicKeyCredentialDomException y GetPublicKeyCredentialDomException

No se puede validar la solicitud entrante.

El servidor del administrador de contraseñas no reconoce el ID de paquete de la app. Esto indica un posible problema con la integración del servidor, específicamente la configuración del vínculo de recursos digitales. Vuelve a verificar la exactitud del ID del paquete y el SHA en tu archivo de vínculo del activo.

CreatePublicKeyCredentialDomException:

No se pudo crear la clave durante el registro

Este problema puede surgir cuando un usuario descarta el diálogo de bloqueo de pantalla durante el registro.

CreatePublicKeyDomException y GetPublicKeyCredentialDomException

El usuario canceló el registro de la llave de acceso.

El usuario canceló la recuperación de la llave de acceso.

Este problema puede surgir cuando un usuario descarta el diálogo de la huella dactilar durante el registro o la recuperación de una llave de acceso.

GetCredentialProviderConfigurationException y CreateCredentialProviderConfigurationException

getCredentialAsync no se encontraron dependencias de proveedores

createCredentialAsync no se encontraron dependencias de proveedores

Falta la dependencia androidx.credentials:credentials-play-services-auth:<latest-version>.

GetCredentialUnsupportedException o CreateCredentialUnsupportedException

Tu dispositivo no es compatible con el Administrador de credenciales

Asegúrate de que tu biblioteca de credenciales esté actualizada a la versión 1.2.1 o posterior.

GetPublicKeyCredentialException

No se pudo desencriptar la credencial

Este problema ocurre cuando se intenta usar una llave de acceso después de salir y volver a acceder a las Cuentas de Google. Pídele al usuario que vuelva a acceder a su Cuenta de Google en su dispositivo.

NoCredentialException

No se encontraron credenciales coincidentes

No se encontraron credenciales coincidentes en el dispositivo. Esto se espera si el usuario no guardó credenciales anteriormente.

No se puede crear una llave de acceso debido a que los datos encriptados están bloqueados

El usuario debe restablecer los datos del servidor de Chrome. Estos datos incluyen los favoritos y la configuración de Chrome, además de las contraseñas y llaves de acceso guardadas. Para obtener más información sobre los datos que se almacenan en Chrome, consulta Datos de Chrome de tu cuenta.

  1. Ve a chrome.google.com/sync.
  2. En la parte inferior, selecciona Borrar datos.
  3. En el dispositivo, activa la sincronización en Chrome.

On Begin Sign In Failure: 8: Error interno desconocido.

Es posible que el dispositivo no esté configurado correctamente con la Cuenta de Google. Es posible que haya un problema con la forma en que se crea el JSON de la llave de acceso. Vuelve a verificar la implementación para comprobar su exactitud.

No se puede obtener la cuenta de sincronización

La versión 24.40.XX y posteriores de los Servicios de Google Play proporcionarán códigos de error más informativos. Por ejemplo, en lugar de “No se pudo obtener la cuenta de sincronización”, los emisores ahora recibirán un mensaje de error de cancelación.