Häufige Fehler des Anmeldedaten-Managers beheben

In diesem Leitfaden werden häufige Fehlercodes und Beschreibungen im Zusammenhang mit dem Credential Manager aufgeführt und einige Informationen zu ihren Ursachen bereitgestellt.

Fehlercode und Beschreibung Ursache

android.os.TransactionTooLargeException

Das liegt an einem bekannten Problem: Die credentialManager.getCredential() API unter Android 14 und höher kann das Anmeldedialogfeld nicht anzeigen, wenn auf dem Gerät mehrere Google-Konten vorhanden sind. Dieses Problem tritt speziell bei GetGoogleIdOption und nicht bei GetSignInWithGoogleOption auf. Dieses Problem wurde in Google Play-Dienste-Version 24.40.XX und höher behoben.

CreateCredentialCancellationException

Die Passkey-Registrierung oder der Passkey-Abruf wurde vom Nutzer abgebrochen.

Der Nutzer hat sich entschieden, keine Anmeldedaten zu erstellen oder zu verwenden. Sie können die Benutzeroberfläche jetzt anpassen, um eine alternative Anmeldemethode anzubieten, oder mit den nächsten Schritten in Ihrem Prozess fortfahren.

GetCredentialCancellationException

Der Vorgang zum Abrufen der Anmeldedaten wurde beendet, weil die erforderliche Nutzerautorisierung nicht eingeholt wurde. Dies tritt am häufigsten auf, wenn ein Nutzer den Anmeldevorgang manuell abbricht. Es kann aber auch darauf hinweisen, dass die Anfrage aufgrund technischer Einschränkungen nicht autorisiert wurde. Da dieser Fehler auf eine fehlende Einwilligung hinweist, sollten Sie die Anfrage nicht automatisch noch einmal senden, da dies die Nutzerfreundlichkeit beeinträchtigt. Entwickler sollten jedoch die Häufigkeit dieser Ausnahme im Blick behalten. Ein hohes Volumen an „Abbrüchen“ kann tatsächlich auf eine Fehlkonfiguration hinweisen, z. B. einen fehlenden oder falschen Bereich, der verhindert, dass die Autorisierungs-UI erfolgreich abgeschlossen wird. Wenn Sie unerwartete Trends feststellen, überprüfen Sie die Parameter Ihrer Anfrage und die Konfiguration der [vertrauenden Partei][2].

Hinweis: Die Fehlermeldung kann je nach Art der Anmeldedaten variieren:

  • Bei Passkeys kann die Fehlermeldung „Die Registrierung oder der Abruf des Passkeys wurde vom Nutzer abgebrochen“ lauten.
  • Bei „Mit Google anmelden“ kann die Fehlermeldung „Aktivität wurde vom Nutzer abgebrochen“ lauten.

CreateCredentialCustomException oder GetCredentialCustomException

Wenn Sie ein Drittanbieter-SDK verwenden, um API-Aufrufe mit einem Anfrageobjekt auszuführen, das von CreateCustomCredentialRequest oder GetCustomCredentialOption abgeleitet wird, können Fehler auftreten. Prüfen Sie in diesem Fall, ob das SDK Konstanten für benutzerdefinierte Ausnahmetypen enthält, die mit „e.type“ übereinstimmen. Wenn keine Übereinstimmung gefunden wird, kann die Ausnahme entweder ignoriert oder protokolliert werden.

CreateCredentialInterruptedException oder GetCredentialInterruptedException

Der Vorgang wurde möglicherweise unterbrochen, weil der Nutzer die Einstellungen aufgerufen hat, um Passwortmanager neu zu konfigurieren. Möglicherweise haben auch andere Gründe zur Unterbrechung beigetragen. Bitte versuchen Sie es noch einmal.

CreateCredentialUnknownException

Beim Speichern des Passworts wurde eine Fehlerantwort für das Passwort von One Tap 16 gefunden: [28431] Das Speichern des Passworts wird übersprungen, da der Nutzer wahrscheinlich von Android Autofill aufgefordert wird.

Dieser Fehler tritt nur bei Android 13 und früheren Versionen auf, wenn Google der festgelegte Autofill-Anbieter ist. In solchen Fällen erhalten Nutzer eine Aufforderung von Autofill, das Passwort zu speichern, und das Passwort wird im Google Passwortmanager gespeichert. Wichtig: Anmeldedaten, die mit Autofill mit Google gespeichert werden, werden bidirektional mit der Credential Manager API synchronisiert. Daher kann dieser Fehler ignoriert werden.

CreatePublicKeyCredentialDomException und GetPublicKeyCredentialDomException

Wahrscheinlich enthält die DOM-Ausnahme einen spezifischeren domError. Weitere Informationen finden Sie unter DomException.

CreatePublicKeyCredentialDomException und GetPublicKeyCredentialDomException

