Дата публикации: 12 января 2026 г.
В Chrome 143 обновлен Federated Credential Management (FedCM) API, чтобы повысить конфиденциальность, улучшить возможности для разработчиков и совместимость браузеров. Эти изменения основаны на отзывах поставщиков идентификационной информации, доверяющих сторон и веб-сообщества.
Вот основные изменения:
- Поддержка структурированных ответов JSON
- Более строгая проверка метаданных клиента
- Улучшения согласованности 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. Если у вас есть отзывы или вы столкнулись с проблемами:
- Сообщите о проблеме в нашем хранилище GitHub.
- Чтобы получать последние новости, подпишитесь на рассылку для разработчиков.