Actualizaciones de FedCM en Chrome 143

Publicación: 12 de enero de 2026

Chrome 143 presenta actualizaciones de la API de Federated Credential Management (FedCM) para mejorar la privacidad, la experiencia de los desarrolladores y la interoperabilidad del navegador. Estos cambios se basan en los comentarios de los proveedores de identidad (IdP), las partes de confianza (RP) y la comunidad web.

Estas son las actualizaciones clave:

Admite respuestas JSON estructuradas desde el extremo de aserción de ID

Anteriormente, el extremo de aserción de ID de FedCM requería que la propiedad token de su respuesta fuera una cadena. Esto obligaba a los desarrolladores a serializar manualmente los datos en una cadena JSON en el servidor y analizarlos en el cliente.

A partir de Chrome 143, el extremo de aserción de ID admite un objeto JSON estructurado como el valor de la propiedad token, por ejemplo:

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

Este cambio elimina la necesidad de serializar y analizar JSON de forma manual, y permite que los IdP devuelvan información adicional.

Prueba esta función con la demostración de FedCM o consulta la guía Implementa FedCM del lado del proveedor de identidad para obtener información actualizada sobre cómo se estructura la respuesta actualizada del extremo de aserción de ID.

Valida los metadatos del cliente

Para proteger mejor la privacidad del usuario, FedCM está reforzando la validación de los extremos del IdP. Este cambio evita que un IdP haga coincidir un RP con un ID único que se pasa como parámetro de ruta.

Si tu configuración de FedCM usa el extremo client_metadata, debes incluir accounts_endpoint y login_url en tu archivo .well-known/web-identity. A partir de Chrome 145, el navegador aplica el parámetro accounts_endpoint en el archivo conocido.

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

Para obtener más detalles, consulta la guía de implementación de FedCM.

Actualizaciones de coherencia de la API y manejo de errores

Chrome 143 presenta dos cambios para mejorar la claridad y la coherencia de la API de FedCM en todos los navegadores, lo que se alinea con los comentarios del ecosistema web.

Reubica el parámetro nonce

A partir de la versión 145, Chrome descontinuará la compatibilidad con el parámetro nonce de nivel superior. Debes pasar el parámetro nonce dentro del objeto params en la llamada a 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"
      }
    }]
  }
});

Asegúrate de que la lógica del servidor espere el nonce dentro del objeto params en el extremo de aserción de ID.

Cambia el nombre de IdentityCredentialError.code a IdentityCredentialError.error

Para evitar conflictos de nombres con la propiedad integrada DOMException.code, se cambió el nombre de IdentityCredentialError.code a IdentityCredentialError.error. Este cambio se aplicará de manera forzosa a partir de Chrome 145.

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

Para garantizar la retrocompatibilidad durante el período de transición (Chrome 143 y 144), verifica las propiedades code y error en tu lógica de manejo de errores. Esto garantiza que tu solución funcione en navegadores más antiguos mientras los usuarios actualizan a versiones más recientes de 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);
  }

Obtén más información en la sección Devuelve una respuesta de error de la documentación de FedCM.

Comparte tus comentarios

Valoramos tus comentarios mientras seguimos desarrollando y mejorando FedCM. Si tienes comentarios o tienes algún problema, sigue estos pasos:

Más información