Admin Authentication API Errors

בהמשך מופיעה רשימה מלאה של קודי השגיאה והתיאורים, כולל שלבים מומלצים לפתרון, שמוחזרים על ידי Firebase Admin Node.js Authentication API:

קוד שגיאה תיאור ושלבים לפתרון
auth/claims-too-large מטען הייעודי (payload) של התביעות שסופק ל-setCustomUserClaims() חורג מהגודל המקסימלי המותר של 1,000 בייט.
auth/email-already-exists כתובת האימייל שסיפקת כבר נמצאת בשימוש אצל משתמש אחר. לכל משתמש צריכה להיות כתובת אימייל ייחודית.
auth/id-token-expired פג התוקף של טוקן מזהה Firebase שסופק.
auth/id-token-revoked טוקן המזהה של Firebase בוטל.
auth/insufficient-permission לפרטי הכניסה שמשמשים לאתחול Admin SDK אין מספיק הרשאות לגישה למשאב Authentication המבוקש. במאמר הגדרת פרויקט Firebase מוסבר איך ליצור פרטי כניסה עם ההרשאות המתאימות ואיך להשתמש בהם כדי לאמת את ערכות ה-SDK של Admin.
auth/internal-error השרת Authentication נתקל בשגיאה לא צפויה במהלך הניסיון לעבד את הבקשה. הודעת השגיאה צריכה לכלול את התגובה משרת Authentication שמכילה מידע נוסף. אם השגיאה נמשכת, אפשר לדווח על הבעיה בערוץ התמיכה שלנו בנושא דיווח על באגים.
auth/invalid-argument סופק ארגומנט לא תקין לשיטה Authentication. הודעת השגיאה צריכה לכלול מידע נוסף.
auth/invalid-claims המאפיינים של הטענה המותאמת אישית שסופקו ל-setCustomUserClaims() לא תקינים.
auth/invalid-continue-uri כתובת ה-URL להמשך חייבת להיות מחרוזת כתובת URL תקינה.
auth/invalid-creation-time השדה של זמן היצירה חייב להיות מחרוזת תאריך חוקית בפורמט UTC.
auth/invalid-credential אי אפשר להשתמש בפרטי הכניסה שמשמשים לאימות של Admin SDK כדי לבצע את הפעולה הרצויה. שיטות מסוימות של Authentication, כמו createCustomToken() ו-verifyIdToken(), מחייבות אתחול של ה-SDK עם פרטי כניסה של אישור, ולא עם אסימון רענון או Application Default Credentials. במאמר Initialize the SDK מוסבר איך לאמת את Admin SDKs באמצעות פרטי כניסה של אישור.
auth/invalid-disabled-field הערך שסופק למאפיין המשתמש disabled לא תקין. הוא חייב להיות בוליאני (boolean).
auth/invalid-display-name הערך שסופק למאפיין המשתמש displayName לא תקין. הוא חייב להיות מחרוזת לא ריקה.
auth/invalid-dynamic-link-domain הדומיין של הקישור הדינמי שצוין לא מוגדר או לא מורשה לפרויקט הנוכחי.
auth/invalid-email הערך שסופק למאפיין המשתמש email לא תקין. הוא חייב להכיל מחרוזת (string) של כתובת אימייל
auth/invalid-email-verified הערך שסופק למאפיין המשתמש emailVerified לא תקין. הוא חייב להיות בוליאני (boolean).
auth/invalid-hash-algorithm אלגוריתם הגיבוב חייב להתאים לאחת מהמחרוזות ברשימת האלגוריתמים הנתמכים.
auth/invalid-hash-block-size גודל הבלוק של הגיבוב חייב להיות מספר תקין.
auth/invalid-hash-derived-key-length אורך המפתח שנגזר מהגיבוב חייב להיות מספר תקין.
auth/invalid-hash-key מפתח הגיבוב (hash) חייב להיות מאגר בייטים תקין.
auth/invalid-hash-memory-cost עלות הזיכרון של הגיבוב חייבת להיות מספר תקין.
auth/invalid-hash-parallelization הערך של hash parallelization חייב להיות מספר תקין.
auth/invalid-hash-rounds מספר הסבבים של הגיבוב חייב להיות מספר תקין.
auth/invalid-hash-salt-separator השדה של מפריד המלח באלגוריתם הגיבוב חייב להיות מאגר בייטים תקין.
auth/invalid-id-token טוקן ה-ID שסופק הוא לא טוקן ID תקין של Firebase.
auth/invalid-last-sign-in-time הזמן של הכניסה האחרונה לחשבון חייב להיות מחרוזת תאריך תקינה בפורמט UTC.
auth/invalid-page-token טוקן הדף הבא שצוין ב-listUsers() לא תקין. הוא חייב להיות מחרוזת לא ריקה ותקינה.
auth/invalid-password הערך שסופק למאפיין המשתמש password לא תקין. הוא חייב להיות מחרוזת (string) שמכילה שישה תווים לפחות.
auth/invalid-password-hash הגיבוב של הסיסמה חייב להיות מאגר בייטים תקין.
auth/invalid-password-salt ה-salt של הסיסמה חייב להיות מאגר בייטים תקין
auth/invalid-phone-number הערך שצוין במאפיין phoneNumber לא תקין. הוא חייב להיות מחרוזת מזהה לא ריקה שתואמת לתקן E.164.
auth/invalid-photo-url הערך שסופק למאפיין המשתמש photoURL לא תקין. הוא חייב להכיל מחרוזת (string) של כתובת URL.
auth/invalid-provider-data הפרמטר providerData חייב להיות מערך תקין של אובייקטים מסוג UserInfo.
auth/invalid-provider-id הערך של providerId חייב להיות מחרוזת מזהה חוקית של ספק נתמך.
auth/invalid-oauth-responsetype רק אחד מפרטי הכניסה של OAuth responseType צריך להיות מוגדר כ-true.
auth/invalid-session-cookie-duration משך הזמן של קובץ ה-Cookie של הסשן צריך להיות מספר תקין במילישניות, בין 5 דקות לבין שבועיים.
auth/invalid-uid הערך שצוין uid חייב להיות מחרוזת לא ריקה באורך של עד 128 תווים.
auth/invalid-user-import רשומת המשתמש לייבוא לא תקינה.
auth/maximum-user-count-exceeded חלה חריגה ממספר המשתמשים המקסימלי שאפשר לייבא.
auth/missing-android-pkg-name אם נדרשת התקנה של אפליקציית Android, צריך לציין שם חבילה ב-Android.
auth/missing-continue-uri חובה לציין בבקשה כתובת URL תקינה להמשך.
auth/missing-hash-algorithm כשמייבאים משתמשים עם גיבוב סיסמאות, צריך לספק את אלגוריתם הגיבוב ואת הפרמטרים שלו.
auth/missing-ios-bundle-id בבקשה חסר מזהה חבילה.
auth/missing-uid נדרש מזהה uid לפעולה הנוכחית.
auth/missing-oauth-client-secret כדי להפעיל את תהליך קוד OIDC, צריך להזין את הסוד של לקוח ההגדרות של OAuth.
auth/operation-not-allowed ספק הכניסה שצוין מושבת בפרויקט Firebase. מפעילים אותו בקטע Sign-in Method (שיטת הכניסה) במסוף Firebase.
auth/phone-number-already-exists השם phoneNumber שסיפקת כבר נמצא בשימוש אצל משתמש אחר. לכל משתמש חייב להיות phoneNumber ייחודי.
auth/project-not-found לא נמצא פרויקט ב-Firebase עבור פרטי הכניסה ששימשו לאתחול של Admin SDKs. במאמר הגדרת פרויקט Firebase מוסבר איך ליצור אמצעי אימות לפרויקט ולהשתמש בו כדי לאמת את ערכות ה-SDK של Admin.
auth/reserved-claims אחת או יותר מהטענות המותאמות אישית לגבי המשתמש שסופקו ל-setCustomUserClaims() שמורות. לדוגמה, טענות ספציפיות ל-OIDC כמו (sub, iat, iss, exp, aud, auth_time וכו') לא צריכות לשמש כמפתחות לטענות מותאמות אישית.
auth/session-cookie-expired פג התוקף של קובץ ה-Cookie של הסשן ב-Firebase שסופק.
auth/session-cookie-revoked קובץ ה-cookie של הסשן ב-Firebase נפסל.
auth/too-many-requests מספר הבקשות חורג מהמספר המקסימלי המותר.
auth/uid-already-exists השם uid שסיפקת כבר נמצא בשימוש אצל משתמש אחר. לכל משתמש חייב להיות מזהה ייחודי uid.
auth/unauthorized-continue-uri הדומיין של כתובת ה-URL להמשך לא נמצא ברשימת ההיתרים. יוצרים רשימת היתרים לדומיין במסוף Firebase.
auth/user-not-found לא קיים רשומת משתמש שתואמת למזהה שסופק.