עדכונים ב-FedCM ב-Chrome 143

תאריך פרסום: 12 בינואר 2026

בגרסה 143 של Chrome יש עדכונים ל-Federated Credential Management (FedCM) API כדי לשפר את הפרטיות, את חוויית הפיתוח ואת יכולת הפעולה ההדדית של הדפדפן. השינויים האלה מבוססים על משוב מספקי זהויות (IdP), מגורמים מסתמכים (RP) ומקהילת האינטרנט.

העדכונים העיקריים הם:

תמיכה בתגובות JSON מובנות מנקודת הקצה לאימות הזהות

בעבר, נקודת הקצה לאימות הזהות של FedCM דרשה שהמאפיין token בתגובה שלה יהיה מחרוזת. כתוצאה מכך, המפתחים נאלצו להמיר באופן ידני את הנתונים למחרוזת JSON בשרת ולנתח אותם בצד הלקוח.

החל מגרסה 143 של Chrome, נקודת הקצה לאימות הזהות תומכת באובייקט JSON מובנה כערך של המאפיין token, לדוגמה:

{
  "token": {
    "access_token": "a1b2c3d4e5f6...",
    "user_info": {
      "email": "jane.doe@company.example",
      "given_name": "Jane",
      "family_name": "Doe"
    }
  }
}

השינוי הזה מייתר את הצורך בסריאליזציה ובניתוח ידני של JSON, ומאפשר לספקי הזהויות להחזיר מידע נוסף.

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

אימות המטא-נתונים של הלקוח

כדי להגן טוב יותר על פרטיות המשתמשים, ממשק FedCM מחזק את האימות של נקודות הקצה של ספק הזהויות. השינוי הזה מונע מספק הזהויות להתאים בין אתר RP למזהה ייחודי שמועבר כפרמטר של הנתיב.

אם ההגדרה של FedCM משתמשת בנקודת הקצה client_metadata, צריך לכלול את accounts_endpoint ו-login_url בקובץ .well-known/web-identity. החל מגרסה 145 של Chrome, הדפדפן אוכף את הפרמטר accounts_endpoint בקובץ well-known.

{
  "accounts_endpoint": "/example-accounts",
  "login_url": "/example-login"
}

פרטים נוספים זמינים במדריך להטמעת FedCM.

עדכונים לגבי עקביות ה-API והטיפול בשגיאות

בגרסה 143 של Chrome יש שני שינויים שנועדו לשפר את הבהירות והעקביות של FedCM API בדפדפנים שונים, בהתאם למשוב מהסביבה העסקית באינטרנט.

העברת הפרמטר nonce

החל מגרסה 145, ב-Chrome לא תהיה יותר תמיכה בפרמטר nonce ברמה העליונה. צריך להעביר את הפרמטר nonce בתוך האובייקט params בקריאה ל-navigator.credentials.get():

const credential = await navigator.credentials.get({
  identity: {
    providers: [{
      // Don't pass nonce as a top-level parameter here
      configURL: "/fedcm.json",
      clientId: "123",
      params: {
     // Place nonce within the params object    
        nonce: "a-random-nonce"
      }
    }]
  }
});

ודאו שהלוגיקה בצד השרת מצפה ל-nonce בתוך האובייקט params בנקודת הקצה של טענת הנכוֹנוּת (assertion) של המזהה.

שינוי השם של IdentityCredentialError.code לשם IdentityCredentialError.error

כדי למנוע התנגשויות בין שמות עם המאפיין המובנה DOMException.code, השם של IdentityCredentialError.code השתנה ל-IdentityCredentialError.error. השינוי הזה ייאכף החל מגרסה 145 של Chrome.

try {
  // FedCM API call
} catch (e) {
   // Renamed IdentityCredentialError.code to IdentityCredentialError.error:    
   console.log(e.error);
}

כדי להבטיח תאימות לדורות קודמים במהלך תקופת המעבר (Chrome 143 ו-144), צריך לבדוק את המאפיינים code ו-error בלוגיקה של הטיפול בשגיאות. כך הפתרון שלכם יפעל בדפדפנים ישנים יותר בזמן שהמשתמשים מעדכנים לגרסאות חדשות יותר של Chrome:

 // In older browsers, the property might still be named 'code'
 // during the transition period
  const errorCode = e.error ?? e.code;
  if (errorCode) {
    // Handle specific error types
  } else {
    console.error("An unknown error occurred", e);
  }

מידע נוסף זמין בקטע החזרת תגובת שגיאה במסמכי התיעוד של FedCM.

שיתוף משוב

המשוב שלכם חשוב לנו, ואנחנו ניעזר בו כדי להמשיך ולשפר את FedCM. אם יש לכם משוב או שנתקלתם בבעיות:

מידע נוסף