Обновления FedCM в Chrome 143

Дата публикации: 12 января 2026 г.

В Chrome 143 обновлен Federated Credential Management (FedCM) API, чтобы повысить конфиденциальность, улучшить возможности для разработчиков и совместимость браузеров. Эти изменения основаны на отзывах поставщиков идентификационной информации, доверяющих сторон и веб-сообщества.

Вот основные изменения:

Поддержка структурированных ответов JSON от конечной точки подтверждения идентификационных данных

Ранее конечная точка подтверждения идентификационных данных FedCM требовала, чтобы свойство token в ее ответе было строкой. Это заставляло разработчиков вручную сериализовать данные в строку JSON на сервере и анализировать ее на клиенте.

Начиная с Chrome 143 конечная точка подтверждения идентификационных данных поддерживает структурированный объект JSON в качестве значения свойства token, например:

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

Это изменение устраняет необходимость в сериализации и синтаксическом анализе JSON вручную и позволяет поставщикам идентификационной информации возвращать дополнительные сведения.

Попробуйте эту функцию в демоверсии FedCM или ознакомьтесь с руководством Реализация FedCM на стороне поставщика идентификационной информации, чтобы узнать, как структурирован ответ обновленной конечной точки подтверждения идентификационных данных.

Проверка метаданных клиента

Чтобы лучше защищать конфиденциальность пользователей, в FedCM API усиливается проверка конечных точек поставщиков идентификационной информации. Это изменение не позволяет поставщику идентификационной информации сопоставлять полагающуюся сторону с уникальным идентификатором, переданным в качестве параметра пути.

Если в вашей конфигурации FedCM используется конечная точка client_metadata, то в файл .well-known/web-identity необходимо добавить accounts_endpoint и login_url. Начиная с Chrome 145 браузер применяет параметр accounts_endpoint в общеизвестном файле.

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

Подробную информацию вы найдете в руководстве по внедрению FedCM API.

Обновления, связанные с согласованностью API и обработкой ошибок

В Chrome 143 внесены два изменения, которые улучшают понятность и согласованность 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 в конечной точке подтверждения идентификационных данных.

Переименовать IdentityCredentialError.code в IdentityCredentialError.error

Чтобы избежать конфликта названий со встроенным свойством DOMException.code, свойство IdentityCredentialError.code было переименовано в IdentityCredentialError.error. Это изменение вступит в силу в Chrome 145.

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. Если у вас есть отзывы или вы столкнулись с проблемами:

Подробнее…