Die eingehende Anfrage kann nicht validiert werden.

Der Server des Passwortmanagers erkennt die Paket-ID der App nicht. Dies deutet auf ein potenzielles Problem mit Ihrer serverseitigen Integration hin, insbesondere mit der Einrichtung von Links zu digitalen Assets. Prüfen Sie noch einmal, ob die Paket-ID und der SHA in Ihrer Asset-Link-Datei korrekt sind.

CreatePublicKeyCredentialDomException:

Schlüssel kann während der Registrierung nicht erstellt werden

Dieses Problem kann auftreten, wenn ein Nutzer das Dialogfeld für die Displaysperre während der Registrierung schließt.

CreateCredentialNoCreateOptionException

Diese spezielle Ausnahme gibt an, dass für den Nutzer kein gültiger Passwortmanager konfiguriert ist. Dieser Fehler wird nicht durch einen vom Nutzer initiierten manuellen Kündigungsvorgang verursacht, sondern ist ein separater Fehler.

CreatePublicKeyDomException und GetPublicKeyCredentialDomException

Die Registrierung des Passkeys wurde vom Nutzer abgebrochen.

Der Abruf des Passkeys wurde vom Nutzer abgebrochen.

Dieses Problem kann auftreten, wenn ein Nutzer das Dialogfeld für den Fingerabdruck während der Registrierung oder des Abrufs eines Passkeys schließt.

GetCredentialProviderConfigurationException & CreateCredentialProviderConfigurationException

getCredentialAsync: Keine Anbieterabhängigkeiten gefunden

createCredentialAsync: Keine Anbieterabhängigkeiten gefunden

Die androidx.credentials:credentials-play-services-auth:<latest-version>-Abhängigkeit fehlt.

GetCredentialUnsupportedException oder CreateCredentialUnsupportedException

Ihr Gerät unterstützt den Credential Manager nicht

Prüfen Sie, ob Ihre Anmeldedatenbibliothek auf Version 1.2.1 oder höher aktualisiert wurde.

GetPublicKeyCredentialException

Anmeldedaten konnten nicht entschlüsselt werden

Dieses Problem tritt auf, wenn Sie versuchen, einen Passkey zu verwenden, nachdem Sie sich von Google-Konten ab- und wieder angemeldet haben. Bitten Sie den Nutzer, sich auf seinem Gerät wieder in seinem Google-Konto anzumelden.

NoCreateOptionException

Diese Ausnahme ist das erwartete Verhalten, wenn ein Nutzer auf seinem Gerät keine Passkey-Anmeldedaten eingerichtet hat oder kein Passwortmanager konfiguriert ist.

NoCredentialException

Keine übereinstimmenden Anmeldedaten gefunden

Diese Ausnahme wird in den folgenden Situationen ausgelöst:

  • setFilterByAuthorizedAccounts ist auf „true“ festgelegt, ohne dass autorisierte Konten auf dem Gerät vorhanden sind.
  • Auf dem Gerät sind keine Konten angemeldet (es wurden keine Konten hinzugefügt oder die Konten müssen neu authentifiziert werden).
  • Die Bottomsheet-Benutzeroberfläche wird nicht angezeigt, wenn Anmeldeaufforderungen für ein Konto auf dem Gerät deaktiviert sind. Diese globale Einstellung, die sich unter Google-Kontoeinstellungen > Mit Google anmelden befindet, muss für jedes Konto aktiviert sein, damit die Bottomsheet-Benutzeroberfläche angezeigt wird. Das hat keine Auswirkungen auf den Schaltflächenablauf.

Es kann kein Passkey erstellt werden, da verschlüsselte Daten gesperrt sind

Der Nutzer muss seine serverseitigen Chrome-Daten zurücksetzen. Zu diesen Daten gehören neben den gespeicherten Passwörtern und Passkeys auch Lesezeichen und Chrome-Einstellungen. Weitere Informationen dazu, welche Daten von Chrome gespeichert werden, finden Sie unter Chrome-Daten in Ihrem Konto.

  1. Rufen Sie chrome.google.com/sync auf.
  2. Wählen Sie unten Daten löschen aus.
  3. Aktivieren Sie auf dem Gerät die Synchronisierung in Chrome.

Bei „Begin Sign In Failure“: 8: Unbekannter interner Fehler.

Das Gerät ist möglicherweise nicht richtig mit dem Google-Konto eingerichtet. Möglicherweise liegt ein Problem mit der Erstellung des Passkey-JSON vor. Prüfen Sie die Implementierung sorgfältig.

Synchronisierungskonto kann nicht abgerufen werden

In den Google Play-Diensten-Versionen 24.40.XX und höher werden informativere Fehlercodes bereitgestellt. Anstelle von „Synchronisierungskonto kann nicht abgerufen werden“ erhalten Anrufer jetzt beispielsweise eine Fehlermeldung zur Kündigung.