認証情報マネージャーの一般的なエラーのトラブルシューティング

このガイドでは、認証情報マネージャーに関連する一般的なエラーコードと説明、およびその原因について説明します。

エラーコードと説明 原因

android.os.TransactionTooLargeException

これは、Android 14 以降の credentialManager.getCredential() API で、デバイスに複数の Google アカウントが存在する場合にログイン ダイアログが表示されないという既知の問題が原因で発生します。この問題は、GetSignInWithGoogleOption ではなく GetGoogleIdOption で発生します。この問題は、Google Play 開発者サービス バージョン 24.40.XX 以降で修正されています。

CreateCredentialCancellationException または GetCredentialCancellationException

パスキーの登録または取得がユーザーによってキャンセルされました。

ユーザーが認証情報を作成または使用しないことを選択している。UI を調整して別のログイン方法を提供するか、プロセスの次のステップに進むことができます。

CreateCredentialCustomException または GetCredentialCustomException

サードパーティの SDK を使用して、CreateCustomCredentialRequest または GetCustomCredentialOption のサブクラスであるリクエスト オブジェクトで API 呼び出しを行うと、エラーが発生することがあります。この場合は、e.type に一致するカスタム例外型定数を SDK で確認します。一致するものが見つからない場合は、安全に例外を削除するか、ログに記録できます。

CreateCredentialInterruptedException または GetCredentialInterruptedException

ユーザーが設定に移動してパスワード マネージャーを再構成したため、オペレーションが中断された可能性があります。中断の原因は他にもある可能性があります。もう一度お試しください。

CreateCredentialUnknownException

パスワードの保存中に、ワンタップでパスワード エラーの応答が表示されます。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 で同期をオンにします。

開始時のログインエラー: 8: 不明な内部エラーです。

デバイスが Google アカウントで適切にセットアップされていない可能性があります。 パスキー JSON の作成方法に問題がある可能性があります。実装の正確性を再確認してください。

同期アカウントを取得できない

Google Play 開発者サービス バージョン 24.40.XX 以降では、より詳細なエラーコードが提供されます。たとえば、呼び出し元には「同期アカウントを取得できませんでした」ではなく、キャンセル エラー メッセージが表示されます。