به‌روزرسانی‌های FedCM در Chrome 143

تاریخ انتشار: ۱۲ ژانویه ۲۰۲۶

Chrome 143 به‌روزرسانی‌هایی را برای Federated Credential Management (FedCM) API معرفی می‌کند تا حریم خصوصی، تجربه توسعه‌دهنده، و هم‌کنش‌پذیری مرورگر را بهبود بخشد. این تغییرات براساس بازخورد ارائه‌دهندگان هویت (IdP)، طرف‌های متکی (RP)، و انجمن وب است.

به‌روزرسانی‌های کلیدی عبارت‌اند از:

پشتیبانی از پاسخ‌های JSON ساختاریافته از نقطه پایانی ادعای شناسه

قبلاً، پایانه ادعای شناسه FedCM نیاز داشت که ویژگی token در پاسخ آن یک رشته باشد. این امر توسعه‌دهندگان را مجبور می‌کرد تا داده‌ها را به‌صورت دستی در رشته JSON در سرور سریال‌سازی کنند و آن را در کلاینت تجزیه کنند.

از Chrome نسخه ۱۴۳ به بعد، نقطه پایانی ادعای شناسه از شیء JSON ساختاریافته به‌عنوان مقدار برای ویژگی token پشتیبانی می‌کند، برای مثال:

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

این تغییر نیاز به تجزیه و سریال‌سازی دستی JSON را برطرف می‌کند و به ارائه‌دهندگان هویت اجازه می‌دهد اطلاعات بیشتری را برگردانند.

این ویژگی را با نمونه نمایشی FedCM امتحان کنید یا برای دریافت اطلاعات به‌روز درباره نحوه ساختاردهی پاسخ نقطه پایانی ادعای شناسه به‌روزشده، به راهنمای پیاده‌سازی FedCM در سمت ارائه‌دهنده هویت مراجعه کنید.

اعتبارسنجی فراداده مشتری

برای محافظت بهتر از حریم خصوصی کاربر، FedCM درستی‌سنجی را برای نقاط پایانی IdP تقویت می‌کند. این تغییر مانع مطابقت دادن RP با شناسه یکتای ارسال‌شده به‌عنوان پارامتر مسیر توسط IdP می‌شود.

اگر پیکربندی FedCM شما از نقطه پایان client_metadata استفاده می‌کند، باید accounts_endpoint و login_url را در فایل .well-known/web-identity خود اضافه کنید. از Chrome 145، مرورگر پارامتر accounts_endpoint را در فایل شناخته‌شده اعمال می‌کند.

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

برای جزئیات بیشتر، راهنمای پیاده‌سازی FedCM را ببینید.

به‌روزرسانی‌های سازگاری میانای برنامه‌سازی کاربردی و رسیدگی به خطا

Chrome 143 دو تغییر را برای بهبود وضوح و سازگاری FedCM API در مرورگرها معرفی می‌کند که با بازخورد بوم‌سازگان وب همسو است.

پارامتر nonce را جابه‌جا کنید

از نسخه ۱۴۵، 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 در نقطه پایانی ادعای شناسه دارد.

تغییر نام IdentityCredentialError.code به IdentityCredentialError.error

برای جلوگیری از تداخل نام با خصوصیت داخلی DOMException.code، نام IdentityCredentialError.code به IdentityCredentialError.error تغییر کرده است. این تغییر از 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 ادامه می‌دهیم، برای نظرات شما ارزش قائل هستیم. اگر بازخوردی دارید یا با مشکلی مواجه شدید:

بیشتر بدانید