تحديد وحلّ الأخطاء الشائعة في "مدير بيانات الاعتماد"

يسرد هذا الدليل رموز الأخطاء والأوصاف الشائعة المرتبطة بـ Credential Manager، ويقدّم بعض المعلومات عن أسبابها.

رمز الخطأ ووصفه السبب

android.os.TransactionToolargeException

ويرجع ذلك إلى مشكلة معروفة، حيث يتعذّر على واجهة برمجة التطبيقات credentialManager.getCredential() على الإصدار 14 من نظام التشغيل Android والإصدارات الأحدث عرض مربّع حوار تسجيل الدخول عند توفُّر حسابات Google متعددة على الجهاز. تظهر هذه المشكلة تحديدًا في GetGoogleIdOption وليس GetSignInWithGoogleOption. تم إصلاح هذه المشكلة في الإصدار 24.40.XX من "خدمات Google Play" والإصدارات الأحدث.

CreateCredentialCancelException أو GetCredentialCancelException

مفتاح المرور تم إلغاء تسجيله أو استرجاعه من قِبل المستخدم.

اختار المستخدم عدم إنشاء بيانات اعتماد أو استخدامها. يمكنك الآن تعديل واجهة المستخدم لتقديم طريقة تسجيل دخول بديلة أو الانتقال إلى الخطوات التالية في العملية.

CreateCredentialCustomException أو GetCredentialCustomException

قد تظهر أخطاء عند استخدام حزمة تطوير برامج (SDK) تابعة لجهة خارجية لإجراء طلبات البيانات من واجهة برمجة التطبيقات باستخدام عنصر طلب يندرج ضمن الفئات الفرعية CreateCustomCredentialRequest أو GetCustomCredentialOption. في حال حدوث ذلك، تحقَّق من حزمة تطوير البرامج (SDK) بحثًا عن ثوابت لأنواع الاستثناء المخصّصة التي تتطابق مع e.type. في حال عدم العثور على أي مطابقة، من الآمن إسقاط الاستثناء أو تسجيله.

CreateCredentialInterruptedException أو GetCredentialInterruptedException

قد يكون قد تم إيقاف العملية لأنّ المستخدم انتقل إلى الإعدادات لإعادة ضبط خدمة إدارة كلمات المرور. وقد يكون هناك أسباب أخرى أيضًا أدّت إلى انقطاع الخدمة. يُرجى إعادة إجراء المكالمة.

CreateCredentialUnknownException

أثناء حفظ كلمة المرور، تم العثور على استجابة تشير إلى تعذُّر حفظ كلمة المرور من خلال نقرة واحدة 16: [28431] يتم تخطّي حفظ كلمة المرور لأنّه من المرجّح أن يُطلَب من المستخدم استخدام ميزة "الملء التلقائي" في Android.

لا يؤثر هذا الخطأ إلا في الإصدار 13 من نظام التشغيل Android والإصدارات الأقدم عندما يكون Google هو مقدّم خدمة الملء التلقائي المحدّد. في هذه الحالات، سيتلقّى المستخدمون إشعارًا بحفظ كلمة المرور من ميزة "الملء التلقائي"، وسيتم تخزين كلمة المرور في "مدير كلمات المرور في Google". من المهم الإشارة إلى أنّ بيانات الاعتماد المحفوظة باستخدام ميزة "الملء التلقائي من Google" تتم مزامنتها بشكل ثنائي الاتجاه مع واجهة برمجة التطبيقات Credential Manager API. وبالتالي، يمكن تجاهل هذا الخطأ بأمان.

CreatePublicKeyCredentialDomException & GetPublicKeyCredentialDomException

من المرجّح أن يحتوي استثناء DOM على domError أكثر تحديدًا. يمكنك ربطه بشهادة WebAuthn DomException للحصول على مزيد من التفاصيل.

CreatePublicKeyCredentialDomException و GetPublicKeyCredentialDomException

لا يمكن التحقّق من صحة الطلب الوارد.

لا يتعرّف خادم خدمة إدارة كلمات المرور على معرّف حزمة التطبيق. يشير ذلك إلى مشكلة محتملة في عملية الدمج من جهة الخادم، وتحديدًا إعداد رابط مادة العرض الرقمية. تحقّق جيدًا من دقة رقم تعريف الحزمة و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 لمفتاح المرور. يُرجى التحقّق من دقة التنفيذ.

تعذّر الحصول على حساب المزامنة

سيوفّر الإصدار 24.40.XX من "خدمات Google Play" والإصدارات الأحدث رموز خطأ أكثر معلومات. على سبيل المثال، بدلاً من "تعذّر الحصول على حساب المزامنة"، سيتلقّى المتصلون الآن رسالة خطأ لإلغاء الاشتراك.