פתרון בעיות של שגיאות נפוצות ב-Credential Manager

במדריך הזה מפורטים תיאורים וקודים של שגיאות נפוצות שקשורות ל-Credential Manager, ומידע על הסיבות שלהן.

קוד השגיאה והתיאור שלה הסיבה

android.os.TransactionToo התחסנות גדולה

הסיבה לכך היא בעיה ידועה שבה ממשק ה-API של credentialManager.getCredential() בגרסאות Android 14 ואילך לא מציג את תיבת הדו-שיח לכניסה לחשבון כשיש כמה חשבונות Google במכשיר. הבעיה הזו מתרחשת במיוחד עם GetGoogleIdOption ולא עם GetSignInWithGoogleOption. הבעיה הזו נפתרה בגרסה 24.40.XX ואילך של Google Play Services.

CreateCredentialCancelחריג או GetCredentialUndoיוצאים

המשתמש ביטל את הרישום או השליפה של מפתח הגישה.

המשתמש בחר לא ליצור פרטי כניסה או להשתמש בהם. עכשיו אפשר לשנות את ממשק המשתמש כך שתציע שיטת כניסה חלופית או לעבור לשלבים הבאים בתהליך.

CreateCredentialCustomException או GetCredentialCustomException

כשמשתמשים ב-SDK של צד שלישי כדי לבצע קריאות ל-API עם אובייקט בקשה שהוא תת-סוג של CreateCustomCredentialRequest או של GetCustomCredentialOption, יכול להיות שתוצגו שגיאות. במקרה כזה, צריך לבדוק ב-SDK אם יש קבועים מותאמים אישית של סוגי חריגות שתואמים ל-e.type. אם לא נמצאה התאמה, אפשר לשחרר את החריגה או לרשום אותה ביומן.

CreateCredentialInterrupted שמאל או GetCredentialInterrupted במסך

יכול להיות שהפעולה הופסקה כי המשתמש עבר להגדרות כדי להגדיר מחדש את מנהלי הסיסמאות. יכול להיות שגם סיבות אחרות תרמו להפרעה. יש לנסות שוב להתקשר.

CreateCredentialUnknownException

במהלך שמירת הסיסמה, נמצאה תגובה של כשל בסיסמה מקש אחד 16: [28431] דילוג על שמירת הסיסמה כי סביר להניח שהמשתמש יתבקש להשתמש במילוי האוטומטי של Android.

השגיאה הזו משפיעה רק על Android 13 וגרסאות קודמות, כש-Google היא ספקית המילוי האוטומטי. במקרים כאלה, המשתמשים יקבלו בקשה לשמירה מהמילוי האוטומטי, והסיסמה תישמר במנהל הסיסמאות של Google. חשוב לדעת שפרטי הכניסה שנשמרו באמצעות המילוי האוטומטי של Google מסתנכרנים באופן דו-כיווני עם Credential Manager API. לכן אפשר להתעלם מהשגיאה הזו.

CreatePublicKeyCredentialDomException ו-GetPublicKeyCredentialDomException

סביר להניח שהחרגת ה-DOM מכילה domError ספציפי יותר. כדי לקבל פרטים נוספים, אפשר למפות אותו אל WebAuthn DomException.

CreatePublicKeyCredentialDomError ו-GetPublicKeyCredentialDom מפרסמים

לא ניתן לאמת את הבקשה הנכנסת.

השרת של מנהל הסיסמאות לא מזהה את מזהה החבילה של האפליקציה. המשמעות היא שיש בעיה אפשרית בשילוב בצד השרת, ובפרט בהגדרת הקישור לנכס הדיגיטלי. בודקים שוב את הדיוק של מזהה החבילה ו-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 Services תספק קודי שגיאה אינפורמטיביים יותר. לדוגמה, במקום הודעת השגיאה 'לא ניתן לקבל את חשבון הסנכרון', מבצעי הקריאה יקבלו עכשיו הודעת שגיאה על ביטול.